Webhooks: lleva cada envío a tu sistema

EsfuerzoSin códigoCanalWebhookPlanGratis

Cada vez que una campaña llega a un contacto, la BIP puede avisarle a otro sistema: crear el contacto en el CRM, mandarle un mensaje al equipo, alimentar una hoja de cálculo. Armas la solicitud una sola vez en el panel, con los datos del contacto en el lugar correcto, y la BIP hace el resto en cada envío.

#Lo que vas a lograr

• Cada contacto de la campaña llega a tu CRM o herramienta, con el nombre, email, teléfono, ciudad, campos y KPIs que elijas.
• Todo en el panel, sin código: método, URL, encabezados y cuerpo, con sugerencias de variables y vista previa.
• Entregas que se recuperan solas: si el destino falla, la BIP vuelve a intentarlo.
• Logs con la solicitud y la respuesta de cada entrega, y métricas por webhook.
• Campañas solo con webhooks, para sincronizar sistemas sin enviar emails.

#Cómo funciona

1. 1Crea el webhook con URL, encabezados y cuerpo
2. 2Pruébalo con un contacto ficticio y revisa el log
3. 3Adjúntalo a una campaña: cada contacto procesado dispara el webhook

Un webhook es una solicitud HTTP que la BIP le hace a tu sistema. Tú defines el método, la URL, los encabezados y el cuerpo en JSON. En el cuerpo, variables como {{ lead.name() }} se convierten en los datos de cada contacto en el momento del envío.

El webhook se ejecuta cuando está adjunto a una campaña. Por cada contacto que procesa la campaña, la BIP arma el cuerpo con los datos de esa persona y lo envía. Funciona en campañas Único, Recurrente y Disparo por API. Quien se dio de baja de todas las comunicaciones no dispara el webhook.

La entrega es exitosa cuando tu sistema responde con un código 2xx (200, 201, 204…). Cualquier otra respuesta, o la falta de respuesta, genera un nuevo intento 60 segundos después. Son hasta 6 intentos en total: el primero y 5 más.

#Paso a paso

#1. Crea el webhook

1. En el menú, abre Webhooks y haz clic en Nuevo webhook. La BIP crea un webhook [sin título] y abre su página.
2. En Configuración de webhook, elige el método. Para enviar los datos del contacto, usa POST (o PUT, si el destino lo pide).
3. Pega la URL que va a recibir los datos en lugar de http://your-webhook-endpoint.com.
4. Haz clic en Guardar.

dash.bip.marketing/…/webhooks/…

Captura de pantalla próximamente

#2. Arma los encabezados y el cuerpo

