Skip to main content

​
Provider location parsing

Clawdbot normalizes shared locations from chat providers into:
  • human-readable text appended to the inbound body, and
  • structured fields in the auto-reply context payload.
Currently supported:
  • Telegram (location pins + venues + live locations)
  • WhatsApp (locationMessage + liveLocationMessage)

​
Text formatting

Locations are rendered as friendly lines without brackets:
  • Pin:
    • 📍 48.858844, 2.294351 ±12m
  • Named place:
    • 📍 Eiffel Tower — Champ de Mars, Paris (48.858844, 2.294351 ±12m)
  • Live share:
    • 🛰 Live location: 48.858844, 2.294351 ±12m
If the provider includes a caption/comment, it is appended on the next line: 
📍 48.858844, 2.294351 ±12m
Meet here

​
Context fields

When a location is present, these fields are added to ctx:
  • LocationLat (number)
  • LocationLon (number)
  • LocationAccuracy (number, meters; optional)
  • LocationName (string; optional)
  • LocationAddress (string; optional)
  • LocationSource (pin | place | live)
  • LocationIsLive (boolean)

​
Provider notes

  • Telegram: venues map to LocationName/LocationAddress; live locations use live_period.
  • WhatsApp: locationMessage.comment and liveLocationMessage.caption are appended as the caption line.