About this workflow

In the event of a move, customers must change their address. This process can be automated using this AI workflow: The Google Maps API checks whether the specified address exists and then updates it in the CRM.

The user writes their new address in one sentence, e.g.:

"I would like to change my address to Karolinenstraße 9 in Hamburg."

In this case, the bot recognises the intent ‘change of address’, triggers an AI action ‘change of address’ and transfers the extracted address data to a webhook. The webhook checks the address (e.g. via Google Maps API) and either returns a complete, validated address or an error if the address is not valid. The agent then either confirms the successful change or informs the user that the address could not be changed.

‍

How it works

1. Intent recognition

A bot is configured to recognise sentences containing address changes, e.g.:

‘I would like to change my address...’

‘Please update my address to...’

When the intent is recognised, the AI agent for address changes is activated.

‍

2. AI action ‘Change of address’ with entity extraction

Structured parameters are extracted from the user input:

• street (e. g. „Karolinenstraße“)
• house_number (e.g. „9“)
• postal_code (e.g. „20357“)
• city (e.g. „Hamburg“)
• optional country (standard: „Germany“)

These parameters are sent following the stored webhook.

‍

3. Address verification

The Google Geocoding API is called with the address provided.

• If the API responds successfully, the flow continues via the ‘Success’ output.
• If an error occurs (e.g. invalid address or API error), an ‘Error’ is generated and a corresponding error message is displayed.

‍

4. Validation of data

The information will be checked for completeness.

• All required parameters are checked.
• If all parameters are present, the flow continues.
• If parameters are missing, a corresponding error message is displayed.

‍

5. Establish and update contact details

All contacts in a CRM are searched for the matching contact based on the parameters.

• Once the contact has been found, it is updated with the validated data.

‍

6. Success

If the address change is successful, the user will be notified at the end.

‍