POST
https://getincloud.online/balerion/v3/messagesEnviar mensaje de contactos (sesión)
Comparte información de contacto enriquecida con un usuario de WhatsApp dentro de la ventana de 24 horas.
API de Mensajería
Necesitas una clave de API. Pídela a nuestro equipo de soporte o créala desde la plataforma.
Si 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 de contactos permiten enviar información de contacto enriquecida directamente a los usuarios de WhatsApp, como nombres, números de teléfono, direcciones físicas y correos electrónicos.
POST https://getincloud.online/balerion/v3/messagesParámetros del cuerpo (Whatsapp Message Request)
| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| contacts | array de objetos | No | Aplica únicamente para el tipo contacts. Arreglo que contiene la información del contacto. |
| 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. Solo acepta caracteres numéricos. No incluir el signo +. |
| to | string | Sí | Número de teléfono de destino. 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 contacts. |
Opciones de información de contacto (contacts)
addresses: direcciones completas del contacto.birthday: fecha de cumpleaños del contacto.emails: direcciones de correo electrónico del contacto.name: nombre completo del contacto formateado.org: información de la organización del contacto.phones: números de teléfono del contacto.urls: URLs del contacto.
Valores soportados de 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 | Descripción |
|---|---|
| 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?