> For the complete documentation index, see [llms.txt](https://navixy.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://navixy.com/docs/user/es/guide/account/iot-logic/nodes/webhook-node.md).

# Webhook

Envíe solicitudes HTTP POST a API externas cuando IoT Logic reciba datos del dispositivo. Construya cargas útiles JSON personalizadas con valores estáticos y atributos dinámicos de telemetría.

## Visión general técnica y capacidades

{% columns %}
{% column width="58.333333333333336%" %}
**Webhook** El nodo permite activar en tiempo real acciones específicas en sistemas externos. Envía solicitudes HTTP POST a endpoints especificados al recibir datos de nodos conectados. Luego construye cargas útiles JSON personalizadas con atributos estáticos y dinámicos, y ejecuta llamadas a la API a servicios de terceros.
{% endcolumn %}

{% column width="41.666666666666664%" %}

<figure><img src="https://1900701122-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F446mKak1zDrGv70ahuYZ%2Fuploads%2Fgit-blob-0b4156bcc8f11f49a91ad380aa20bf05842c617b%2Fiot-logic-webhook-tile.png?alt=media" alt=""><figcaption></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

El nodo amplía las capacidades de IoT Logic más allá del procesamiento y la transmisión de datos, permitiendo la integración directa con plataformas de mensajería, sistemas ERM y CRM, y aplicaciones personalizadas para iniciar acciones automatizadas según la configuración de su flujo.

{% hint style="info" %}
Los nodos Webhook se configuran por separado para cada flujo en la interfaz de usuario de Navixy. Los nodos Webhook sirven como puntos terminales en un flujo y requieren al menos una conexión entrante para funcionar. No pueden pasar datos a nodos posteriores.
{% endhint %}

<figure><img src="https://1900701122-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F446mKak1zDrGv70ahuYZ%2Fuploads%2Fgit-blob-21ecc9198943832f7ef089cac12b989f3aa37aec%2Fiot-logic-webhook-in-flow.png?alt=media" alt=""><figcaption></figcaption></figure>

### Cómo funcionan los nodos Webhook

Cuando los datos llegan a un nodo Webhook a través de una conexión entrante, ejecuta inmediatamente una solicitud HTTP POST al endpoint configurado. El nodo:

1. Recopila los valores actuales de todos los atributos de los nodos ascendentes conectados
2. Reemplaza las referencias dinámicas a atributos (p. ej., `{{speed}}`) con los valores reales del mensaje entrante
3. Construye la carga útil JSON completa conservando la estructura definida
4. Envía la solicitud HTTP POST con los encabezados especificados al endpoint de destino
5. Continúa sin esperar una respuesta, lo que permite que el flujo continúe de inmediato

El webhook se activa una vez por cada mensaje que llega a él. Si varias ramas paralelas envían datos al webhook, se activa por separado para cada mensaje entrante. Esta ejecución ocurre de forma independiente, sin bloquear otros nodos en el flujo, lo que garantiza un procesamiento continuo de los datos independientemente de los tiempos de respuesta del sistema externo.

Cada **Webhook** resultado de activación del Nodo aparece en [Analizador de datos](https://navixy.com/docs/user/es/guide/account/iot-logic/data-stream-analyzer.md) como un atributo con el nombre del **ID del Nodo** (se muestra en el cuadro de diálogo de configuración del Nodo, por ejemplo, `webhook_1a2b3c4d`). El valor es `0` cuando el nodo no se ha activado y `1` cuando se ha activado, lo que le permite confirmar la entrega y distinguir varios nodos Webhook dentro del mismo flujo.

### Integración con la arquitectura de flujos

Los nodos Webhook funcionan como puntos de terminación que convierten los datos procesados del dispositivo en llamadas API externas. En lugar de transmitir continuamente todos los datos del dispositivo como los nodos de Nodo de Salida, los webhooks ejecutan solicitudes API específicas con cargas útiles configuradas con precisión. Esta arquitectura permite:

* **Automatizaciones impulsadas por eventos**: Active flujos de trabajo externos según condiciones del dispositivo, métricas calculadas o patrones de datos específicos identificados previamente en el flujo
* **Transmisión selectiva de datos**: Envíe solo los atributos relevantes a sistemas externos, reduciendo la transferencia innecesaria de datos y los costos de API
* **Ejecución paralela**: Opere junto con otros nodos de salida, permitiendo activaciones simultáneas de Webhook y transmisión continua de datos a diferentes destinos
* **Integración de múltiples fuentes**: Acepte conexiones entrantes desde varias ramas paralelas y acceda a atributos de todos los nodos conectados

### Capacidades del nodo

El **Nodo Webhook** ofrece:

* **Ejecución de HTTP POST**: Envía solicitudes HTTP POST personalizadas a cualquier endpoint accesible mediante los protocolos HTTP o HTTPS (se recomienda HTTPS)
* **Construcción dinámica de la carga útil**: Construye cuerpos de solicitud JSON combinando valores estáticos con atributos dinámicos de cualquier parte del flujo mediante `{{attribute_name}}` la sintaxis
* **Configuración de encabezados personalizados**: Admite hasta 10 encabezados HTTP definidos por el usuario para autenticación y requisitos específicos de la API
* **Compatibilidad con atributos anidados**: Hace referencia a estructuras de atributos complejas, incluidos objetos y arreglos anidados dentro de la carga útil JSON
* **Ejecución independiente**: Se activa sin esperar respuestas ni bloquear el flujo, lo que permite un funcionamiento confiable independientemente de la disponibilidad del sistema externo

## Opciones de configuración

{% columns %}
{% column valign="middle" %}
El nodo Webhook le permite definir cómo se comunicará su flujo con sistemas externos mediante llamadas a la API HTTP.
{% endcolumn %}

{% column %}

<figure><img src="https://1900701122-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F446mKak1zDrGv70ahuYZ%2Fuploads%2Fgit-blob-11bf6de89a59cf76114222886657ad0d1edcd308%2FWebhook_node_edit.png?alt=media" alt=""><figcaption></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

Veamos qué elementos utiliza este nodo y qué puede configurar al trabajar con él.

### Pasos de configuración

{% stepper %}
{% step %}

#### Especificar el nombre del Nodo

Ingrese un nombre descriptivo que identifique el propósito del webhook.

* Use nombres que indiquen el servicio o la acción de destino (p. ej., "Alertas de velocidad de Slack" o "Creación de tickets de CRM")
* Este nombre aparece en el diagrama de flujo para facilitar su identificación
  {% endstep %}

{% step %}

#### ID del Nodo (generado automáticamente)

Debajo del campo Nombre, el cuadro de diálogo muestra un **ID del Nodo** (por ejemplo, `webhook_1a2b3c4d`). Este campo es de solo lectura; no puede editar ni establecer su valor.

* El ID se genera automáticamente cuando se crea el Nodo y permanece igual durante toda la vida útil del Nodo
* Utilícelo para distinguir los resultados de este nodo de los de otros nodos Webhook en [Analizador de datos](https://navixy.com/docs/user/es/guide/account/iot-logic/data-stream-analyzer.md), donde aparece como un atributo que muestra `0` (no activado) o `1` (activado)
  {% endstep %}

{% step %}

#### Configure la URL del endpoint

Ingrese la URL completa a la que se envían las solicitudes POST.

* Incluya el protocolo: `http://` o `https://` (se recomienda encarecidamente HTTPS)
* Asegúrese de que la URL apunte a un endpoint de API válido que acepte solicitudes POST
* Ejemplo: `https://api.example.com/v1/webhooks/device-alerts`
  {% endstep %}

{% step %}

#### Definir encabezados HTTP

Agregue cualquier encabezado requerido por su API de destino.

1. Haga clic en **Agregar encabezado** para crear pares clave-valor de encabezados\
   Todos los encabezados son configurados por el usuario, incluido Content-Type. Los encabezados comunes incluyen:
   * `Tipo de contenido: application/json` (obligatorio para cargas útiles JSON)
   * `Autorización: Bearer <token>` (para la autenticación de la API)
   * Llaves API personalizadas o encabezados de autenticación según los requisitos del servicio
2. Haga clic en el icono de eliminar para quitar encabezados individuales

{% hint style="info" %}
Se admiten un máximo de 10 encabezados
{% endhint %}
{% endstep %}

{% step %}

#### Construya el cuerpo de la solicitud

Cambie a la **Cuerpo** pestaña y defina la estructura JSON que se publica en el endpoint:

* Ingrese sintaxis JSON válida en el campo Cuerpo
* Usar `{{attribute_name}}` para hacer referencia a cualquier atributo de los nodos conectados
* Admite estructuras JSON anidadas y arreglos
* Las referencias de atributos funcionan con rutas anidadas (por ejemplo, `{{location.latitude}}`)
* Si un atributo referenciado es nulo o no existe, el valor `null` se envía en el JSON

**Ejemplo del cuerpo del Webhook con atributos dinámicos:**

```json
{
  "alert_type": "speed_violation",
  "device_id": "{{device_id}}",
  "current_speed": "{{speed_mph}}",
  "threshold_exceeded": 80,
  "location": {
    "lat": "{{latitude}}",
    "lng": "{{longitude}}"
  },
  "timestamp": "{{message_time}}","
  "conductor": "{{hardware_key}}"
}
```

{% endstep %}

{% step %}

#### Guarde su configuración

Haga clic en **Aplicar cambios** para almacenar la configuración del Nodo Webhook.
{% endstep %}
{% endstepper %}

## Comportamiento de ejecución del Webhook

El Webhook se ejecuta sin esperar respuestas del punto de conexión externo. El éxito o el fallo de la solicitud del Webhook no afectan la operación continua del flujo ni bloquean a otros nodos para procesar datos.

{% hint style="danger" %}
Actualmente, la ejecución del Webhook no incluye reintentos automáticos, registro de intentos fallidos ni gestión de respuestas. Si un endpoint devuelve un error o agota el tiempo de espera, el Webhook se activará nuevamente en el siguiente mensaje entrante. En futuras actualizaciones podrían incluirse límites de frecuencia definidos por el destino y puesta en cola de solicitudes.
{% endhint %}

### Webhook frente a la transmisión continua de datos

**Nodo Webhook** difiere fundamentalmente de **Nodo de Salida** en su propósito y patrón de ejecución:

| Nodo Webhook                                                                                                                                                                                                  | Nodo de Salida                                                                                                                                                                                                            |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Ejecuta llamadas API discretas en cada mensaje, enviando cargas útiles personalizadas que usted defina. Ideal para activar acciones externas, enviar notificaciones o transmitir datos selectivos a API REST. | Mantiene flujos continuos de datos mediante MQTT, transmitiendo datos completos del dispositivo en formato Navixy Generic Protocol. Diseñado para la recopilación continua de telemetría y la supervisión en tiempo real. |

Elija webhooks cuando necesite activar automatizaciones externas o enviar solo atributos específicos a puntos de conexión de API. Use puntos de salida para flujos continuos de datos hacia plataformas de análisis o sistemas de supervisión. Ambos pueden coexistir en el mismo flujo.

### Integración con sistemas externos

Los nodos Webhook destacan al activar acciones basadas en eventos en sistemas que ofrecen API REST. Los patrones comunes de integración incluyen:

* **Plataformas de mensajería**: Envíe notificaciones a Slack, Microsoft Teams, WhatsApp o Telegram cuando las condiciones del dispositivo cumplan criterios específicos
* **Sistemas ERP**: Sincronice los datos del dispositivo con plataformas de planificación de recursos empresariales para actualizar los niveles de inventario, activar flujos de trabajo de aprovisionamiento o registrar el uso del equipo para la Programación de Mantenimiento
* **Sistemas de gestión de tickets**: Cree automáticamente tickets de soporte o solicitudes de servicio en plataformas CRM cuando se detecten problemas en el dispositivo
* **Servicios de alerta**: Active SMS, correos electrónicos o notificaciones push a través de servicios como Twilio, SendGrid o Firebase cuando se superen los umbrales
* **Automatización empresarial**: Inicie flujos de trabajo en herramientas como Zapier, Make (Integromat) o n8n en función de la telemetría del dispositivo
* **Sistemas telemáticos**: Active acciones o automatizaciones específicas en soluciones telemáticas de terceros basadas en datos procesados, lo que permite flujos de trabajo impulsados por eventos, como recálculos de ruta, notificaciones al conductor o actualizaciones de estado en sistemas externos de gestión de flotas
* **Aplicaciones personalizadas**: Active la lógica empresarial propia enviando eventos del dispositivo a API internas

## Preguntas frecuentes

#### ¿Cómo puedo activar webhooks solo bajo condiciones específicas?

Use el **IF/THEN Lógica** nodo para implementar lógica condicional antes del webhook. El **IF/THEN Lógica** nodo puede evaluar atributos del dispositivo y enviar los datos al webhook solo cuando se cumplan las condiciones. Para obtener detalles, consulte [IF/THEN Lógica](https://navixy.com/docs/user/es/guide/account/iot-logic/nodes/logic-node.md).

#### ¿Puedo usar varios nodos Webhook en el mismo flujo?

Sí. Incluya varios **nodos Webhook** con diferentes configuraciones para activar varios sistemas externos en función de los mismos datos del dispositivo. Cada webhook se activa de forma independiente cuando recibe datos.

#### ¿Qué sucede si falla la solicitud del webhook?

El webhook se activa sin esperar una respuesta y no reintenta automáticamente. Si el endpoint externo no está disponible o devuelve un error, el flujo continúa procesándose normalmente. El webhook intenta activarse de nuevo cuando llega el siguiente mensaje. Actualmente, no hay registro de los intentos fallidos de webhook.

#### ¿Cómo me autentico con API externas?

Configure la autenticación completamente mediante encabezados personalizados. Enfoques comunes:

* **Tokens Bearer**: Agregue el encabezado `Authorization` con el valor `Bearer su_token_aquí`
* **Llaves API**: Agregue encabezados personalizados según lo especifique su proveedor de API
* **Autenticación básica**: Agregue el encabezado `Authorization` con el valor `Basic credenciales_codificadas_en_base64`

Incluya siempre `Tipo de contenido: application/json` como encabezado al enviar cargas JSON.

#### ¿Puedo hacer referencia a atributos de varios nodos conectados?

Sí. El nodo webhook puede acceder a atributos de cualquier nodo conectado a él, incluidas las ramas en paralelo. Si varios nodos envían datos al webhook, este se activa una vez por cada mensaje entrante y puede hacer referencia a atributos de la ruta de origen de ese mensaje.

#### ¿Qué datos puedo incluir en el cuerpo del webhook?

Puede incluir cualquier combinación de:

* Valores estáticos definidos directamente en su configuración JSON
* Atributos dinámicos del flujo usando `{{attribute_name}}` la sintaxis
* Atributos anidados de estructuras de datos complejas
* Atributos calculados en **nodos Iniciar atributo** o procesados mediante **IF/THEN Lógica** nodos

El cuerpo debe ser JSON válido. Si un atributo referenciado no existe o contiene un valor nulo, `null` se envía en el JSON.

#### ¿Cómo puedo probar la configuración de mi webhook?

Abra [Analizador de datos](https://navixy.com/docs/user/es/guide/account/iot-logic/data-stream-analyzer.md) para el flujo y seleccione el dispositivo que lo activa. Busque el atributo que coincida con el ID del Nodo de este nodo: su valor cambia a `1` cada vez que se activa el webhook, `0` de lo contrario. Esto confirma que el webhook se activó sin necesidad de acceder al endpoint de destino.

Para verificar que el destino realmente recibió la carga útil esperada, considere usar servicios de prueba de webhook como webhook.site o RequestBin durante el desarrollo para inspeccionar las solicitudes exactas que se envían.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://navixy.com/docs/user/es/guide/account/iot-logic/nodes/webhook-node.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
