POST
https://api.getincloud.online/balerion/v3/messagesEnvío de mensaje con botones de respuesta (Reply Button)
Envía hasta tres opciones predefinidas para que el usuario de WhatsApp seleccione una respuesta.
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 con botones de respuesta permiten enviar hasta tres opciones predefinidas para que el usuario seleccione una respuesta.
Parámetros del cuerpo (Whatsapp Message Request)
| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| interactive | object | No | Aplica únicamente para el tipo interactive. Contiene los detalles del mensaje interactivo, especificando el tipo de interacción (en este caso, botones de respuesta) y la estructura de botones, encabezado, cuerpo del mensaje y pie de página. |
| 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?