31 Oct 2025: Introducing Location Requests in Journeys

Ricardo Updated by Ricardo

Introducing Location Requests in Journeys

We're excited to announce a powerful new capability in Turn.io Journeys: native WhatsApp location requests. You can now request and collect users' locations seamlessly within your conversation flows—no typing addresses, no confusion, just one tap.

Whether you're helping someone find their nearest clinic, routing them to the closest pharmacy, or connecting them with local services, knowing where they are transforms a generic interaction into a personalized, helpful experience.

Location sharing uses WhatsApp's native interface, which means:

  • Users see the familiar WhatsApp permission prompts they already trust
  • Location sharing is always explicit and user-initiated
  • Users remain in control, and your business gets only the location data needed to deliver better service.

How to use

1. First, add a Request Location block to your journey:

2. When the user shares their location, we trigger the Send location branch. If users reply with anything else, we follow the branch at the top of the block, allowing you to deal with that scenario.

3. We return the user's location in the block's reference. Here's everything we include (assuming your block is called Location):

Data

Contents

@ref_Location

This has the user's location formatted in the way Turn Profile's expect them, perfect for when you want to save the user's location. It's also formatted in a way where you can easily share with other systems, such as Google Maps

@ref_Location.latitude

The raw latitude, for example 41.89019183

@ref_Location.longitude

The raw longitude, for example 12.49224535

Then, if the user's location is a known location on Google Maps, it can also include the following:

Data

Contents

@ref_Location.address

The user's address, for example "Piazza del Colosseo, 1, Roma, 00184, Lazio, IT"

@ref_Location.name

The name of the location, for example "Colosseum"

@ref_Location.url

The website of the location, for example "https://colosseo.it/"

This feature is also available in code blocks, using the request_location() function. You can read the developer documentation here.

Was this article helpful?

30 Oct 2025: Agents & Memory

Contact