Con Papo (https://papo.global/), puede usar la API REST para enviar plantillas de mensaje aprobadas (HSM) en WhatsApp, automatizando notificaciones transaccionales y campañas sin acceder a la interfaz. La API permite listar las bandejas de entrada Cloud API de su cuenta, recuperar las plantillas aprobadas por Meta y enviarlas a uno o varios contactos, siempre que tenga un token de API y las plantillas estén sincronizadas en la plataforma.
| Acción de la API | Qué hace | Ejemplo de uso |
|---|---|---|
| Listar bandejas de WhatsApp | Devuelve las bandejas de entrada WhatsApp Cloud API asociadas a la cuenta | Seleccionar la bandeja correcta antes del envío |
| Listar plantillas aprobadas | Devuelve las plantillas de mensaje (HSM) con estado “aprobado” para un inbox determinado | Verificar los HSM disponibles para envío |
| Enviar HSM a un contacto | Envía una plantilla aprobada a un único número de teléfono, completando las variables | Notificación de pedido, recordatorio de cita |
| Enviar HSM a varios contactos | Envía la misma plantilla a una lista de contactos de una sola vez | Campaña de marketing, comunicado masivo |
Cómo funciona el envío de HSM a través de la API
La API de Papo refleja las funcionalidades de la plataforma. Para enviar una plantilla de mensaje de WhatsApp, no necesita crear nada nuevo mediante código: las plantillas se crean y se envían directamente en el Administrador de Negocios de Meta y, una vez aprobadas, aparecen automáticamente en su cuenta de Papo. La API solo consulta la lista de plantillas aprobadas y realiza el envío.
El flujo típico de integración consiste en:
- Generar un token de API en el panel de Papo.
- Identificar la bandeja de entrada de WhatsApp Cloud API donde se sincronizó la plantilla.
- Obtener la lista de plantillas aprobadas (HSM) de esa bandeja.
- Preparar la solicitud con los parámetros necesarios: ID de la plantilla, idioma, número del destinatario con código de país y los valores de las variables (si la plantilla contiene
{{1}},{{2}}, etc.). - Enviar la solicitud — ya sea para un único contacto o para un conjunto de números, cada uno con sus respectivas variables personalizadas.
Paso a paso para utilizar la API
1. Genere un token de API
En el menú de configuración de su cuenta de Papo, acceda a la sección de API o tokens de acceso. Cree un token con los permisos necesarios para gestionar conversaciones y mensajes. Guarde el token en un lugar seguro; se enviará en el encabezado de todas las solicitudes.
2. Liste las bandejas de WhatsApp disponibles
Antes de enviar cualquier plantilla, necesita saber qué bandeja de entrada (inbox) contiene las plantillas aprobadas. Utilice el endpoint que devuelve las bandejas de WhatsApp Cloud API de su cuenta. Anote el identificador de la bandeja que pretende usar — será obligatorio en los pasos siguientes.
3. Consulte las plantillas aprobadas (HSM)
Con el identificador de la bandeja en mano, llame al endpoint que lista las plantillas con estado APPROVED. La respuesta traerá para cada plantilla el nombre, el idioma disponible, la categoría (Marketing, Utilidad o Autenticación) y los parámetros esperados. Este paso es importante para confirmar que la plantilla está habilitada y para saber qué variables completar.
4. Arme la solicitud de envío
La operación de envío para un único contacto requiere básicamente:
- El ID de la plantilla (o el nombre, dependiendo de la implementación).
- El idioma de la plantilla (por ejemplo,
pt_BR). - El número de teléfono del contacto, incluyendo el código de país (ej.:
5511999999999). - Un objeto con los valores de las variables, si la plantilla contiene placeholders.
Para envío en lote (múltiples contactos), la llamada acepta una lista de destinatarios, cada uno con su número y, opcionalmente, sus propias variables. La plantilla es la misma para todos.
5. Dispárelo y verifique la respuesta
La API devuelve una confirmación síncrona de que la solicitud de envío fue aceptada. Para monitorear el estado real de entrega (entregado, leído, fallido), puede configurar un webhook de salida (outbound) — Papo notifica en tiempo real los eventos de la conversación. El artículo sobre recepción de eventos en tiempo real (listado en “Lea también”) explica cómo activar este recurso.
Quién debe usar la API para el envío de HSM
Cualquier negocio que quiera automatizar comunicaciones transaccionales desde sistemas externos se beneficia de la API. En lugar de depender de la interfaz de Papo para cada notificación, puede integrar el envío directamente en su ERP, CRM o plataforma de comercio electrónico. Ejemplos comunes:
- Confirmación de compra o actualización del estado del pedido.
- Recordatorio de consulta o cita enviado 24 horas antes.
- Cobro de factura vencida con el enlace de pago.
- Comunicación de cambio de vuelo o reserva.
La API es especialmente útil cuando la regla que determina cuándo enviar la plantilla reside en otro software — por ejemplo, un sistema de logística que dispara la notificación de entrega tan pronto como el paquete sale para transporte.
Preguntas frecuentes
¿La API de Papo tiene costo adicional?
La API está disponible en los planes de Papo. Puede generar tokens y usar los endpoints según el plan contratado. Los detalles de límites y tarifas por solicitud están en la página de planes y en la documentación de la API.
¿Necesito crear las plantillas de mensaje a través de la API?
No. Las plantillas deben crearse y enviarse para aprobación en el Administrador de Negocios de Meta. Una vez aprobadas, se sincronizan automáticamente en Papo y aparecen en el listado de plantillas de la API.
¿Puedo enviar HSM a números que no están en el CRM de Papo?
Sí. El destinatario no necesita estar previamente registrado en el CRM de la plataforma. Basta con informar el número de WhatsApp (con código de país y código de área) en la solicitud. Sin embargo, debe tener el consentimiento (opt-in) del cliente para recibir la comunicación, especialmente si la plantilla es de la categoría Marketing.
¿Cómo sé si el mensaje fue entregado?
La respuesta inmediata de la API confirma que la solicitud fue aceptada y enviada a WhatsApp. Para monitorear fallos, entregas y lecturas en tiempo real, es necesario activar el webhook de eventos (outbound) de Papo. Consulte la guía de webhooks en el centro de ayuda.
¿Existe un límite de velocidad para los envíos a través de la API?
Sí. Papo aplica límites de tasa para proteger la estabilidad del servicio y respetar las políticas de WhatsApp. Se recomienda mantener velocidades moderadas — evitar picos repentinos ayuda a preservar la salud del número. Los valores exactos están en la documentación de la API.
¿Puedo usar la API para campañas de marketing masivas?
Sí, siempre que utilice exclusivamente plantillas aprobadas de categoría Marketing y tenga opt-in explícito de los destinatarios. Enviar mensajes no deseados puede generar denuncias y poner su número en riesgo de bloqueo. Planifique los envíos con control de cadencia y respete siempre las políticas de WhatsApp.
Lea también
- Cómo recibir eventos en tiempo real de Papo vía Webhook (outbound)
- Cómo usar la API de Papo para crear y actualizar contactos en masa
Comience a automatizar sus envíos de HSM ahora – prueba gratis → Cree su cuenta en Papo y envíe plantillas de mensaje aprobadas sin costo en el primer usuario.