Enviar datos a otro sistema (webhook saliente)

​

Antes de empezar

• Una URL pública (https://…) que acepte un POST con JSON. Si usas Zapier, Make o n8n, es la URL que te da su disparador de tipo Webhook.
• Si todavía no tienes servidor, usa webhook.site: te da una URL de prueba y te muestra todo lo que le llega.

​

Crear el webhook

​

Qué recibe tu sistema

​

Encabezados

​

El cuerpo por defecto

{
  "event": "contacto_calificado",
  "timestamp": "2026-10-14T18:22:05.000000Z",
  "data": {
    "event_type": "lead_stage_changed",
    "conversation": { "id": 7788, "…": "…" },
    "contact": { "id": 300, "name": "Ana López", "email": "ana@ejemplo.com", "phone": "+525512345678", "…": "…" },
    "agent": { "id": 8, "name": "Luis", "email": "luis@ejemplo.com", "…": "…" },
    "stage": { "id": 12, "name": "Calificado", "…": "…" },
    "channel_type": { "…": "…" },
    "trigger": { "id": 55, "name": "Avisar al ERP", "…": "…" }
  }
}

• event es el Nombre del Evento y timestamp, la hora del envío.
• data trae la conversación, el contacto, el agente, la etapa y el canal, más el objeto propio del evento cuando aplica: booking en reservas, sale en ventas, deal en oportunidades, ticket en tableros. Lo que trae cada evento está en la columna Datos que trae de la lista de eventos.
• Los mismos datos también llegan con su nombre anterior (lead, client, source, sender) para no romper integraciones viejas. Usa los nuevos.

​

Payload personalizado

{
  "tipo": "contacto_calificado",
  "conversacion_id": "{{lead.id}}",
  "nombre": "{{client.full_name}}",
  "correo": "{{client.email}}",
  "telefono": "{{client.phone}}",
  "etapa": "{{stage.name}}",
  "agente": "{{agent.name}}"
}

• Las variables funcionan en los valores, no en los nombres de los campos.
• El resultado siempre es texto: "{{lead.id}}" llega como "7788", no como número.
• Si la variable no existe para ese evento (por ejemplo, {{booking.id}} en un evento de conversación), llega tal cual, con las llaves. Si ves {{…}} en lo que recibes, esa es la causa.

​

Verificar la firma

import { createHmac, timingSafeEqual } from 'node:crypto';

// rawBody: el cuerpo tal como llegó (Buffer o string), ANTES de JSON.parse
function firmaValida(rawBody, header, secreto) {
  const esperada = 'sha256=' + createHmac('sha256', secreto).update(rawBody).digest('hex');
  const recibida = header ?? '';
  return recibida.length === esperada.length
    && timingSafeEqual(Buffer.from(recibida), Buffer.from(esperada));
}

$cuerpo = file_get_contents('php://input'); // cuerpo crudo
$recibida = $_SERVER['HTTP_X_WEBHOOK_SIGNATURE'] ?? '';
$esperada = 'sha256=' . hash_hmac('sha256', $cuerpo, $secreto);

if (! hash_equals($esperada, $recibida)) {
    http_response_code(401);
    exit;
}

​

Si tu sistema falla

• Asistian espera la respuesta hasta 30 segundos.
• Cualquier respuesta 2xx cuenta como entregado. Cualquier otro código, un error de red o pasarse del tiempo cuenta como fallo.
• Un envío fallido no se reintenta. Si tu servidor estaba caído en ese momento, ese aviso se pierde: diseña tu integración para poder ponerse al día (por ejemplo, con una revisión periódica).
• Responde 200 en cuanto recibas el envío y procesa después, en segundo plano. Un sistema que tarda más de 30 segundos se ve como caído aunque al final termine bien.

​

Ver lo que se envió

• Historial de la automatización (en su tarjeta, en Configuración → Automatizaciones): cada ejecución, si salió bien y, si falló, el motivo (por ejemplo, HTTP 404).
• Configuración → Integraciones → Webhooks → Gestionar, pestaña Registros de Ejecución: los últimos envíos y recepciones de webhooks de tu cuenta, con su estado y tiempo de respuesta.

​

Que tu asistente de IA lo dispare

​

Preguntas frecuentes