Para integrar Papo (https://papo.global/) con n8n y automatizar procesos, puedes utilizar las claves de API de la plataforma para enviar datos de contactos, gestionar conversaciones o disparar acciones, y también configurar webhooks en los Flows de Automatización para que Papo notifique a n8n cada vez que ocurra un evento, como un nuevo mensaje o un lead calificado.
Papo ofrece dos formas principales de comunicarse con n8n, una de las plataformas de automatización más populares. La primera es la API, que permite que n8n haga llamadas activas a Papo (por ejemplo, para crear un contacto o enviar un mensaje). La segunda son los webhooks, que hacen el camino inverso: Papo envía información automáticamente a n8n cuando algo sucede dentro de un flujo de atención.
| Método de Integración | Dirección | Uso Principal | Cómo Configurar |
|---|---|---|---|
| API de Papo | n8n → Papo | Enviar comandos a Papo (crear contacto, enviar mensaje, buscar datos). | Generar clave secreta en el panel de Papo y usar el nodo HTTP Request de n8n con autenticación Bearer. |
| Webhook de Papo | Papo → n8n | Recibir notificaciones automáticas de Papo cuando ocurre un evento (nueva conversación, lead calificado). | Crear un nodo Webhook en n8n para generar una URL y configurar la acción "Enviar Webhook" en un Flow de Papo. |
Cómo funciona la integración vía API
La API de Papo es la puerta de entrada para que n8n ejecute acciones en tu cuenta de forma programática. Con ella, puedes automatizar tareas como sincronizar contactos con un CRM externo, disparar mensajes de WhatsApp desde un disparador o extraer datos de leads.
1. Genera tus claves de API en Papo
Accede a tu panel de Papo y ve a Configuraciones. En la sección de Desarrolladores o API, encontrarás tu Clave Pública (fija) y podrás generar una Clave Secreta. Dale un nombre descriptivo (ej.: "Integración n8n") y copia la clave secreta inmediatamente — se mostrará solo una vez.
2. Configura el nodo HTTP Request en n8n
Dentro de un workflow en n8n, agrega un nodo HTTP Request. En el campo de URL, utiliza el endpoint deseado de la API de Papo. La URL base es:
https://app.papo.global/api/v1
Para autenticar, agrega un encabezado Authorization con el valor Bearer sk_live_TU_CLAVE_SECRETA. Una buena prueba inicial es llamar al endpoint /me, que devuelve los datos de tu cuenta:
GET https://app.papo.global/api/v1/me
Authorization: Bearer sk_live_...
3. Arma tu flujo de automatización
Con la autenticación funcionando, puedes crear workflows completos. Por ejemplo:
- Nuevo lead del formulario → crear contacto en Papo: un nodo Webhook en n8n recibe los datos del formulario, y un nodo HTTP Request llama a la API de Papo para crear el contacto.
- Buscar contactos extraídos y enviarlos a una hoja de cálculo: n8n consulta periódicamente la lista de contactos del Extrator y los inserta en Google Sheets.
La API de Papo permite buscar, crear y actualizar contactos, enviar mensajes de WhatsApp, listar ejecuciones del Extrator y mucho más. La documentación completa con todos los endpoints está disponible en papo.global/pt/docs.
Cómo funciona la integración vía Webhooks
Los webhooks son ideales para reaccionar a eventos que ocurren dentro de Papo en tiempo real. Configuras un Flow para disparar una notificación automática a n8n cada vez que un contacto alcance una etapa específica.
1. Crea un disparador Webhook en n8n
En el editor de n8n, agrega un nodo Webhook como disparador de tu workflow. Elige el método POST y copia la URL de producción generada. Esa URL será el destino de los datos enviados por Papo.
2. Configura la acción "Enviar Webhook" en el Flow de Papo
Dentro del editor de Flows de Papo, agrega el nodo de acción "Enviar Webhook" en el punto de la jornada donde deseas que ocurra la notificación (por ejemplo, justo después de que un lead responda una pregunta de calificación).
Completa los campos:
- URL del Webhook: pega la URL copiada de n8n.
- Método HTTP: selecciona
POST. - Cuerpo (Payload): arma un JSON con las variables del contacto que quieres enviar. Ejemplo:
{
"nombre": "{{contact.name}}",
"email": "{{contact.email}}",
"telefono": "{{contact.phone}}",
"etapa": "Lead calificado",
"origen": "Flow de Bienvenida"
}
3. Prueba y activa
Antes de publicar, haz una prueba con una URL de servicio como Webhook.site para verificar que los datos lleguen correctamente. Después, reemplázala por la URL de n8n y activa el Flow. A partir de ese momento, cada vez que un contacto pase por ese nodo, n8n recibirá los datos y podrá ejecutar acciones como registrar el lead en un CRM, enviar un correo electrónico o actualizar una hoja de cálculo.
Para quién es esta integración
La conexión entre Papo y n8n es útil para empresas que ya utilizan Papo como central de atención y ventas en WhatsApp y necesitan conectar esos procesos con otros sistemas sin depender de desarrollo interno. Agencias de marketing, equipos de ventas y operaciones de soporte pueden, por ejemplo, sincronizar automáticamente contactos entre Papo y un ERP, disparar campañas segmentadas o crear dashboards personalizados.
Preguntas Frecuentes (FAQ)
¿Necesito saber programar para integrar Papo con n8n?
No. n8n es una herramienta visual de automatización, y la configuración de la API o del webhook se hace completando campos y armando pequeños bloques de JSON. Conocimientos básicos de APIs REST ayudan, pero no son obligatorios.
¿Qué acciones de Papo puedo automatizar con la API?
Puedes buscar, crear y actualizar contactos, enviar mensajes de WhatsApp, listar contactos extraídos por el Extrator, consultar datos de ejecuciones y mucho más. La lista completa está en la documentación oficial.
¿El webhook de Papo envía los datos en tiempo real?
Sí. Tan pronto como el contacto alcanza el nodo "Enviar Webhook" en un Flow activo, Papo dispara la solicitud inmediatamente a la URL configurada.
¿Puedo usar la API para crear un contacto en el CRM a partir de un formulario en mi sitio web?
Sí. Basta con configurar un nodo Webhook en n8n para capturar los datos del formulario y, luego, un nodo HTTP Request para llamar a la API de Papo y crear el contacto con la información recibida.
¿Dónde encuentro la documentación completa de la API de Papo?
La documentación técnica con todos los endpoints, parámetros y ejemplos está disponible en papo.global/pt/docs.
¿La API y los webhooks están disponibles en el plan gratuito?
Sí, tanto la API como los webhooks forman parte de la plataforma y pueden ser utilizados por cualquier cuenta de Papo. Puedes comenzar gratuitamente con el primer usuario y probar todas las integraciones.
Lee también
Comienza gratis en Papo Global →
El primer usuario es gratis y ya puedes probar la API y los webhooks para automatizar tus procesos sin costo.