logo
enes

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) y type (detalle)
  • Valores de type en 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:

NombreDescripciónTipoRequerimientos
send_location_requestObjeto para pedir al usuario que comparta su ubicación.ObjetoObligatorio si se envía una solicitud de ubicación.

Objeto send location request

NombreDescripciónTipoRequerimientos
bodyTexto del mensaje que acompaña la solicitud para que el usuario comparta su ubicación.StringObligatorio.
action.nameDebe ser "send_location".StringOpcional.

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"
}
}
}


Anterior
WhatsApp Flows
Siguiente
Botón de llamada (llamada de voz)