> ## Documentation Index
> Fetch the complete documentation index at: https://revolai.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Webhook Personalizado

> Envíe datos de leads a cualquier CRM o sistema externo vía HTTP

## Descripción General

El Webhook Personalizado es la integración más simple — envía solicitudes HTTP a cualquier URL que usted especifique. Úselo para enviar datos de leads a un CRM, activar automatizaciones en Zapier/Make, o conectarse a cualquier sistema con una API.

Sin OAuth, sin SDK — solo una URL destino y encabezados opcionales.

## Configuración

<Steps>
  <Step title="Agregar Integración">
    Vaya a **Integraciones** → **Agregar Integración** → seleccione **Webhook Personalizado** de la categoría CRM.
  </Step>

  <Step title="Configurar">
    | Campo                   | Requerido | Descripción                                                                              |
    | ----------------------- | --------- | ---------------------------------------------------------------------------------------- |
    | **URL del Webhook**     | Sí        | El endpoint al que enviar datos                                                          |
    | **Secreto del Webhook** | No        | Secreto para firma HMAC-SHA256 de solicitudes                                            |
    | **Encabezados**         | No        | Encabezados HTTP personalizados (formato JSON, por ejemplo, `Authorization: Bearer ...`) |
  </Step>

  <Step title="Probar">
    Haga clic en **Probar Conexión**. Revol envía un payload de prueba y verifica que la URL responda con un estado 2xx.
  </Step>
</Steps>

## Herramientas del Agente

| Herramienta       | Descripción                                                                                                                                          |
| ----------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- |
| `send_payload`    | Enviar datos JSON estructurados (información de lead, datos de formulario) a la URL del webhook. Firmado con HMAC-SHA256 si se configura un secreto. |
| `test_connection` | Verificar que la URL del webhook es accesible y responde correctamente                                                                               |

## Formato del Payload

Cuando un agente invoca `send_payload`, Revol envía una solicitud POST con un cuerpo JSON. El contenido es determinado por el agente de IA basándose en qué información se recopiló durante la conversación:

```json theme={null}
{
  "event": "lead_captured",
  "timestamp": "2026-03-07T14:30:00Z",
  "company_id": 5,
  "agent_id": 12,
  "conversation_id": "conv_abc123",
  "data": {
    "name": "John Doe",
    "email": "john@example.com",
    "phone": "+380501234567",
    "message": "Interested in Enterprise plan",
    "source": "website_widget",
    "utm_campaign": "spring_promo"
  }
}
```

## Firma de Solicitudes

Si proporciona un **Secreto del Webhook**, cada solicitud se firma con HMAC-SHA256:

* La firma se incluye en el encabezado `X-Webhook-Signature`
* Verifíquela en su servidor calculando `HMAC-SHA256(cuerpo_solicitud, su_secreto)` y comparando

## Uso en Nodos del Workflow

Las herramientas de webhook funcionan como cualquier otra herramienta del agente:

1. Conecte la integración de webhook y pruebe la URL
2. Las herramientas aparecen en la pestaña **Herramientas** del agente
3. Agregue `send_payload` a un **nodo personalizado** en el editor de workflow
4. El LLM decide cuándo enviar datos basándose en el contexto de la conversación

**Ejemplo de workflow:** El agente recopila información del lead (nombre, email, teléfono, interés) → al finalizar la conversación, usa `send_payload` para enviar los datos a su CRM.

## Casos de Uso

* **Integración CRM** — Envíe leads calificados a Pipedrive, HubSpot, Salesforce o cualquier CRM con endpoint de webhook/API
* **Zapier / Make** — Active automatizaciones de múltiples pasos desde eventos de conversación
* **Slack / Discord** — Envíe notificaciones cuando se capturan leads de alto valor
* **Backend personalizado** — Llame a su propia API para crear pedidos, actualizar registros o activar workflows internos
* **Analíticas** — Envíe resultados de conversaciones a su almacén de datos