Con la API REST de Papo, puedes construir un endpoint en tu sitio que recibe los datos del formulario de registro y llama a la API de contactos para crear registros en el CRM automáticamente, incluyendo atributos personalizados — eliminando la digitación manual y acelerando la integración de leads.
En lugar de exportar hojas de cálculo o copiar datos entre sistemas, esta integración hace que cada nuevo registro en tu sitio se convierta en un contacto en el CRM de Papo en tiempo real. El flujo es simple: el formulario envía los datos a un backend que tú controlas, ese backend se autentica en la API de Papo y crea el contacto con nombre, correo electrónico, teléfono y cualquier campo personalizado que tu operación necesite.
Resumen de la integración
| Componente | Qué hace | Ejemplo |
|---|---|---|
| Formulario en el sitio | Recopila nombre, correo electrónico, teléfono y campos adicionales del lead. | Página de captura, landing page, checkout. |
| Endpoint intermediario | Recibe los datos del formulario y llama a la API de Papo. | Script en Node.js, Python o automatización en n8n/Zapier. |
| API de contactos de Papo | Crea el contacto en el CRM con los datos enviados. | Solicitud POST autenticada con clave secreta. |
| Atributos personalizados | Agrega campos como origen, interés o puntuación al contacto. | custom_attributes con "origem": "site", "plano_interesse": "gold". |
Cómo funciona: paso a paso
-
Genera las claves de API en el panel de Papo
Accede al área de desarrollador de tu cuenta Papo y crea una clave secreta. La clave pública de la cuenta también queda visible en esa pantalla. La clave secreta aparece una sola vez; guárdala en un lugar seguro y nunca la expongas en el frontend. -
Crea el formulario en tu sitio
Arma el formulario con los campos que deseas enviar al CRM: nombre, correo electrónico, teléfono y cualquier dato adicional (interés, origen, ciudad, etc.). El formulario debe hacer una solicitud HTTP (POST) al endpoint que construirás en el paso siguiente. -
Construye el endpoint intermediario
En tu servidor o en una función serverless (Node.js, Python, PHP, etc.), crea una ruta que reciba los datos del formulario. Ese código será responsable de:- Validar los campos recibidos.
- Armar el payload JSON para la API de Papo.
- Autenticar con la clave secreta (Bearer token) y, opcionalmente, enviar la clave pública en el encabezado
X-Papo-Public-Key. - Llamar al endpoint de creación de contactos de Papo.
-
Llama a la API de contactos de Papo
Utiliza el endpoint de creación de contactos (consulta la documentación oficial enhttps://papo.global/pt/docspara la ruta exacta y el formato del payload). Envía, como mínimo, nombre y correo electrónico o teléfono. La respuesta de la API confirmará la creación con los datos del nuevo contacto. -
Agrega atributos personalizados
Si tu cuenta tiene definiciones de atributos personalizados (como “origem”, “utm_source”, “score”), puedes enviarlos en el mismo payload o en una llamada complementaria. La API permite definir/combinarcustom_attributesen el contacto, eliminando la necesidad de completar esos campos manualmente después. -
Procesa la respuesta y devuelve al usuario
Tras la creación exitosa, tu endpoint puede redirigir al lead a una página de agradecimiento o mostrar un mensaje de éxito. En caso de error (clave inválida, datos faltantes), registra el log y devuelve un mensaje amigable.
Como la API de Papo es REST y utiliza JSON, cualquier lenguaje con soporte para HTTP puede usarse. La documentación oficial trae ejemplos en JavaScript, Python y curl, además de los detalles de autenticación y los códigos de error.
Para quién tiene sentido esta integración
- Sitios y landing pages que captan leads y quieren eliminar la transferencia manual de datos al CRM.
- E-commerces y SaaS que desean crear automáticamente un contacto en el momento del registro o de la compra.
- Agencias y consultorías que ejecutan campañas de captación y necesitan que los leads entren al CRM en tiempo real para un seguimiento inmediato.
- Revendedores white label e integradores que construyen flujos personalizados para clientes, conectando formularios de sitios a Papo sin intervención manual.
- Equipos de marketing y ventas que usan atributos personalizados para segmentación y desean que esos campos se completen automáticamente en el origen.
Preguntas frecuentes
¿Necesito conocimientos avanzados de programación para implementar esta integración?
Sí. Es necesario desarrollar un endpoint en tu servidor o utilizar herramientas de automatización (n8n, Zapier) que hagan de puente entre el formulario y la API de Papo. El código en sí es simple, pero exige nociones básicas de HTTP y manipulación de JSON.
¿Puedo usar cualquier lenguaje de programación?
Sí. La API de Papo es REST y responde en JSON. Cualquier lenguaje con soporte para solicitudes HTTP (Python, Node.js, PHP, Ruby, etc.) puede utilizarse. La documentación oficial proporciona ejemplos en JavaScript y Python.
¿Es posible crear atributos personalizados directamente en la creación del contacto?
Sí. La API de Papo permite definir los custom_attributes del contacto en el momento de la creación o actualizarlos posteriormente. Consulta la documentación para el formato exacto del payload y para verificar si las definiciones de los atributos ya existen en la cuenta.
¿Cómo garantizar la seguridad de la clave secreta?
La clave secreta nunca debe exponerse en el frontend (HTML/JavaScript público). Debe quedar solo en el servidor, en variables de entorno. Utiliza HTTPS en todas las comunicaciones y revoca la clave inmediatamente si hay sospecha de filtración.
¿Qué hacer si la API devuelve un error?
La API de Papo devuelve respuestas estandarizadas con success: false y un objeto error que contiene el código y el mensaje. Procesa esos errores en tu código: valida si se enviaron los campos obligatorios, verifica si la clave está activa y si el formato del payload es correcto. La documentación lista los principales códigos de error.
¿Puedo usar esta integración con formularios de plataformas como WordPress, Typeform o RD Station?
Sí. Puedes configurar webhooks en esas plataformas para enviar los datos del formulario a tu endpoint intermediario, que luego llamará a la API de Papo. Otra alternativa es utilizar integraciones listas vía Zapier o n8n, creando un flujo que recibe el evento del formulario y dispara la creación del contacto en Papo.
Lee también
- Cómo usar la API de Papo para gestionar Empresas en el CRM
- Cómo integrar Papo con Zapier usando API y webhooks
Crea tu cuenta gratuita en Papo y comienza a integrar formularios de registro con el CRM en minutos, sin digitación manual.