Solicitud de ubicación
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)- Valores de
typeen esta página:"interactive"- Respuesta: la misma para todos los mensajes (ver respuesta)
Mensajes con un botón que pide al usuario que comparta su ubicación. Se envían con POST /v1/messaging; los encabezados, los campos comunes y la respuesta están en Conexión HTTP.
Solicitud de ubicación
El campo type debe ser "interactive" y el contenido del mensaje se envía en el objeto send_location_request. Consulta la estructura general de los mensajes interactivos.
Cuerpo
Campos de Solicitud de ubicación:
| Nombre | Descripción | Tipo | Requerimientos |
|---|---|---|---|
| send_location_request | Objeto para pedir al usuario que comparta su ubicación. | Objeto | Obligatorio si se envía una solicitud de ubicación. |
Objeto send location request
| Nombre | Descripción | Tipo | Requerimientos |
|---|---|---|---|
| body | Texto del mensaje que acompaña la solicitud para que el usuario comparta su ubicación. | String | Obligatorio. |
| action.name | Debe ser "send_location". | String | Opcional. |
Ejemplo
Ejemplo completo de Solicitud de ubicación (petición HTTP y cuerpo JSON):
Petición HTTP
curl -X POST 'https://{{url}}/whatsapp-bsp-api-endpoint-ws/services/v1/messaging' \-H 'Authorization: Bearer {{wa-msg-api-token}}' \-H 'Content-Type: application/json' \-d '{"from": "5215500000001","to": "5215500000002","type": "interactive","send_location_request": {"body": "Comparte tu ubicación para continuar con el servicio.","action": {"name": "send_location"}}}'
Body
{"from": "5215500000001","to": "5215500000002","type": "interactive","send_location_request": {"body": "Comparte tu ubicación para continuar con el servicio.","action": {"name": "send_location"}}}
