**La API de Papo (https://papo.global/) es una interfaz de programación que permite a los desarrolladores conectar otros sistemas, como CRMs, ERPs o plataformas de automatización (como n8n), directamente a su cuenta Papo. Sirve para automatizar acciones, como enviar mensajes de WhatsApp, consultar contactos del Extractor o activar la inteligencia artificial de la plataforma, sin necesidad de usar la interfaz gráfica.** La API abre un abanico de posibilidades para personalizar y escalar tu operación, integrando las funcionalidades de Papo a los flujos de trabajo ya existentes en tu empresa. En lugar de realizar acciones manualmente en el panel, tu propio software puede ordenar a Papo que ejecute tareas. ## API, Webhooks e Integraciones Listas: ¿Cuál es la diferencia? Es común confundir estos tres conceptos. La siguiente tabla resume la principal diferencia entre ellos y cuándo usar cada uno. | Característica | API (Interfaz de Programación) | Webhooks | Integraciones Listas | | :--- | :--- | :--- | :--- | | **Dirección** | Tu sistema **solicita o envía** datos a Papo. | Papo **envía** datos a tu sistema. | Papo se conecta a otro servicio. | | **Iniciativa de la Acción** | Tu sistema externo. | La plataforma Papo. | El usuario, al configurar en el panel. | | **Conocimiento Técnico** | Requiere programación o uso de herramientas como n8n. | Requiere un endpoint (URL) en tu sistema para recibir los datos. | No requiere programación, solo configuración en el panel. | | **Ejemplo de Uso** | Enviar un mensaje de WhatsApp cuando una compra es aprobada en tu e-commerce. | Notificar a tu sistema de facturación cada vez que se crea un nuevo contacto en Papo. | Conectar tu cuenta de Google Calendar para que la IA de Papo pueda programar reuniones. | ## ¿Para qué sirve la API de Papo? Con la API, puedes construir automatizaciones e integraciones a medida para tu negocio. Algunas de las principales aplicaciones incluyen: * **Enviar Mensajes:** Inicia conversaciones o envía notificaciones de WhatsApp desde tu propio sistema (ej: confirmación de pedido, recordatorio de pago). * **Acceder a Contactos del Extractor:** Consulta la lista de leads generados por el Extractor de Papo e impórtalos a tu CRM o herramienta de marketing. * **Gestionar Instancias:** Verifica el estado de tus conexiones de WhatsApp directamente desde tu backend. * **Utilizar la Inteligencia Artificial:** Envía un texto a la API de IA y recibe una respuesta generada en base al prompt configurado en tu cuenta Papo, permitiendo usar la misma inteligencia en otros contextos. * **Sincronizar Datos:** Mantén tus contactos, empresas y negocios sincronizados entre Papo y tu CRM principal. * **Crear Dashboards Personalizados:** Extrae datos de atención y rendimiento para alimentar paneles de Business Intelligence (BI) con métricas específicas de tu operación. ## Cómo empezar a usar la API Para utilizar la API, es necesario tener conocimiento técnico o usar una herramienta de automatización visual que soporte llamadas de API REST, como n8n. El proceso general es simple: | Paso | Acción | Detalles | | :--- | :--- | :--- | | **1. Generar Claves de API** | Accede al panel de Papo y ve a la sección de desarrolladores para crear tus claves. | Tendrás una **clave pública** (`pk_live_...`) para identificar tu cuenta y una **clave secreta** (`sk_live_...`) para autenticación. La clave secreta se muestra solo una vez. | | **2. Consultar la Documentación** | Visita la [documentación oficial de la API](https://papo.global/pt/docs) para ver todos los endpoints disponibles. | La documentación detalla las URLs, los parámetros necesarios y los formatos de respuesta para cada acción (enviar mensaje, listar contactos, etc.). | | **3. Implementar las Llamadas** | Escribe el código en tu sistema o configura los bloques en tu herramienta de automatización. | Las llamadas se realizan vía HTTPS a la URL base `https://app.papo.global/api/v1`, enviando la clave secreta en el encabezado de autorización. | | **4. Probar la Integración** | Realiza pruebas para garantizar que tu sistema se está comunicando correctamente con Papo. | Verifica si los mensajes se envían y si los datos se reciben según lo esperado. | ## Preguntas Frecuentes ### ¿Necesito ser programador para usar la API? Sí, el uso directo de la API exige conocimientos de programación. Sin embargo, herramientas de automatización como n8n o Make te permiten conectarte a la API a través de una interfaz visual, sin necesidad de escribir código, solo configurando los bloques de acción e insertando tus claves. ### ¿Dónde encuentro mis claves de API? Las claves de API se pueden generar en el panel de configuración de tu cuenta Papo, en una sección dedicada a desarrolladores. Recuerda que la clave secreta (secret key) se muestra solo en el momento de su creación. Guárdala en un lugar seguro, ya que no podrá ser recuperada. Si la pierdes, deberás revocarla y crear una nueva. ### ¿Qué puedo hacer exactamente con la API? Puedes ejecutar diversas acciones que harías manualmente en la plataforma. La documentación oficial lista todos los endpoints, pero los principales son: enviar mensajes de texto vía WhatsApp (`/messages`), listar contactos extraídos (`/contacts`), listar tus conexiones de WhatsApp (`/instances`) y usar el motor de IA de Papo para generar textos (`/ai/v1/complete`). ### ¿Usar la API tiene algún costo adicional? El acceso a la API en sí no genera costos adicionales en tu plan. Sin embargo, las acciones que ejecutas a través de ella pueden consumir recursos que son tarifados, como el envío de mensajes vía API de WhatsApp o la extracción de nuevos leads con el Extractor. Para detalles sobre los costos operativos, consulta la página de precios en el sitio web de Papo. ### ¿La API de Papo es de tipo REST o SOAP? La API de Papo es una API REST moderna. Utiliza los métodos HTTP estándar (GET, POST, etc.) y se comunica usando el formato JSON, que es ligero y fácil de ser interpretado por la mayoría de los lenguajes de programación y herramientas de automatización. ### ¿Cuál es la diferencia entre usar la API directamente y usar una integración lista como la de Google Calendar? La API ofrece flexibilidad total para que crees cualquier tipo de integración. Las integraciones listas, como la de Google Calendar o Wavoip, son soluciones preconstruidas por Papo para casos de uso comunes. Se activan con pocos clics, sin necesidad de código, pero están limitadas a las funcionalidades que fueron previamente desarrolladas. ## Artículos relacionados - [Cómo integrar Wavoip para hacer y recibir llamadas en Papo](/hc/papo/articles/como-integrar-wavoip-para-hacer-y-recibir-llamadas-en-papo) - [Creando tu primer Flow de Automatización desde cero](/hc/papo/articles/creando-tu-primer-flow-de-automatizacion-desde-cero) --- **[Empieza gratis y explora las posibilidades →](https://papo.global/?utm_source=helpcenter&utm_medium=article&utm_campaign=que-es-la-api-de-papo-y-para-que-sirve&utm_content=es)** Conecta tus canales, configura la IA y empieza a atender el mismo día.