Updates: Check the release notes for new features and product updates.

Manage locations

If the brand that an agent represents has physical locations, you can associate the locations with the agent so that can message specific locations with Business Messages. Business Messages identifies locations by Place ID.

With Place IDs, you can identify which physical location a user messages and determine the best course of action for responding the user.

You must claim ownership of physical locations through Google My Business before you can associate locations with a Business Messages agent.

Managing multiple locations

When you verify a location, Business Messages automatically identifies all other associated locations, creates brand locations for them, associates them with the same agent, and marks the locations as verified.

To view locations associated with your agent,

  1. Open the Business Communications Developer Console and sign in with your Business Messages Google account.
  2. Choose your agent.
  3. Click Locations in the left navigation.

Create a location

To add a location to an agent,

  1. Open the Business Communications Developer Console and sign in with your Business Messages Google account.
  2. Choose your agent.
  3. Click Locations in the left navigation.
  4. Click Add.
  5. Search for a location or enter a Place ID, then click Add.

Test a location

Each agent has test URLs that let you see how a conversation with that agent appears to users and gives you the opportunity to verify your messaging infrastructure.

To test an agent,

  1. Open the Business Communications Developer Console and sign in with your Business Messages Google account.
  2. Choose your agent.
  3. Click Locations in the left navigation.
  4. Find the location in the list.
  5. Under Test URLs, click the Android button or iOS button to copy the test URL to your device's clipboard.
  6. To open the agent's test URL, use the Business Messages Agent Launcher on a mobile device. Copying and pasting or otherwise manually navigating to a test URL doesn't work because of browser security measures.

Update a location

You can add and delete locations for an agent with the Business Communications Developer Console.

To change a location's messaging availability, conversational settings, ro localization settings, use the Business Communications API to update the location.

Delete a location

When you delete an agent, Business Messages deletes all location data. Business Messages doesn't delete messages sent by your agent related to the location that are in transit to or stored on a user's device. Messages to users aren't location data.

Delete requests fail if you've attempted to verify the location one or more times. To delete a location that you've verified or attempted to verify, contact us. (You must first sign in with a Business Messages Google account. To register for an account, see Register with Business Messages.)

To delete a location,

  1. Open the Business Communications Developer Console and sign in with your Business Messages Google account.
  2. Choose your agent.
  3. Click Locations in the left navigation.
  4. Find the location in the list.
  5. Click the location's checkbox, the click Delete.
  6. Click Delete.

Next steps

Now that you have an agent with locations, you can use the location's test URL to verify your infrastructure's end-to-end messaging flow.