Conecta birdo.chat con las herramientas que ya usas

Un webhook manda un aviso a una dirección (URL) tuya cada vez que pasa algo en tus conversaciones. Es la base de todas las demás integraciones: Zapier, Make y n8n lo usan por dentro.

1. 1En tu panel, entra a Integraciones y toca Agregar webhook.
2. 2Pega la URL que recibirá los avisos (debe ser https) y elige los eventos que quieres.
3. 3Copia la clave secreta para verificar que cada aviso viene de birdo.chat.
4. 4Toca Enviar prueba para revisar que tu URL responde.

Eventos

Ejemplo de aviso

Se envía como POST con el cuerpo en JSON. Todos los eventos traen la conversación, el contacto y de dónde llegó.

{
  "id": "evt_8f2c41d0",
  "type": "conversation.handoff",
  "created_at": "2026-11-10T18:42:05Z",
  "site": { "id": "site_31a", "name": "Mueblería López" },
  "conversation": {
    "id": "conv_92b7",
    "code": "#K4P",
    "channel": "web",
    "status": "pending",
    "summary": "Quiere apartar la Sala Roma gris ($15,999).",
    "url": "https://birdo.chat/panel/conversaciones/conv_92b7"
  },
  "contact": {
    "name": "Laura",
    "phone": "+523312345678",
    "email": "laura@ejemplo.com"
  },
  "source": {
    "page": "https://mueblerialopez.com/salas",
    "utm_source": "facebook",
    "utm_campaign": "promo-buen-fin",
    "gclid": null,
    "fbclid": "IwAR2x…"
  }
}

Verifica que viene de nosotros

Cada aviso trae los encabezados X-Birdo-Timestamp y X-Birdo-Signature. La firma es un HMAC SHA-256 de timestamp.cuerpo con tu clave secreta.

import crypto from "node:crypto";

// En tu servidor, con el cuerpo tal cual llegó (sin convertirlo a JSON antes).
export function isFromBirdo(rawBody, headers, secret) {
  const timestamp = headers["x-birdo-timestamp"];
  const signature = headers["x-birdo-signature"]; // "sha256=…"
  const expected = "sha256=" + crypto
    .createHmac("sha256", secret)
    .update(`${timestamp}.${rawBody}`)
    .digest("hex");
  const fresh = Math.abs(Date.now() / 1000 - Number(timestamp)) < 300;
  return fresh && crypto.timingSafeEqual(Buffer.from(signature), Buffer.from(expected));
}

Reintentos

• Responde con un código 2xx en menos de 10 segundos; si no, lo reintentamos hasta 6 veces durante 24 horas.
• Usa el campo id para no procesar dos veces el mismo aviso.
• En el panel verás el historial de envíos, con la respuesta de tu servidor.

Con la app de birdo.chat en Zapier conectas tus conversaciones con más de 7,000 apps sin escribir código.

1. 1En Zapier crea un Zap y busca birdo.chat como disparador.
2. 2Elige el evento: Nuevo contacto, Chat pasado a tu equipo o Conversación cerrada.
3. 3Conecta tu cuenta con la llave que encuentras en tu panel, en Integraciones.
4. 4Agrega la acción: por ejemplo, crear el contacto en HubSpot o una fila en Google Sheets.

Mientras sale la app, puedes usar Webhooks by Zapier (Catch Hook) y pegar esa URL en un webhook de birdo.chat.

1. 1En Make crea un escenario y agrega el módulo Webhooks › Custom webhook.
2. 2Copia la URL que te da Make y pégala en un webhook nuevo en tu panel de birdo.chat.
3. 3Toca Enviar prueba para que Make reconozca los campos del aviso.
4. 4Agrega los módulos que quieras: Google Sheets, tu CRM, Slack, correo…

1. 1Agrega un nodo Webhook con método POST y copia su URL de producción.
2. 2Pégala en un webhook nuevo en tu panel de birdo.chat y elige los eventos.
3. 3Opcional: agrega un nodo Code para verificar la firma con tu clave secreta (ejemplo arriba).
4. 4Continúa el flujo con los nodos que necesites.

Cada contacto nuevo en una fila, listo para dar seguimiento o compartir con tu equipo. Se arma con Zapier, Make o n8n en unos minutos:

1. 1Crea una hoja con columnas: Fecha, Nombre, Teléfono, Correo, Página, Campaña, Resumen.
2. 2Usa el evento contact.captured como disparador.
3. 3Agrega la acción Agregar fila y relaciona cada columna con el campo del aviso.

Cuando un chat pasa a tu equipo, crea o actualiza el contacto en HubSpot, Pipedrive, Zoho u otro CRM, con el resumen de la conversación y la campaña de donde llegó. Se arma con Zapier, Make o n8n usando el evento conversation.handoff.

birdo.chat guarda el gclid (Google) y el fbclid (Meta) de cada cliente que llega desde un anuncio. Con esta integración, cuando el chat pasa a tu equipo o lo marcas como venta, se lo devolvemos a tu cuenta de anuncios como conversión.

• Google Ads: como conversión sin conexión, ligada al clic del anuncio.
• Meta: por la API de Conversiones, para que sus campañas aprendan qué clientes sí compran.
• Ves en tus anuncios qué campañas traen ventas, no solo clics.

Para tus sistemas: consulta contactos y conversaciones con una llave privada que generas en tu panel. Solo lectura al inicio.

curl https://birdo.chat/api/v1/contacts?since=2026-11-01 \
  -H "Authorization: Bearer bk_live_…"

• GET /api/v1/contacts · contactos con su origen.
• GET /api/v1/conversations · conversaciones con sus mensajes y estado.
• Límite de 60 consultas por minuto por cuenta.