Esta guía explica cómo configurar la función Solicitud de Geolocalización por WhatsApp en Urbantz. Esta función permite al sistema solicitar automáticamente la ubicación precisa de un destinatario a través de WhatsApp cuando la dirección de entrega de la tarea no puede geocodificarse con suficiente precisión.
¿Cuándo se activa esta función?
Importante: La solicitud de geolocalización no se envía para cada tarea. Solo se activa cuando el sistema detecta que la dirección de entrega de la tarea no está geocodificada con suficiente precisión.
Cuando se cumple esta condición, el sistema inicia automáticamente una conversación de WhatsApp con el destinatario para recopilar su ubicación precisa.
Solo WhatsApp, Sin Alternativa
A diferencia de las notificaciones estándar a destinatarios (consulte la Documentación de la función WhatsApp), la solicitud de geolocalización no admite alternativa por SMS. El sistema intentará contactar al destinatario exclusivamente a través de WhatsApp. Si el destinatario no tiene WhatsApp en el número de teléfono asociado a la tarea, la solicitud simplemente no se entregará.
Esta limitación existe porque la función se basa en la capacidad de compartir ubicación interactiva de WhatsApp, que no está disponible en SMS.
Una Conversación en 3 Pasos. ¿Por qué?
La API de WhatsApp de Meta no permite a las empresas enviar solicitudes de ubicación interactivas directamente a los destinatarios sin una conversación activa. No es posible enviar un mensaje de plantilla con un botón "Compartir tu ubicación" sin más.
Para solucionar esto, la función utiliza una conversación en 3 pasos:
Iniciar la conversación enviando un mensaje de plantilla con un botón "Continuar"
Una vez que el destinatario hace clic en el botón, se abre una ventana de conversación de 24 horas, lo que nos permite enviar una solicitud de ubicación interactiva. Cuando el destinatario comparte su ubicación, la dirección de la tarea se actualiza con las coordenadas recibidas.
Enviar un mensaje de agradecimiento para confirmar que se recibió la ubicación
Paso
Acción del sistema
Acción del destinatario
Resultado
1. Inicio
Envía un mensaje de plantilla explicando la situación, con un botón "Continuar"
Pulsa "Continuar"
Abre una ventana de conversación de 24h
2. Solicitud de Ubicación
Envía un mensaje de solicitud de ubicación interactiva
Pulsa "Compartir Ubicación", selecciona o ajusta el marcador, confirma
Ubicación recibida, dirección de la tarea actualizada
3. Agradecimiento
Envía un mensaje de confirmación/agradecimiento
—
Conversación cerrada
Coste
Solo el Paso 1 (el mensaje de plantilla) se factura como conversación iniciada por la empresa. Los pasos 2 y 3 se envían dentro de la ventana de 24 horas abierta por el clic del destinatario en el botón, lo que los hace gratuitos.
Requisitos previos
Antes de configurar las solicitudes de geolocalización, asegúrese de que:
Esté familiarizado con la creación de plantillas de mensajes en Meta Business Suite
Paso 1: Crear Plantillas en Meta Business Suite
Necesita crear 3 plantillas de mensajes en su cuenta de WhatsApp Business. Cada plantilla corresponde a un paso específico de la conversación.
Recordatorio: Para compatibilidad con varios idiomas, utilice siempre el mismo nombre de plantilla exacto para todas las versiones en distintos idiomas. Solo el ajuste de idioma y el contenido deben diferir. Urbantz selecciona automáticamente el idioma correcto según el idioma preferido del destinatario.
Plantilla 1: Inicio de la Conversación
Este es el primer mensaje que recibirá el destinatario. Introduce el contexto (la entrega) e invita al destinatario a interactuar haciendo clic en un botón.
Configuración en Meta Business Suite:
Ajuste
Valor
Categoría
Utility
Nombre
p. ej., confirm_delivery_location_init
Idioma(s)
Una versión por cada idioma que admita
Cuerpo
Un mensaje breve y amigable explicando que necesita ayuda para confirmar la dirección de entrega
Botones
Añada un botón de Quick Reply con la etiqueta "Continuar" (o su equivalente en el idioma correspondiente)
Ejemplo de texto del cuerpo:
Hola {{recipient}} !
Estamos preparando su entrega de {{sender}}.
Para asegurarnos de que todo vaya bien, ¿podría confirmar algunos detalles con nosotros?
Plantilla 2: Solicitud de Ubicación
Esta plantilla proporciona el texto del cuerpo para el mensaje de solicitud de ubicación. Solo necesita redactar el texto pidiendo al destinatario que comparta su ubicación. El botón "Compartir Ubicación" es añadido automáticamente por Urbantz cuando se envía este mensaje. No necesita definir este botón en el editor de plantillas de Meta, ni tampoco necesita configurarlo en Urbantz. Es completamente automático al utilizar el trigger TASK_LOCATION_REQUEST_ASK.
Configuración en Meta Business Suite:
Ajuste
Valor
Categoría
Utility
Nombre
p. ej., confirm_delivery_location_ask
Idioma(s)
Una versión por cada idioma que admita
Cuerpo
Un mensaje pidiendo al destinatario que comparta su ubicación de entrega
Botones
Ninguno (el botón "Compartir Ubicación" es añadido automáticamente más adelante por Urbantz)
Ejemplo de texto del cuerpo:
Por favor, comparta la ubicación donde desea recibir su entrega. Pulse el botón de abajo para enviar su ubicación.
Plantilla 3: Confirmación / Agradecimiento
Este mensaje se envía después de que el destinatario comparte su ubicación. Confirma que se ha recibido la ubicación y que la dirección de entrega ha sido actualizada.
Configuración en Meta Business Suite:
Ajuste
Valor
Categoría
Utility
Nombre
p. ej., confirm_delivery_location_thanks
Idioma(s)
Una versión por cada idioma que admita
Cuerpo
Un breve mensaje de confirmación y agradecimiento
Botones
Ninguno
Ejemplo de texto del cuerpo:
¡Gracias! Hemos actualizado su dirección de entrega con la ubicación que compartió. Su paquete será entregado en el lugar correcto.
Paso 2: Configurar Notificaciones en Urbantz
Una vez que sus plantillas estén aprobadas en Meta, debe crear 3 configuraciones de notificación en Urbantz, una para cada paso de la conversación.
Desde su plataforma, vaya a Administración > Plataforma > Mensajería
Cree las siguientes 3 notificaciones:
Notificación 1: Inicio de la Conversación
Ajuste
Valor
Nombre
p. ej., "Geo - Location Request Init"
Trigger
"Pedir al consumidor que inicie una conversación sobre la ubicación de entrega de la tarea"
Modo de Envío
WhatsApp
En la pestaña Contenido:
Ajuste
Valor
Plantilla
Seleccione su plantilla confirm_delivery_location_init (o el nombre que eligió anteriormente)
Idioma Predeterminado
Seleccione su idioma predeterminado
Mapeo de Variables
Asigne las variables de la plantilla a los campos de Urbantz (p. ej., {{address}} → dirección de la tarea)
Notificación 2: Solicitud de Ubicación
Ajuste
Valor
Nombre
p. ej., "Geo - Location Request Ask"
Trigger
"Pedir al consumidor la ubicación de entrega de la tarea"
Modo de Envío
WhatsApp
En la pestaña Contenido:
Ajuste
Valor
Plantilla
Seleccione su plantilla confirm_delivery_location_ask (o el nombre que eligió anteriormente)
Idioma Predeterminado
Seleccione su idioma predeterminado
Nota: No necesita configurar el botón "Compartir Ubicación". Urbantz lo añade automáticamente cuando se utiliza este trigger.
Notificación 3: Agradecimiento
Ajuste
Valor
Nombre
p. ej., "Geo - Location Request Thanks"
Trigger
"Notificar al consumidor cuando se complete la solicitud de ubicación de la tarea"
Modo de Envío
WhatsApp
En la pestaña Contenido:
Ajuste
Valor
Plantilla
Seleccione su plantilla confirm_delivery_location_thanks (o el nombre que eligió anteriormente)
Idioma Predeterminado
Seleccione su idioma predeterminado
Importante: NO Configure Notificaciones de Respaldo
NO cree notificaciones de respaldo por SMS o correo electrónico para estos triggers.
A diferencia de las notificaciones estándar de WhatsApp donde puede configurar una alternativa por SMS (consulte la documentación principal, paso 6), la solicitud de geolocalización es exclusiva de WhatsApp.
Si el destinatario no tiene WhatsApp:
El mensaje inicial no podrá entregarse
No se intentará ninguna alternativa
La dirección de la tarea permanecerá tal como está (puede ser necesaria una intervención manual)
Monitoreo
Monitoreo a Nivel de Tarea
Abra el menú Tareas en su plataforma
Seleccione la tarea correspondiente
Abra la Pestaña Notificaciones para ver los intentos de notificación de cada paso de la conversación (hasta 3 entradas)
Abra la Pestaña Historial para ver el registro de actividad de la tarea, incluida la actualización de la dirección/GPS resultante del intercambio de ubicación del destinatario
Monitoreo a Nivel de Plataforma
Vaya a Administración > Monitor del Sistema y seleccione la Pestaña Notificaciones. Esta vista muestra las entregas fallidas en toda la plataforma, lo que resulta útil para identificar destinatarios que no pudieron ser contactados (p. ej., porque no tienen WhatsApp).
Referencia: Triggers de Notificación
Trigger (etiqueta de la interfaz)
Paso
Descripción
"Pedir al consumidor que inicie una conversación sobre la ubicación de entrega de la tarea"
1
Mensaje de plantilla con botón "Continuar"
"Pedir al consumidor la ubicación de entrega de la tarea"
2
Mensaje de solicitud de ubicación interactiva (con botón automático "Compartir Ubicación")
"Notificar al consumidor cuando se complete la solicitud de ubicación de la tarea"
3
Mensaje de agradecimiento / confirmación
Preguntas Frecuentes
¿Qué ocurre si el destinatario no hace clic en "Continuar"?
La conversación permanece abierta pero no se envían más mensajes. El destinatario puede hacer clic en el botón en cualquier momento. Si nunca responde, la dirección de la tarea permanece sin cambios.
¿Puede el destinatario compartir una ubicación diferente a su posición actual?
Sí, tanto en Android como en iOS. Sin embargo, la experiencia es significativamente mejor en Android, donde el marcador puede arrastrarse libremente. En iOS, descubrir cómo ajustar la ubicación no es intuitivo (requiere deslizar hacia abajo un panel sin ninguna indicación visual).
¿Qué ocurre si el destinatario no tiene WhatsApp?
La solicitud de geolocalización no será entregada. No se intentará ninguna alternativa por SMS o correo electrónico. La dirección de la tarea permanece sin cambios y puede requerir corrección manual.
¿Supone algún problema la ventana de 24 horas?
En la práctica, no. La ventana de 24 horas comienza cuando el destinatario hace clic en "Continuar". Cada interacción posterior del destinatario (como compartir su ubicación) restablece la ventana por otras 24 horas. Dado que Urbantz responde inmediatamente tras cada acción del destinatario, el sistema siempre se encuentra dentro de la ventana activa. Incluso si el destinatario tarda algún tiempo entre pasos, cada interacción extiende la ventana.
¿Puedo usar variables en el cuerpo de la plantilla?
Sí, para la Plantilla 1 (inicio) puede utilizar variables con nombre (p. ej., {{address}} para la dirección de la tarea, {{reference}} para un número de referencia) y asignarlas en Urbantz. Tenga en cuenta que Urbantz requiere variables con nombre (no numeradas como {{1}}). Las plantillas 2 y 3 normalmente no necesitan variables dinámicas, pero pueden incluirlas si se desea.
Comentarios
0 comentarios
Inicie sesión para dejar un comentario.