Integración · Operar tienda y pedidos
Chilexpress + agentes de IA de Meteor
Conecta la API de Chilexpress con un agente de IA de Meteor: cobertura por comuna sin credenciales, cotización y rastreo de envíos. 8 herramientas reales.
¿Cómo se conecta Chilexpress con Meteor?
Meteor se conecta con la transportadora chilena Chilexpress para que tu Met confirme si llega a una comuna, resuelva el código de esa comuna aunque el cliente lo escriba con tildes, cotice un envío con sus opciones de servicio y rastree una orden de transporte. Son 8 herramientas y ninguna escribe: crear la orden genera una etiqueta y un cobro reales, y quedó fuera a propósito. La cobertura funciona sin ninguna credencial, en pruebas y en producción, así que un Met puede contestar «¿llegan a Puerto Varas?» el primer día. Cotizar y rastrear sí piden cada uno su propia clave del portal de Chilexpress.
Dónde aplica: Chile. El código de comuna de Chilexpress es alfabético de cuatro letras y no es el código oficial del país: el conector lo resuelve a partir del nombre y obliga a desambiguar los homónimos.
Qué automatiza
Lo que un agente de Meteor hace con Chilexpress
Contestar «¿llegan a mi comuna?» antes de tener cuenta
La cobertura de Chilexpress es una interfaz abierta: responde sin credenciales, en pruebas y en producción. Tu Met resuelve el código de la comuna a partir del nombre que escribió el cliente y confirma si hay cobertura, aunque todavía no exista un contrato firmado.
Dar el valor del envío dentro de la conversación
Con el origen, el destino y las medidas del bulto, tu Met pide la cotización y devuelve las opciones de servicio con su precio y su peso final facturado. El peso volumétrico lo resuelve Chilexpress, nunca un cálculo del lado de Meteor.
Desambiguar la comuna en vez de adivinarla
El maestro de Chilexpress viene sin tildes y sin eñes, y hay comunas que se llaman igual en regiones distintas. Cuando aparece más de una coincidencia, el conector las devuelve todas y obliga a preguntar: nunca escoge por su cuenta.
Seguir una orden con el texto que da la transportadora
Tu Met rastrea por número de orden de transporte o por la referencia interna del pedido, y devuelve los eventos con fecha y hora. Como Chilexpress no publica códigos de estado estables, la respuesta se apoya en la descripción del último evento y no la reinterpreta.
8 herramientas
Todo lo que el agente puede pedirle a Chilexpress
Cada una es una acción real del conector. Puedes desactivar las que no quieras que use.
| Herramienta | Qué hace |
|---|---|
chilexpress_consultar_conexion | Reporta qué está configurado en este espacio de trabajo: ambiente, claves cargadas y comuna de origen. |
chilexpress_listar_regiones | Lista las dieciséis regiones de Chile con su código de Chilexpress. No necesita credenciales. |
chilexpress_buscar_comuna | Busca una comuna por nombre y devuelve su código de cuatro letras, encontrándola con tildes o sin ellas. |
chilexpress_consultar_cobertura | Dice si Chilexpress llega a una comuna y con qué modalidad. Responde sin credenciales. |
chilexpress_listar_comunas | Lista las comunas y localidades con cobertura de una región, para mostrarle opciones a quien no sabe el nombre exacto. |
chilexpress_cotizar_envio | Devuelve las opciones de servicio con su precio, su peso final facturado y sus condiciones. |
chilexpress_rastrear_envio | Rastrea una orden de transporte por su número o por la referencia con la que se creó, con sus eventos. |
chilexpress_validar_direccion | Parte una dirección chilena en calle, número y complemento, que es como Chilexpress los pide. |
Los límites
Qué NO hace la integración con Chilexpress
Preferimos decirlo aquí que descubrirlo en la implementación.
-
No genera órdenes de transporte ni etiquetas. La integración es de solo consulta: crear el envío produce una etiqueta y un cobro reales, es irreversible y queda para una fase posterior.
-
No devuelve tu tarifa negociada. Chilexpress advierte en su propio portal que la cotización no considera descuentos ni tarifas especiales, así que el valor es el de lista. Es lo contrario de lo que ocurre con TCC y con Andreani, donde el precio sale del acuerdo comercial.
-
No valida direcciones contra un catálogo oficial. Chilexpress no expone esa verificación: el conector solo separa calle, número y complemento, y avisa cuando no encontró número.
-
No normaliza el estado del envío. Chilexpress entrega los eventos como texto libre, sin códigos estables, así que no hay un estado comparable entre envíos ni entre transportadoras.
-
No habilita producción por su cuenta. Las claves de prueba salen solas del portal, pero las de producción exigen generar diez órdenes simuladas, enviar sus etiquetas a soporte y esperar la validación de una persona; además la cuenta arranca con un tope mensual de envíos.
-
No usa una sola credencial para todo. Cotizar y rastrear son dos productos distintos del portal con dos claves distintas, y cargar una en el campo de la otra devuelve un rechazo.
Antes de empezar
Qué necesitas para conectar Chilexpress
- 1
Nada, si solo vas a consultar cobertura
La interfaz de cobertura de Chilexpress es abierta y responde sin credenciales, tanto en pruebas como en producción. Es lo primero que puede contestar un Met, sin trámite previo.
- 2
Clave del producto Cotizador
En el portal de desarrolladores de Chilexpress, suscribiéndote al producto de cotización. La clave de pruebas sale sola; la de producción pasa por la certificación manual.
- 3
Clave del producto de envíos y el RUT de la empresa
Es la clave del producto de órdenes de transporte, que aquí solo se usa para rastrear, y es distinta de la del cotizador. El RUT se puede pegar con puntos y dígito verificador.
- 4
Comuna de origen y ambiente (opcionales)
La comuna desde la que despachas se configura una vez con su código de cuatro letras, para no repetirla en cada cotización. El ambiente arranca en pruebas.
Preguntas frecuentes
Preguntas sobre Chilexpress y Meteor
No necesariamente. Chilexpress declara en su portal que su cotización no considera descuentos ni tarifas especiales, así que lo que llega es la tarifa de lista. Si tienes un acuerdo comercial, tu precio real es más bajo y hay que decirlo en la conversación.
Todavía no. Esta integración consulta cobertura, cotiza y rastrea, pero no escribe en Chilexpress. Crear la orden de transporte genera una etiqueta y un cobro reales, es irreversible y no se pudo ejercitar contra la API, así que se dejó para una fase posterior.
Para la cobertura no. Esa interfaz responde sin credenciales, en pruebas y en producción, así que un Met puede confirmar si llegan a una comuna desde el primer día. Cotizar y rastrear sí piden una clave, y cada uno la suya.
Buscando por nombre en el maestro de Chilexpress, que viene sin tildes y sin eñes. El conector compara ignorando esas diferencias, así que encuentra la comuna aunque el cliente la escriba bien. Si hay varias coincidencias, las devuelve todas y obliga a desambiguar.
Porque Chilexpress entrega los eventos como texto y no publica códigos de estado estables. No hay un estado normalizado que comparar, así que la respuesta se apoya en la descripción del último evento tal como la escribió la transportadora.
Paso a paso
Automatizaciones que usan Chilexpress
Tareas completas, con los pasos y las herramientas que se ejecutan en cada uno.
Operar tienda y pedidos
Otras integraciones de la misma familia
¿Quieres ver a un agente operando Chilexpress?
Te lo mostramos con tu propia cuenta conectada, no con una demostración enlatada.