Saltar al contenido principal

​
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

1

Agregar Integración

Vaya a Integraciones → Agregar Integración → seleccione Webhook Personalizado de la categoría CRM.
2

Configurar

CampoRequeridoDescripción
URL del WebhookSíEl endpoint al que enviar datos
Secreto del WebhookNoSecreto para firma HMAC-SHA256 de solicitudes
EncabezadosNoEncabezados HTTP personalizados (formato JSON, por ejemplo, Authorization: Bearer ...)
3

Probar

Haga clic en Probar Conexión. Revol envía un payload de prueba y verifica que la URL responda con un estado 2xx.

​
Herramientas del Agente

HerramientaDescripción
send_payloadEnviar 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_connectionVerificar 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: 
{
  "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