Errores y registro de llamadas
Qué pasa cuando la otra API falla, cómo te enterás y cómo hacer que la automation siga por otro camino en vez de cortarse.
Una llamada a otro sistema puede salir mal de dos maneras, y conviene distinguirlas porque se ven distinto:
| Qué pasó | Ejemplo | Cómo se ve |
|---|---|---|
| La API contestó, pero con error | Un path que no existe (404), una clave mal cargada (401), el servicio con problemas (500) | Hay status, y ok es falso. El nodo falla con Integration returned status 404 |
| No hubo respuesta | El servicio no contestó en 10 segundos, el dominio no existe, o la URL apunta a una red interna | No hay status. En el registro de llamadas figura FETCH_FAILED o SSRF_BLOCKED |
Por defecto, en los dos casos la automation se corta en ese nodo: lo que venía después no corre. La oportunidad, que ya estaba guardada, queda guardada; sólo le falta lo que la automation iba a completar.
Nxar no reintenta solo. Si la API se cayó cinco minutos, las oportunidades creadas en esos cinco minutos quedan sin cotización hasta que alguien la complete. Por eso vale la pena enterarse rápido, y para eso está lo que sigue.
Dónde mirar
Los logs de la automation. En el builder, el ícono de Logs de ejecución de la barra superior lista cada corrida con Fecha, Estado (success o failed), Nodos, Duración y Error. Hacé clic en una fila para ver el paso a paso: cada nodo con su resultado y, desplegando, las variables que quedaron después de ese paso. Ahí ves la respuesta completa de la integración.
El registro de llamadas de la integración. En la ficha de la integración, Llamadas recientes muestra cada llamada con Hora, Estado, Método, URL, Duración y Origen (Test, Automatización o Componente). Con Solo errores filtrás lo que falló. Sólo se registran las llamadas mientras Registrar cada llamada a esta integración está activo, y se guardan 30 días.
Encendé el registro en la integración del dólar
Abrí Cotización del dólar, Editar, marcá Registrar cada llamada a esta integración y Guardar. Volvé a la lista y abrila de nuevo para ver el cambio.
Provocá un error a propósito
En la automation Cotización en oportunidades nuevas, seleccioná Llamar Integración y cambiá Path (optional) a /inexistente. Guardar. Creá una oportunidad de prueba.
DolarApi contesta 404 a un path que no conoce. La oportunidad se guarda sin Dólar oficial.
Encontralo en los dos registros
En el builder, Logs de ejecución: la corrida más nueva está en failed, con el error Integration returned status 404. Abrila: el paso del nodo Llamar Integración figura con su tipo, call_integration, en rojo.
En la integración, Llamadas recientes → Refrescar: hay una fila 404 con origen Automatización, debajo de las 200 de antes.
Seguí por otro camino cuando falla
Seleccioná Llamar Integración y, abajo de todo en Configurar, marcá Fallback si esto falla. Guardar el motivo en puede quedar vacío: el motivo se guarda en error.
El nodo suma una salida en error. Arrastrá un Actualizar registro al canvas y unilo a esa salida. Configuralo con Registro del trigger y, en Campos a actualizar, Campo description y Valor No se pudo traer la cotización: {{error.reason}}. Guardar.
Creá otra oportunidad. Esta vez la corrida termina bien, y la Description de la oportunidad dice por qué no tiene cotización.
Dejala como estaba
Volvé a poner Path (optional) en /oficial y Guardar. Podés dejar el fallback: sólo se usa cuando algo falla.
Fallback o seguir de largo
El nodo tiene dos opciones parecidas, que cubren cosas distintas:
- Continue flow if the call fails: si la API contesta con error, la automation sigue por el camino normal, como si nada. Después podés mirar
{{dolar.ok}}o{{dolar.status}}en una Condición para decidir. No cubre el caso de “no hubo respuesta”: ese corta igual. - Fallback si esto falla: cualquier falla de la llamada, con o sin respuesta, va por la salida en error, y el motivo queda en
{{error.reason}}.
Ninguna de las dos ataja un rechazo por permisos (capítulo anterior).
Cómo saber que te salió
- Llamadas recientes de Cotización del dólar muestra llamadas 200 y una 404, y con Solo errores queda sólo la 404.
- Los Logs de ejecución muestran una corrida
failed(antes del fallback) y unasuccess(con el fallback) para dos oportunidades creadas con el path roto. - Con el path de vuelta en
/oficial, una oportunidad nueva vuelve a recibir su cotización.
¿Llegaste al resultado de arriba?