Mensajes interactivos
Last update: 4 days ago by Irais Aguirre
Los mensajes interactivos ofrecen a los usuarios botones, listas y otros controles para que respondan a una empresa con mayor facilidad.
Resumen para integración
- Endpoint:
POST https://{{url}}/whatsapp-bsp-api-endpoint-ws/services/v1/messaging- Token: de mensajería, en el encabezado
Authorization: Bearer {{wa-msg-api-token}}(cómo generarlo)- Campos comunes:
from,to(teléfono o BSUID) ytype(detalle)- Respuesta: la misma para todos los mensajes (ver respuesta)
El servicio de mensajería de mensajes interactivos le permitirá:
- A sus usuarios encontrar y seleccionar de manera más sencilla lo que buscan de una empresa en WhatsApp.
- Proporcionar un formato más simple y coherente para que las personas encuentren y seleccionen lo que desean de un negocio.
Los mensajes interactivos son los siguientes:
- Flows: Mensajes que abren un WhatsApp Flow. Para crear y administrar Flows, consulta la sección Flows.
- Lista de mensajes: Mensajes que incluyen un menú de hasta 10 opciones. Este tipo de mensaje ofrece una forma más sencilla y coherente para que los usuarios realicen una selección al interactuar con una empresa.
- Botones de réplica: Mensajes que incluyen hasta 3 opciones; cada opción es un botón. Este tipo de mensaje ofrece una forma más rápida para que los usuarios realicen una selección de un menú cuando interactúan con una empresa. También pueden incluir hasta 2 botones que abren una URL.
- Llamada a la acción (URL): Mensajes con un botón que abre una URL. Permiten dirigir al usuario a un sitio web sin mostrar la URL completa en el texto del mensaje.
- Solicitud de información de contacto: Mensajes con un botón para que el usuario comparta su información de contacto con la empresa.
- Solicitud de ubicación: Mensajes con un botón que pide al usuario que comparta su ubicación.
- Botón de llamada (llamada de voz): Mensajes con un botón que permite al usuario iniciar una llamada de WhatsApp a la empresa.
- Mensajes multiproducto: Ubicado en sección C-Commerce.
- Mensajes de un solo producto: Ubicado en sección C-Commerce.
Los mensajes interactivos se pueden combinar en el mismo flujo.
Todos se envían con POST /v1/messaging; los encabezados, los campos comunes y la respuesta están en Conexión HTTP.
Estructura general
Todos los mensajes interactivos usan el campo type con el valor "interactive" y uno de los siguientes objetos:
| Nombre | Descripción | Tipo | Requerimientos |
|---|---|---|---|
| listMessages | Objeto con la lista de mensajes. Envía solo uno: listMessages, replyButtons o flow (o algún otro tipo de mensaje interactivo). | Objeto | Condicional |
| replyButtons | Objeto con los botones de réplica. Envía solo uno: listMessages, replyButtons o flow (o algún otro tipo de mensaje interactivo). | Objeto | Condicional |
| flow | Objeto con el WhatsApp Flow. Envía solo uno: listMessages, replyButtons o flow (o algún otro tipo de mensaje interactivo). | Objeto | Condicional |
| call_to_action_url | Objeto para enviar un mensaje con un botón que abre una URL. | Objeto | Obligatorio si se envía un mensaje de llamada a la acción (URL). |
| request_contact_info | Objeto para solicitar al usuario que comparta su información de contacto. | Objeto | Obligatorio si se envía una solicitud de información de contacto. |
| singleProductMessage | Mensaje de un solo producto. | Objeto | Condicional |
| multiProductMessage | Mensaje multiproducto. | Objeto | Condicional |
| send_location_request | Solicitud de ubicación al usuario. | Objeto | Condicional |
| call_permission_request | Solicitud de permiso de llamada. Consulta Permisos de llamada. | Objeto | Condicional |
| voice_call | Mensaje de botón de llamada (llamada de voz). | Objeto | Condicional |
| order_details | Mensaje de detalles de orden (Pagos Brasil). | Objeto | Condicional |
| order_status | Mensaje de estado de orden (Pagos Brasil). | Objeto | Condicional |