1. Abre Encabezados y escribe un objeto JSON. Incluye siempre "Content-Type": "application/json": la BIP envía el cuerpo como JSON y la mayoría de los sistemas revisa ese encabezado. Si el destino pide un token, agrégalo también, por ejemplo "Authorization": "Bearer TU_TOKEN".
2. En Plantilla del cuerpo, escribe el JSON que espera el destino. Dentro de un valor entre comillas, escribe {{ y elige la variable en la lista de sugerencias. El ícono de ayuda junto a Plantilla del cuerpo muestra todas las variables.
3. Revisa la Vista previa a la derecha: muestra el cuerpo listo, con los datos de un contacto ficticio, y se actualiza en cuanto dejas de escribir.
4. Haz clic en Guardar.

El cuerpo tiene que ser un JSON válido para guardarse. Por eso, cada variable va entre comillas y llega al destino como texto: "vip": "{{ lead.hasTag('vip') }}" se convierte en "vip": "true".

Para un valor de respaldo cuando el dato está vacío, usa ||: "saudacao": "Hola, {{ lead.firstName() || 'cliente' }}".

dash.bip.marketing/…/webhooks/…

Captura de pantalla próximamente

#3. Ponle nombre y organízalo

1. En la parte superior de la página, haz clic en Ajustes.
2. Completa el Nombre (es lo que aparece al adjuntarlo a campañas), elige un ícono y, si quieres, una Descripción.
3. En Grupo, elige un grupo para organizar la lista. Los grupos de webhooks se crean en Ajustes → Grupos.
4. En Estado, deja Activo encendido.
5. Haz clic en Guardar.

dash.bip.marketing/…/webhooks/…

Captura de pantalla próximamente

#4. Pruébalo con un contacto ficticio

1. Con todo guardado, haz clic en Probar webhook. El botón está disponible cuando no hay cambios sin guardar.
2. La BIP envía una solicitud real a tu URL, con un contacto ficticio (nombre, email, teléfono y ciudades inventados; campos personalizados vacíos), y abre Estadísticas del Webhook.
3. En Logs de Entrega, haz clic en Ver en la fila de la prueba. Solicitud muestra lo que envió la BIP; Respuesta muestra el código y el cuerpo que devolvió tu sistema.

La prueba llega de verdad a tu sistema. Si el destino es el CRM en producción, borra el registro de prueba después, o apunta primero a un entorno de pruebas.

dash.bip.marketing/…/webhooks/stats/…

Captura de pantalla próximamente

#5. Adjúntalo a una campaña

1. En Campañas, abre una campaña o haz clic en Nueva campaña, con el Canal Email.
2. En la sección Webhooks, selecciona hasta 3 webhooks. Cada contacto procesado los dispara todos.
3. Para una campaña solo con webhooks, no elijas Plantilla de email y selecciona al menos un webhook. No sale ningún email: cada contacto solo dispara los webhooks.
4. Elige el Tipo de Programación (Único, Recurrente o Disparo por API), guarda y activa como cualquier campaña.

dash.bip.marketing/…/campaigns/…

Captura de pantalla próximamente

#Referencia

#Configuración del webhook

#Entrega y reintentos

#Variables del contacto

Úsalas dentro de un valor entre comillas. El resultado llega como texto.

#Variables de teléfono

En la máscara, cada 9 es un dígito, que se completa de izquierda a derecha. Para el formato brasileño, usa {{ lead.maskedPhone('national', '(99) 99999-9999') }}.

#Variables de ubicación

Cambia last por first para la primera ubicación. La ubicación siempre es la de la ciudad.

#Variables de baja (opt-out)

#Variables de tu cuenta

El editor crea estas variables a partir de tus campos personalizados, KPIs y etiquetas. En la lista de sugerencias, aparecen con el nombre que les diste.

#Listo para copiar

#Enviar cada contacto a un CRM

Agência Pulso envía a su CRM a cada persona que recibe la campaña de bienvenida. Ajusta los nombres de las claves a lo que espera tu CRM.

{
  "Content-Type": "application/json",
  "Authorization": "Bearer TU_TOKEN_DEL_CRM"
}

{
  "nome": "{{ lead.name() }}",
  "email": "{{ lead.email() }}",
  "telefone": "{{ lead.phone('e164') }}",
  "cidade": "{{ lead.location('last', 'city') }}",
  "estado": "{{ lead.location('last', 'region') }}",
  "origem": "bip",
  "id_bip": "{{ lead.id() }}",
  "criado_em": "{{ lead.createdAt('YYYY-MM-DD') }}"
}

Para enviar al CRM a cada persona en el momento del registro, sin email: crea una campaña solo con este webhook, con Disparo por API en modo Inmediato, y dispárala por la API cuando alguien se registre.

#Avisar al equipo

Muchas herramientas de chat y de automatización reciben mensajes por un webhook entrante, con el texto en el campo text. Imobiliária Marés avisa a sus agentes por cada persona que entra en la campaña de lanzamiento.

{
  "Content-Type": "application/json"
}

{
  "text": "Nuevo interesado: {{ lead.name() }} | {{ lead.email() || 'sin email' }} | {{ lead.phone('international') || 'sin teléfono' }} | {{ lead.location('last', 'city') || 'ciudad no informada' }}"
}

Revisa en la herramienta de destino el nombre del campo de texto que espera y cambia text si hace falta.

#Cómo medir

• Estadísticas del Webhook: en la lista de Webhooks, abre el webhook y haz clic en Ver Estadísticas. Ves Total de Solicitudes, Exitoso, Fallido, Tiempo Promedio de Respuesta, Tasa de Éxito, Tasa de Reintento, Tasa de Error, Códigos de Estado y el Desglose de Entregas. Los números se actualizan En vivo.
• Logs de Entrega: filtra por Desde la fecha, Hasta la fecha y Límite. Cada fila trae Fecha, Estado, URL, Método e Intentos; en Ver, revisas la Solicitud y la Respuesta completas.
• En la campaña: en Ver Estadísticas, Entrega de Webhook y Errores de Webhook muestran el total de la campaña, e Interacciones del destinatario muestra el webhook de cada contacto.
• Una Tasa de Reintento alta indica que el destino está lento o inestable. Abre la Respuesta en los logs para ver el motivo.

#Preguntas frecuentes

#¿Qué cuenta como entrega exitosa?

Una respuesta con código 2xx. Cualquier otro código, o la falta de respuesta, genera un nuevo intento 60 segundos después, hasta 6 intentos en total. Después del sexto fallo, la campaña registra el error de ese contacto.

#¿El webhook cuenta como envío?

En una campaña de email con webhooks, cuenta el envío de ese contacto, una sola vez: los webhooks no suman. En una campaña solo con webhooks, cada contacto procesado cuenta como un envío, como si fuera un email. Probar webhook no cuenta.

#¿Puedo usar variables en la URL o en los encabezados?

No. La URL y los encabezados son fijos. Las variables del contacto funcionan en la Plantilla del cuerpo.

#¿La prueba llega a mi sistema?

Sí. Probar webhook hace una solicitud real, con un contacto ficticio. Usa un entorno de pruebas o borra el registro después.

#Ver también

• Campañas: únicas, recurrentes y por API
• API de la BIP: claves, contactos, eventos y disparos
• Script del sitio: páginas vistas y clics vinculados al contacto
• Cumplimiento: portal de preferencias, bajas y temas
• Referencia completa de la API