SnatchBot Support

Welcome to the SnatchBot Support. You'll find comprehensive guides and documentation to help you start working with SnatchBot as quickly as possible, as well as support if you get stuck. Let's jump right in!

The community forum is not a helpdesk
Let’s put this in the front - the vast majority of people here do not work for SnatchBot.

Get Started    SNATCHBOT API

Address Extraction

Collects and localises a valid address from the input of a user.

Address Extraction interaction has been developed for a quick identifying of the addresses from the users’ responses. Also, the functionality allows you to ask users to share their location.

To create this interaction, click "Add new interaction/plugin" link from the bottom left of the screen, and then select ‘Address Extraction’ interaction type. After that, specify the interaction name, e.g. ‘Address’. Click the 'Add' button to add the item to the bot’s structure:

For a better user experience, select ‘Highlight Extracted data in chat’ checkbox:

After that, you should specify Bot’s message along with an error response:

Since Address Extraction interaction is designed to parse user messages and detect user addresses via Google Maps API, you need to enter a map API key before using this interaction:
Profile section -> Map settings tab, or:
Bot -> Configure -> Map settings tab

Click the Bot map settings or Profile map settings button to open the right tab. Next, follow the instructions in the tabs to obtain a key.

Once you have entered one or two keys, the system will automatically put them in the Google Maps API Key dropdown menu. By default, the system uses the key from the Profile -> Map Settings tab, but you can select it manually.

🚧

When using the collaboration feature, keys are hidden for bot administrators. Only the chatbot owner can see the key.

If you have not entered any key in either of these places, then you will see a triangle with an exclamation mark next to the name of the tab.
If you have not entered a "Google Maps API Key" in the “Profile -> Maps Settings”, then the system will use the key from My Bots -> Configure -> Map Setting (if there is one).
If you have entered the key only in the Profile -> Map Settings, then you will see the following message in the tab: You can add an additional Google Maps API Key in My bots -> Configure.
Also there is an information message in the “Bot message” tab: "This interaction requires Google Maps API Key. Make sure you configure it in Map Settings or My bots -> Configure -> Maps API Key.”:

👍

Bots that have a Pro Plan subscription can utilize the Address Extraction interaction without the need to input a key. For Pro bots, it is the SnatchBot system that pays for Google map requests, not the user. All other benefits granted by Pro plan subscription are mentioned here

You have the possibility to activate the Trial period from this tab. Free Trial gives you 30,000 free messages for 14 days. The trial applies to the Translation and Address extraction interactions, so you can use them freely without entering API keys.
A trial period can be activated only once in a single account.
Start trial now - activate trial period. Upon pressing, the confirmation window appears.

When testing your bot, you can see that a valid address will be highlighted or an error response will be sent to a user if the bot receives an invalid data format:

If needed, you can connect Address Extraction interaction to the other types of the interactions. Additionally, if no conditions are met, bot can go to another interaction:

Share location

This functionality allows you to ask users to share their live location.
Live location is supported in the following channels: Facebook Messenger, Skype, Line, Webchat, Line, Viber and Telegram. In Facebook Messenger and Skype users can share their location by using Attach -> Location functionality of the app.

Tick the “Allow live location?” checkbox to enable/disable “Share location” functionality. You can change the name of the button in the “Button name” field.

When the feature is enabled, your end-users will see the additional button in the chat when they go this interaction:

Upon pressing the button the system begins connecting to Google Maps and the following window appears:

“Cancel, I will enter the address manually” - stops connecting and closes the window.
Once your location is detected, you will see Google map in the window:

Watch this video tutorial ''Obtaining an address from a user with a chatbot''

Updated 6 months ago


Next Steps

Collects and specifies numeric representations of time from the input of a user, converting it in seconds with millisecond precision.

Duration Extraction

Address Extraction


Collects and localises a valid address from the input of a user.

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.