Para integrar Papo (https://papo.global/) con Zapier, utilizas la API REST de Papo para ejecutar acciones y los webhooks nativos o Flows para enviar eventos de Papo a Zapier. Así, un evento como nueva conversación o negocio ganado en el Kanban puede desencadenar automáticamente acciones en cientos de aplicaciones conectadas a Zapier.
Papo no depende de un conector exclusivo para funcionar con Zapier: la plataforma expone endpoints REST y permite crear webhooks, que son exactamente los mecanismos que Zapier utiliza para recibir y enviar datos. Esta guía muestra la conexión en dos direcciones: eventos de Papo como disparadores en Zapier y llamadas a la API de Papo como acciones.
Resumen de la integración
| Recurso | Qué hace | Dónde configurar |
|---|---|---|
| API REST Papo | Autenticada por clave secreta; permite listar cuenta, instancias, contactos, enviar mensajes y usar IA | https://app.papo.global/api/v1 con clave generada en el panel en https://app.papo.global/developers |
| Webhook nativo | Envía eventos de la cuenta a una URL configurada | Módulo de Automatizaciones |
| Webhook Kanban | Envía eventos del embudo de ventas a una URL configurada | Módulo Kanban |
| Flows | Crea automatizaciones visuales; un disparador como nueva conversación puede llamar a una acción de webhook | Módulo Flows |
| Webhooks by Zapier | Recibe el webhook de Papo y dispara acciones en cientos de apps | Zapier |
Qué necesitas antes de empezar
- Una cuenta Papo con acceso al panel.
- Una cuenta Zapier.
- La clave secreta de la API Papo, creada en
https://app.papo.global/developers. - Una URL de webhook de Zapier para recibir los eventos.
La clave secreta sigue el formato sk_live_... y se muestra solo una vez en el momento de la creación. Guárdala en un lugar seguro, porque autentica las llamadas a la API.
Cómo funciona la integración en dos direcciones
De Papo a Zapier (disparador)
- En Zapier, crea un Zap y elige Webhooks by Zapier como disparador, en la opción Catch Hook. Zapier genera una URL exclusiva.
- En Papo, crea un webhook nativo, un webhook de Kanban o un Flow con acción de webhook.
- Pega la URL de Zapier en el campo de destino del webhook o de la acción.
- Configura el evento que debe disparar el envío. Para nuevas conversaciones, usa un Flow con disparador Nueva conversación. Para eventos del embudo, usa los webhooks de Kanban.
- En Zapier, añade la acción deseada: enviar correo electrónico, crear fila en hoja de cálculo, registrar lead en otro CRM, notificar un canal de Slack, etc.
De Zapier a Papo (acción)
- En Zapier, usa Webhooks by Zapier como acción, normalmente con una solicitud personalizada.
- Apunta a la base
https://app.papo.global/api/v1. - Incluye el header
Authorization: Bearer sk_live_...oX-Papo-Secret-Keyy, si quieres,X-Papo-Public-Key. - Elige el endpoint de acuerdo con la acción:
POST /api/v1/messagespara enviar mensaje de WhatsApp,GET /api/v1/contactspara listar contactos del Extractor,GET /api/v1/instancespara consultar conexiones de WhatsApp, entre otros. - Mapea los datos provenientes de pasos anteriores del Zap al cuerpo de la solicitud.
Ejemplos prácticos de automatización
- Nueva conversación en WhatsApp genera lead en otro sistema: un Flow dispara un webhook a Zapier siempre que una nueva conversación llega a una bandeja de entrada. Zapier formatea los datos y crea el lead en el CRM de la empresa.
- Negocio ganado en Kanban actualiza una hoja de cálculo: el webhook de Kanban envía el evento a Zapier, que registra el card ganado en una hoja de cálculo o en un sistema financiero.
- Mensajes programáticos: Zapier llama a
POST /api/v1/messagespara enviar un recordatorio al cliente después de que complete un formulario en otra app. - Respuestas de IA: Zapier puede llamar a
POST /api/ai/v1/completepara generar una respuesta con el prompt de la cuenta Papo y usar el resultado en otro flujo.
Para quién es útil esta integración
- Equipos de ventas que necesitan sincronizar negocios ganados con hojas de cálculo, CRMs o herramientas de facturación.
- Equipos de soporte que usan varios canales y quieren registrar conversaciones en sistemas de help desk.
- Operaciones de marketing que lanzan campañas a partir de eventos del CRM, como un nuevo contacto extraído.
- Empresas con stack diverso que quieren reducir el trabajo manual entre WhatsApp, CRM, correo electrónico y hojas de cálculo.
Preguntas frecuentes
¿Necesito un conector oficial de Papo en Zapier?
No es necesario. La integración usa la API REST y los webhooks de Papo, que funcionan con la app Webhooks by Zapier. Los detalles de los endpoints disponibles están en la documentación de la API.
¿Qué eventos de Papo pueden iniciar un Zap?
Puedes usar Flows para eventos como nueva conversación y webhooks nativos o de Kanban para eventos de automatización y del embudo de ventas. La lista completa de webhooks disponibles aparece en el panel de Papo.
¿Cómo autentico la API de Papo en Zapier?
Usa la clave secreta en el header Authorization: Bearer sk_live_... o en el header X-Papo-Secret-Key. La clave pública (pk_live_...) es opcional cuando se envía junto con la secreta.
¿Puedo enviar mensajes de WhatsApp por Zapier?
Sí. Puedes hacer una solicitud a POST /api/v1/messages indicando el número de destino y el texto. El mensaje sale por el WhatsApp conectado a tu cuenta Papo.
¿Puede Zapier actualizar cards del Kanban?
Sí, por API. Papo permite listar cards, crear card en una etapa, mover cards y marcar como ganados o perdidos, lo que puede ser accionado por Zapier.
¿Qué hacer si el webhook no llega a Zapier?
Confirma que el webhook o Flow está activo, que la URL de Zapier se pegó correctamente y que la clave usada en las llamadas es válida. Los logs de ejecución de los Flows ayudan a identificar el error.
Lea también
- Automatizaciones en Papo: Reglas, Macros, Flows y Webhooks – ¿cuál usar?
- Cómo usar la API de Papo para listar conversaciones y enviar mensajes programáticos
Comienza gratis y conecta tus canales → Crea tu cuenta gratuita en Papo para centralizar atención, CRM y automatizaciones en un solo panel.