Con la API REST de Papo (https://papo.global/), automatizas la creación, el listado y la cancelación de mensajes programados para WhatsApp y SMS, integrando la programación de comunicaciones directamente en tus sistemas, CRM o flujos de automatización, sin necesidad de acceder manualmente al panel.
La plataforma Papo ya ofrece un área centralizada para gestionar mensajes programados, pero cuando el volumen de programaciones es alto o cuando necesitas que otro software dispare los envíos, la API es el camino. Con ella, es posible crear recordatorios, seguimientos y notificaciones de forma programática, manteniendo el mismo control que tendrías en la interfaz visual.
Resumen de las operaciones de mensajes programados vía API
| Operación | Qué hace | Cuándo usar |
|---|---|---|
| Crear programación | Programa un mensaje de WhatsApp o SMS para un contacto en una fecha y hora específicas. | Programar recordatorios de cita, seguimientos de ventas o notificaciones de cobro desde un sistema externo. |
| Listar programaciones | Devuelve todos los mensajes programados, con posibilidad de filtrar por estado (pendiente, enviado, cancelado, fallido). | Sincronizar la agenda de envíos con un panel, verificar pendientes antes de crear nuevas programaciones o auditar comunicaciones programadas. |
| Cancelar programación | Cancela un envío programado antes de la hora de disparo. | Interrumpir un mensaje que ya no es relevante, como un recordatorio de evento cancelado o un seguimiento que perdió sentido. |
Cómo funciona la integración
La API de Papo sigue el estándar REST y utiliza autenticación mediante token Bearer. Todas las operaciones de escritura (creación y cancelación) requieren la clave secreta de tu cuenta, generada en el área de desarrollador del panel. La URL base es https://app.papo.global/api/v1.
Para usar los recursos de mensajes programados:
- Genera una clave secreta en el panel de Papo (área de desarrollador/API). Guárdala en un lugar seguro: solo se muestra una vez.
- En cada solicitud, incluye el encabezado
Authorization: Bearer {tu_clave_secreta}. - Utiliza los endpoints específicos para mensajes programados, según la documentación oficial en https://papo.global/pt/docs. Allí encontrarás las rutas exactas, los parámetros obligatorios (como ID del contacto, canal, contenido, fecha/hora) y ejemplos de payload en formato JSON.
- Para listar programaciones, puedes aplicar filtros por estado, lo que permite consultar solo los envíos pendientes o ya completados.
La API refleja el comportamiento del módulo Mensajes Programados de la plataforma: las programaciones creadas vía API aparecen en el listado del panel, y cualquier cancelación realizada por la API actualiza el estado de inmediato.
Para quién está indicada esta automatización
- Desarrolladores y equipos de TI que necesitan integrar la programación de mensajes a sistemas propios, como ERP, CRM o plataformas de agendamiento de citas.
- Revendedores white label que desean ofrecer a sus clientes la posibilidad de programar envíos vía API, ampliando el valor de la solución.
- Operaciones con alto volumen de seguimientos (ventas, cobranza, confirmación de asistencia) que quieren automatizar la creación de recordatorios sin intervención manual.
- Empresas que utilizan flujos de automatización y disparan la creación de programaciones a partir de eventos en otras herramientas.
Preguntas frecuentes
¿Necesito tener el módulo de Mensajes Programados activo para usar la API?
Sí. La API opera sobre la misma funcionalidad que encuentras en el panel. Si el módulo está disponible en tu plan, los endpoints correspondientes también estarán accesibles.
¿La API permite programar mensajes con archivos adjuntos o multimedia?
La documentación oficial detalla los tipos de contenido admitidos. Actualmente, la programación vía plataforma está orientada a mensajes de texto. Consulta la referencia de la API para verificar si hay soporte para multimedia en el momento de tu integración.
¿Cómo autentico las solicitudes?
Utiliza la clave secreta de tu cuenta Papo como token Bearer en el encabezado Authorization. La clave se genera en el área de desarrollador del panel.
¿Puedo programar mensajes para varios contactos a la vez?
La API permite crear una programación por solicitud. Para varios contactos, puedes hacer llamadas secuenciales. Verifica en la documentación si existen endpoints por lotes para tu caso de uso.
¿Qué ocurre si intento cancelar un mensaje que ya se envió?
La API devolverá un error, ya que solo se pueden cancelar las programaciones con estado pendiente. Después del disparo, el mensaje ya no se puede modificar.
¿Dónde encuentro las claves de API?
En el panel de Papo, accede al área de desarrollador o a la configuración de API. La clave secreta se muestra en el momento de la creación; si se pierde, será necesario generar una nueva.
Lee también
- Cómo gestionar mensajes programados en Papo: editar, cancelar y visualizar
- Cómo usar la API de Papo para listar conversaciones y enviar mensajes programáticos
Empieza a automatizar tus programaciones ahora →
Con Papo, integras WhatsApp, CRM e IA en un solo lugar, sin costo inicial.