POST
https://api.getincloud.online/balerion/v3/messagesEnvío de mensaje interactivo tipo lista
Presenta al usuario de WhatsApp una lista de opciones para elegir, definidas como filas en el payload.
API de Mensajería
Necesitas una clave de API. Pídela a nuestro equipo de soporte o créala desde la plataforma.
POST https://api.getincloud.online/balerion/v3/messagesSi un usuario de WhatsApp ha enviado un mensaje a tu aplicación, ya sea como respuesta a una plantilla previamente enviada o iniciando la conversación, tu aplicación dispone de una ventana de 24 horas para enviar mensajes sin necesidad de usar plantillas. Estos se conocen como mensajes de sesión.
Los mensajes interactivos tipo lista permiten presentar al usuario de WhatsApp una lista de opciones para elegir. Estas opciones se definen como filas dentro del payload de la solicitud.
Parámetros del cuerpo (Whatsapp Message Request)
| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| interactive | object | No | Aplica únicamente para el tipo interactive. Define el tipo de mensaje interactivo: button para incluir botones de respuesta, list para incluir una lista interactiva. En este caso, se utiliza el valor list. |
| externalId | string | No | Identificador alfanumérico utilizado para fines de reporte. |
| callbacks | array de strings | No | URL de webhook para notificar los eventos del mensaje de WhatsApp. |
| from | string | Sí | Número de teléfono del remitente. El número proporcionado durante la configuración de la cuenta WABA se utilizará como remitente del mensaje de notificación. Solo acepta caracteres numéricos. No incluir el signo +. |
| to | string | Sí | Número de teléfono de destino del mensaje. Debe especificarse en formato E.164 (incluye + y código de país). |
| type | string | No | Tipo de mensaje que se desea enviar. En este caso, se utiliza el valor interactive. |
Valores soportados para `type`
text: envía un mensaje de texto plano.image: envía un archivo de imagen (.jpeg, .png).audio: envía un archivo de audio (.acc, .mp3, .amr, .mpeg).video: envía un archivo de video (.mp4, .3gpp).document: envía un archivo de documento (.pdf).contacts: envía información de contacto.location: envía una ubicación con latitud y longitud.interactive: envía un mensaje interactivo con botones o listas.
Respuestas
| Código | Significado |
|---|---|
| 202 Accepted | La solicitud fue aceptada correctamente para su procesamiento. El mensaje ha sido encolado para envío. |
| 400 Bad Request | La solicitud contiene errores o parámetros inválidos. |
| 401 Unauthorized | Error de autenticación. Credenciales inválidas o token expirado. |
| 410 Gone | El recurso solicitado ya no está disponible. |
| 500 Internal Server Error | Error interno del servidor al procesar la solicitud. |
¿Te sirvió esta página?