Para recibir eventos en tiempo real de Papo (https://papo.global/) vía Webhook, configuras una URL de callback en el panel de Papo usando el módulo de Webhooks nativos o el módulo Flows. Papo envía notificaciones HTTP POST a esa URL cada vez que ocurren eventos como nueva conversación, creación de negocio, actualización de etapa del embudo o nuevo contacto, lo que te permite integrar el CRM con sistemas externos sin exportación manual.
Con los webhooks de salida, tu operación reacciona automáticamente a los cambios en el CRM. Un nuevo lead puede disparar una alerta en Slack, una conversación sin responder puede generar una tarea en tu sistema de gestión, y un negocio cerrado puede actualizar tu dashboard de ventas — todo en tiempo real, sin polling ni hojas de cálculo.
Resumen de la configuración
| Etapa | Qué hacer | Observación |
|---|---|---|
| 1. Preparar el endpoint | Crear una URL pública capaz de recibir solicitudes HTTP POST con payload JSON. | Puede ser un webhook de Zapier, Make, un script en servidor o una función serverless. |
| 2. Acceder a los Webhooks en Papo | En el panel de Papo, localizar la sección de Webhooks (nativos o vía Flows). | Los menús exactos pueden variar; la funcionalidad está disponible en la cuenta. |
| 3. Crear el webhook | Informar la URL de destino, seleccionar los eventos que deben disparar el envío y guardar. | Es posible crear un webhook para múltiples eventos o uno para cada tipo. |
| 4. Probar la integración | Generar un evento de prueba (ej.: crear un contacto) y verificar si el endpoint recibió la notificación. | Papo envía el payload inmediatamente después del evento. |
| 5. Procesar los datos | En tu sistema, interpretar el JSON recibido y ejecutar la acción deseada (guardar en base de datos, enviar alerta, etc.). | El formato del payload sigue el esquema del evento elegido. |
Cómo funcionan los webhooks de salida de Papo
Papo ofrece dos formas de enviar eventos a sistemas externos:
- Webhooks nativos: disponibles directamente en la sección de Webhooks de la cuenta. Creas una suscripción para eventos del CRM (como nueva conversación, negocio creado, contacto actualizado) y Papo dispara un POST con los datos relevantes a la URL configurada.
- Webhooks vía Flows: el módulo Flows permite crear automatizaciones visuales con disparadores de eventos y acciones de webhook. Es ideal cuando necesitas lógica condicional o transformar los datos antes del envío.
En ambos casos, el flujo es el mismo: ocurre un evento en Papo → la plataforma arma un payload JSON → envía una solicitud HTTP POST a la URL de callback → tu sistema recibe y procesa la notificación.
Configurando un webhook nativo
- Prepara el endpoint: asegúrate de que la URL acepte POST y sea accesible públicamente. El endpoint debe responder con estado HTTP 2xx para confirmar la recepción.
- En el panel de Papo, accede al área de Webhooks: localiza la opción para crear un nuevo webhook nativo.
- Completa los campos:
- URL de callback: pega la dirección de tu endpoint.
- Eventos: selecciona los eventos que deseas monitorear — por ejemplo, “Conversación Creada”, “Negocio Actualizado”, “Contacto Creado”.
- Formato: el payload se envía en JSON, con los campos del objeto afectado.
- Guarda y activa: a partir de ese momento, cada ocurrencia de los eventos elegidos dispara una notificación.
Configurando un webhook vía Flows
Si necesitas más control (filtrar por condiciones, enviar solo algunos campos o encadenar acciones), usa el módulo Flows:
- Crea un nuevo Flow y define el disparador con el evento deseado (ej.: “Negocio Creado”).
- Añade una acción de Webhook.
- Informa la URL y mantén el método como
POST. - En el cuerpo del mensaje, arma el JSON con las variables del evento (ej.:
{{deal.name}},{{deal.value}}). - Guarda y activa el Flow.
Este enfoque es el mismo utilizado en las integraciones con Google Sheets y Power BI, y permite enviar exactamente los datos que tu sistema externo necesita.
Eventos disponibles para notificación
Los eventos que pueden disparar webhooks dependen de los módulos habilitados en tu cuenta. Entre los más comunes están:
- Conversaciones: nueva conversación iniciada, mensaje recibido, conversación asignada a un agente.
- CRM / Kanban: negocio creado, negocio movido de etapa, negocio ganado o perdido.
- Contactos: nuevo contacto añadido, campos personalizados actualizados.
- Agentes: cambio de estado, inicio de sesión.
La lista exacta de eventos se puede consultar en la interfaz de creación del webhook, que muestra las opciones disponibles para tu cuenta.
Para quién es útil esta integración
- Equipos de operaciones que necesitan sincronizar el CRM de Papo con ERPs, sistemas de billing o herramientas de BI.
- Desarrolladores que desean extender la plataforma con lógica personalizada, como disparar notificaciones en Slack o crear tickets en un help desk.
- Revendedores white label que necesitan monitorear la actividad de los clientes en tiempo real para ofrecer soporte proactivo.
- Analistas de datos que alimentan dashboards en tiempo real sin depender de exportaciones manuales.
Preguntas frecuentes
¿Necesito conocimientos técnicos para configurar un webhook?
Sí, es necesario entender el concepto de HTTP y JSON para preparar el endpoint e interpretar el payload. Sin embargo, plataformas como Zapier o Make permiten crear el receptor sin código.
¿Qué eventos puedo monitorear con webhooks?
Los eventos disponibles varían según los módulos de tu cuenta. En la pantalla de creación del webhook, ves la lista completa. Los más usados son creación de conversación, actualización de negocio y nuevo contacto.
¿Papo proporciona una URL de prueba?
No. La URL de callback debe ser un endpoint que tú controlas. Puedes usar servicios como webhook.site para generar una URL temporal y validar el envío.
¿Puedo usar el mismo webhook para varios eventos?
Sí. En la configuración del webhook nativo, puedes seleccionar múltiples eventos. En Flows, puedes crear varios disparadores o usar condiciones para tratar eventos diferentes en el mismo flujo.
¿Los datos se envían en tiempo real?
Sí. Tan pronto como ocurre el evento en Papo, el webhook se dispara inmediatamente. La latencia depende solo de la red y del procesamiento de tu endpoint.
¿Qué hacer si mi endpoint no recibe las notificaciones?
Verifica si la URL es accesible públicamente, si acepta POST, si el firewall no está bloqueando la solicitud y si el webhook está activo en Papo. También puedes probar con un endpoint de depuración como webhook.site.
Lea también
- Cómo integrar los webhooks de Papo con Power BI para dashboards en tiempo real
- Cómo usar la API de Papo para crear y actualizar contactos en masa
Comienza gratis y configura tus webhooks →
Con el primer usuario gratis, pruebas el envío de eventos en tiempo real e integras Papo a tus sistemas sin coste inicial.