Capítulo 3 de 6 · 12 min

Probalo y mirá qué llegó

Llamás al endpoint desde Nxar y con curl, encontrás el Case creado y leés en Audit Logs el cuerpo exacto que llegó y lo que contestó Nxar.

Hay dos formas de probar un endpoint y conviene usar las dos: el botón Probar de Nxar, que corre el flujo sin pasar por la autenticación, y curl, que llama exactamente como lo va a hacer la tienda.

Abrí el endpoint

ConfiguraciónIntegraciones y APIEndpointsEndpoints y webhookstienda-reclamos

Hacé clic en la URL del endpoint. La vista tiene tres bloques: Cómo llamarlo, Configuración y Probar.

En Cómo llamarlo están la URL con su botón de copiar y ejemplos listos en pestañas: cURL, JavaScript, Python y Herramientas no-code. El token ya no se muestra completo: sólo dice con qué empieza, para que sepas cuál está activo.

Vista del endpoint tienda-reclamos con la URL, el aviso del prefijo del token y la pestaña cURL — Cómo llamarlo: la URL, qué token está activo y los ejemplos por plataforma.

Probalo desde Nxar

Bajá hasta Probar. En Cuerpo del request pegá:

{"subject":"Llegó una maceta rota","email":"cliente@ejemplo.com","order_id":"10045","message":"Vino partida al medio"}

y hacé clic en Ejecutar. Vas a ver el status (200), cuánto tardó y la respuesta, con el case_id adentro.

Bloque Probar con el cuerpo del request y la respuesta 200 con case_id — Probar corre el flujo de verdad: crea el Case. No verifica el token; eso se prueba con curl.

Llamalo con curl

Desde una terminal, con tu dirección y tu token en lugar de los de ejemplo:

curl -X POST "https://tu-workspace.nx-ar.com/public/v1/custom/tienda-reclamos" \
  -H "Content-Type: application/json" \
  -H "X-Webhook-Token: nxar_whk_REEMPLAZAR_POR_TU_TOKEN" \
  -d '{"subject":"El pedido no llegó","email":"cliente@ejemplo.com","order_id":"10046","message":"Pasaron diez días"}'

La respuesta, con status 200:

{"data":{"case_id":"6f1c2e9a-…"},"meta":{"nodesExecuted":2,"durationMs":84}}

El token también se acepta como Authorization: Bearer nxar_whk_…, por si la herramienta que usás sólo sabe mandar ese header. Nunca va en la URL.

Encontrá el Case

Abrí Cases en el workspace: están los dos reclamos, con el asunto, la descripción armada con el pedido y el mail, estado New y Julieta como dueña.

Mirá qué llegó

ConfiguraciónIntegraciones y APIEndpointsAudit Logs

En Requests recientes, en Endpoint, elegí tienda-reclamos. Cada llamada de curl es una fila con el método y el status (POST 200), la ruta, la etiqueta TOKEN, la duración y la hora. Al hacer clic en la fila se despliegan el Request (el cuerpo tal como lo mandaste) y la Response. Las corridas del botón Probar no aparecen: no son entregas reales.

Audit Logs filtrado por tienda-reclamos con una fila expandida mostrando Request y Response — Audit Logs guarda el cuerpo que llegó y lo que contestó Nxar, porque el endpoint tiene el log prendido.

Los Logs de ejecución del builder de la automation no muestran las corridas que llegan por un endpoint: para esas, el lugar es Audit Logs. Por eso conviene dejar Registrar cada request prendido mientras armás la integración.

Cuando algo falla

Status	Qué dice	Qué revisar
401	`Missing webhook token: …`	No llegó el header `X-Webhook-Token` (ni `Authorization: Bearer`). No se corrió nada
401	`Invalid webhook token`	El token no es el activo: ¿está mal copiado o lo rotaste? No se corrió nada
429	`Too many failed authentication attempts`	Más de 20 intentos con token equivocado en un minuto desde la misma IP. Esperá lo que indica `Retry-After`
404	`Custom endpoint '…' not found`	El nombre en la URL está mal escrito, o el endpoint está inactivo
400	`Request body is not valid JSON`	El JSON está roto: una comilla o una llave de más
422	`Input validation failed: {"subject":"required"}`	Falta un input obligatorio o vino con un tipo que no es el declarado
422	`Automation is disabled`	La automation está inactiva: prendela en el builder

Un 422 también aparece cuando el flujo falla adentro (por ejemplo, un campo del Case con un valor que no acepta). El mensaje dice qué pasó, y en Audit Logs tenés el cuerpo exacto para reproducirlo con Probar.

En Windows, desde PowerShell, escribí curl.exe en lugar de curl, y si el JSON te da problemas con las comillas, usá el botón Probar o la pestaña Herramientas no-code con una app como Postman.

Cómo saber que te salió

Probar devolvió 200 con un case_id, y el curl también.
En Cases están los dos reclamos con Julieta como dueña.
En Audit Logs, filtrando por tienda-reclamos, ves la llamada de curl con su Request y su Response.
Si cambiás una letra del token y repetís el curl, recibís 401 y no se crea nada.

¿Llegaste al resultado de arriba?

En la referencia