Con la API REST de Papo, puedes listar, buscar, crear, actualizar y vincular contactos a Empresas del CRM — todo mediante solicitudes autenticadas, sin abrir el panel. Es la forma programática de mantener la gestión de clientes B2B sincronizada con sistemas externos, ERPs, CRMs o herramientas de automatización.
La API de Papo expone recursos del módulo Empresas para que tu operación organice cuentas B2B, consolide contactos vinculados y haga seguimiento de las conversaciones recientes de cada empresa. Con autenticación por clave secreta y respuestas en JSON, estos endpoints permiten integrar la visión de cuentas a scripts, automatizaciones y revendedores white label.
Resumen de las operaciones de Empresas vía API
| Operación | Qué hace | Cuándo usar |
|---|---|---|
| Listar empresas | Devuelve las empresas registradas en el CRM con nombre, dominio y número de contactos. | Auditar la base de cuentas o sincronizar empresas con otro sistema. |
| Buscar por nombre o dominio | Localiza empresas específicas en el CRM. | Encontrar la cuenta B2B antes de actualizar datos o vincular contactos. |
| Detallar empresa | Devuelve los datos de una empresa por el identificador. | Consultar una cuenta específica durante una integración. |
| Crear empresa | Crea una nueva empresa; el nombre es obligatorio, mientras que el dominio y la descripción son opcionales. | Registrar cuentas B2B automáticamente desde un ERP, sitio web o flujo externo. |
| Actualizar empresa | Actualiza nombre, dominio y descripción de una empresa existente. | Mantener el CRM siempre alineado con la base de clientes B2B. |
| Vincular contacto | Vincula un contacto existente del CRM a una empresa. | Consolidar la relación y el historial entre contactos y cuentas. |
| Listar contactos y conversaciones | Trae los contactos vinculados a la empresa y las conversaciones recientes de esos contactos. | Tener la visión completa de la cuenta durante la atención o el seguimiento. |
Cómo funciona la autenticación de la API
Todas las rutas de escritura, incluidas las operaciones de Empresas, requieren la clave secreta de la cuenta. Debe enviarse como token Bearer. La clave pública de la cuenta es opcional, pero, si se envía, debe corresponder a la misma cuenta de la clave secreta.
La URL base de la API es https://app.papo.global/api/v1. Las claves se generan en el área de desarrollador del panel de Papo. La clave secreta aparece una única vez en la creación; guárdala en un lugar seguro y revócala si sospechas de una filtración.
Como la API es REST y utiliza JSON, cualquier lenguaje con soporte HTTP puede usarse para integrar Empresas a scripts, ERPs, CRMs o herramientas de automatización. La documentación oficial en https://papo.global/pt/docs trae los detalles de autenticación, parámetros, respuestas y ejemplos de código.
Cómo gestionar Empresas por la API en la práctica
- Accede al área de desarrollador del panel de Papo y genera una clave secreta. Copia también la clave pública de la cuenta.
- En cada solicitud, autentícate con la clave secreta como token Bearer. Si quieres reforzar la validación, envía la clave pública en el encabezado indicado en la documentación.
- Para listar las empresas del CRM, llama al endpoint de listado de Empresas. La respuesta trae nombre, dominio y número de contactos de cada cuenta.
- Para localizar una empresa específica, usa el endpoint de búsqueda por nombre o dominio. Así obtienes el identificador necesario para actualizar datos o vincular contactos.
- Para crear una empresa, envía un payload JSON con el nombre obligatorio. Dominio y descripción pueden incluirse como datos opcionales.
- Para actualizar una empresa, envía los nuevos valores de nombre, dominio o descripción en el endpoint de actualización.
- Para vincular un contacto existente, usa el identificador del contacto y el identificador de la empresa en la operación de vínculo.
Como la API procesa una operación por solicitud, la gestión masiva se realiza ejecutando llamadas en secuencia. Un script en Python, Node.js o una automatización en herramientas como n8n puede leer cuentas de un CSV o ERP, registrar empresas, vincular contactos y recopilar las respuestas para el tratamiento de errores.
Para quién tiene sentido esta integración
- Empresas B2B que mantienen cuentas en otro CRM o ERP y quieren sincronizar automáticamente con el módulo Empresas de Papo.
- Equipos comerciales que trabajan con clientes de cuenta, como agencias, consultorías, SaaS y proveedores, y necesitan consolidar contactos y conversaciones por empresa.
- Operaciones que captan empresas en formularios, landing pages o sistemas externos y desean crearlas en el CRM sin retrabajo manual.
- Revendedores white label e integradores que conectan Papo a sistemas de clientes y quieren mantener la gestión de cuentas consistente entre diferentes entornos.
- Equipos de TI que construyen integraciones personalizadas usando la API como puente entre la base de empresas y el resto de la operación.
Preguntas frecuentes
¿Necesito crear el contacto antes de vincularlo a una Empresa?
Sí. La API vincula un contacto que ya existe en el CRM. Para registrar un contacto nuevo, usa los endpoints de creación de contactos y luego haz el vínculo con la empresa.
¿Qué datos puedo actualizar en una Empresa vía API?
Es posible actualizar nombre, dominio y descripción de la empresa. La creación exige el nombre; dominio y descripción son opcionales.
¿La API permite listar las conversaciones de una Empresa?
Sí. El módulo Empresas permite listar los contactos vinculados a una empresa y las conversaciones recientes de esos contactos, facilitando la visión de cuenta durante la atención.
¿La autenticación es la misma que se usa en los otros endpoints de Papo?
Sí. Las rutas de escritura requieren la clave secreta de la cuenta, enviada como token Bearer. La clave pública es opcional y, si se envía, debe corresponder a la misma cuenta.
¿Dónde encuentro las rutas exactas y el formato del payload?
En la documentación oficial de la API, disponible en https://papo.global/pt/docs. Allí están los detalles de autenticación, parámetros, respuestas y ejemplos de código para Empresas y demás recursos.
¿Puedo usar la API para sincronizar la base de Empresas con mi CRM actual?
Sí. Como la API es REST y utiliza JSON, puedes automatizar el listado, la creación, la actualización y el vínculo de contactos en secuencia, manteniendo los dos sistemas alineados.
Lea también
- Cómo usar el módulo de Empresas en el CRM de Papo
- Cómo usar la API de Papo para gestionar atributos personalizados de los contactos
Comienza gratis y gestiona Empresas en el CRM vía API →
El primer usuario de Papo es gratuito para siempre, sin tarjeta.