Cuando una persona comparte una ubicación en un canal de Meta directa o Twilio, talkHero conserva su latitud y longitud. Si el proveedor incluye nombre y dirección, también aparecen en la tarjeta de Bandeja. Copiar coordenadas copia ambos valores.

Sin un agente vinculado, las conversaciones nuevas quedan disponibles para el equipo humano. Con un agente básico o híbrido, una ubicación puede activar un workflow publicado. Los agentes en modo Solo IA no ejecutan estos workflows.

Workflow visual

Abre Flujos → Nuevo flujo → Configuración.
Selecciona Ubicación de WhatsApp como disparador.
Agrega los mensajes, condiciones y acciones que necesites. Un flujo híbrido también requiere una tarea de IA.
Guarda y publica la versión. El agente y el contrato deben permitir su ejecución.

Puedes utilizar estas variables:

Variable	Contenido
`{{context.inbound.location.latitude}}`	Latitud numérica
`{{context.inbound.location.longitude}}`	Longitud numérica
`{{context.inbound.location.name}}`	Nombre, si fue recibido
`{{context.inbound.location.address}}`	Dirección, si fue recibida

Por ejemplo: Recibí las coordenadas {{context.inbound.location.latitude}}, {{context.inbound.location.longitude}}.

El disparador utiliza el evento autenticado de la misma conversación. Escribir unas coordenadas como texto no activa este disparador. Los reintentos del proveedor conservan el mismo mensaje y no vuelven a ejecutar su respuesta.

API directa

Consulta GET /v1/inbound?channel_account_id={uuid} con Bearer y permiso messages:read. La clave limita la consulta a su cliente y entorno. La respuesta devuelve kind: "location" y este objeto dentro de details:

{
  "location": {
    "latitude": 4.711,
    "longitude": -74.0721,
    "name": "Sede de prueba",
    "address": "Dirección de muestra"
  }
}

El ejemplo contiene datos de prueba. El nombre y la dirección son opcionales. La latitud debe estar entre −90 y 90 y la longitud entre −180 y 180. Cero es una coordenada válida.

Para enviar una ubicación al cliente, consulta Respuestas de WhatsApp.

talkHero no calcula direcciones ni áreas de cobertura a partir de estas coordenadas. Puedes conectar una acción propia a tu workflow para consultar tu sistema de entregas o cobertura. La tarjeta no abre ni consulta mapas externos automáticamente.