nxar.Aprender
DocsProbar gratis
Integraciones: recibí datos de otros sistemas0 de 6 capítulos
  1. 1Qué puerta usar
  2. 2Tu primer endpoint
  3. 3Probalo y mirá qué llegó
  4. 4Qué recibe y qué contesta
  5. 5La API pública
  6. 6Formularios públicos

Casos de uso

  1. ·Una venta de la tienda crea una oportunidad
  2. ·Un sistema externo actualiza el estado de un caso
  3. ·Un formulario de reclamos que no duplica contactos
  4. ·Probar un webhook sin escribir código

← Volver al recorrido

Caso de uso · Integraciones: recibí datos de otros sistemas · 10 min

Probar un webhook sin escribir código

Probás un endpoint de Nxar con el botón Probar, con Postman o con una herramienta no-code, y encontrás en Audit Logs por qué falló una llamada.

El problema. Configuraste un endpoint con token y el sistema que lo tiene que llamar todavía no está listo, o lo va a llamar una herramienta como Zapier, Make o n8n. Querés saber que funciona antes, y entender qué pasó cuando una llamada falla.

La idea. Nxar te da todo para probar sin programar: el bloque Probar de la vista del endpoint, los datos exactos para una herramienta no-code, y Audit Logs para ver cada llamada real con su cuerpo y su respuesta.

Probalo en un workspace de práctica

Un workspace con el escenario ya armado, que se borra solo a las 48 h. Estamos terminándolo.

Muy prontoMientras tanto, hacelo en tu workspace (14 días de prueba)

Usamos el endpoint tienda-reclamos del capítulo 2; con cualquier otro endpoint con token es igual.

Probá el flujo desde Nxar

ConfiguraciónIntegraciones y APIEndpointsEndpoints y webhookstienda-reclamos

En Probar, pegá un cuerpo en Cuerpo del request y Ejecutar. Ves el status, el tiempo y la respuesta. Es una ejecución real (crea el Case), pero no pasa por el token: sirve para saber que el flujo anda.

Copiá los datos para la herramienta

En Cómo llamarlo, pestaña Herramientas no-code, tenés lo que piden Zapier, Make, n8n o Google Apps Script para un request HTTP: Método POST, la URL, el Header X-Webhook-Token y qué va en el Cuerpo. El valor del token no está: lo guardaste al crear el endpoint. Si lo perdiste, generá uno nuevo en Configuración.

Pestaña Herramientas no-code con método, URL, header y cuerpo
Lo mismo que pide cualquier paso de request HTTP de una herramienta no-code.

Llamalo desde Postman

En Postman, un request nuevo:

  1. Método POST y la URL del endpoint.
  2. En Headers, X-Webhook-Token con tu token. Content-Type: application/json lo agrega Postman solo al elegir JSON en el paso siguiente.
  3. En Body, raw y JSON, y pegá: {"subject":"Prueba desde Postman","email":"cliente@ejemplo.com"}.
  4. Send. Esperás 200 con el case_id.

Ahora mandá el mismo request con una letra del token cambiada: recibís 401.

Encontrá la llamada que falló

ConfiguraciónIntegraciones y APIEndpointsAudit Logs

En Endpoint elegí tienda-reclamos y prendé el filtro de sólo errores (el botón Mostrar solo errores (4xx + 5xx)). Hacé clic en la fila del 401: la Response muestra el error Invalid webhook token. El Request queda vacío a propósito: con un token equivocado, Nxar rechaza la llamada antes de leer el cuerpo.

Audit Logs filtrado por tienda-reclamos mostrando sólo una llamada POST 401 expandida
Con el filtro de errores, una entrega fallida aparece enseguida, con el error que recibió quien llamó.

Si la herramienta reintenta cuando no recibe respuesta, configurala para que mande un header Idempotency-Key con un identificador propio de cada entrega (el id del evento, de la fila o del pedido). Así un reintento no crea un segundo registro.

Cómo saber que te salió

Tenés un Case creado desde Probar y otro desde Postman. En Audit Logs, la llamada de Postman figura con POST 200 y la del token equivocado con POST 401; la de Probar no figura, porque no es una entrega real.

¿Te funcionó?

En la referencia