In this article, we will cover how to use a link for a bot and how the link behaves in different scenarios. We will cover the following:
- How to use the URL link
- Where to find the URL link
- The behavior of the URL link
- Clearing previous conversations with mode=clear_past_conversations
How to use the URL link
The URL is a link that you can use in your browser to access a bot's communication flow. The link can be useful if you want your colleagues to test your bot, as they can go through the bot's communication flow without needing access to the bot and without needing to integrate the bot.
The link can also be useful to use in e-mail campaigns, as you can send your readers straight to the bot.
Where to find the URL link
The link can be found in all modules. To access it, you will have to open a module and click on the "Copy URL link" at the bottom of the module.
Please be aware that the URL link is specific to the module you copy it from. This means that the bot will start from the module you copy it from.
Next, you will have to press "Copy link" to the full-screen option.
This link will look something like this:
https://me.botxo.co/webchat/c756edd9-f8f9-42e6-8572-172df8854bdf/?ref=52209
At the end of the URL link, you can see the referral id, which is tied to the specific module. This link can be inserted directly into the address bar of your browser.
The behavior of the URL link
Active chats
The following table will explain how the URL link's behavior is when a chat is considered to be active. Whether a conversation is considered to be active or not is controlled by Session Expiry.
| Default load of URL link with no customization | Load of URL link to a specific module ID | URL link with mode=clear_past_conversations added | The behavior if the end user deletes cookies | |
| Will custom variables persist on a reload of the URL link? | Yes | Yes | Yes, custom variables are tied to the user and not the chat | No |
|
Are previous messages displayed? |
Yes | Yes | No | No |
|
Will the bot automatically start the conversation? |
Not when the user is returning to a chat | Yes | Yes | No |
Expired chats
The following table will explain how the URL link's behavior is when a chat is considered to be expired. Whether a conversation is considered to be active is controlled by Session Expiry.
| Default load of URL link with no customisation | Load of URL link to a specific module ID | URL link with mode=clear_past_conversations added | Will the following be remembered when the end user has cleared their cookies. | |
| Will custom variables persist on a reload of the URL link? | Yes | Yes | Yes, custom variables are tied to the user and not the chat | No |
|
Are previous messages displayed? |
Yes | Yes | No | No |
|
Will the bot automatically start the conversation? |
Yes | Yes | Yes | No |
Clearing previous conversations with mode=clear_past_conversations
Sometimes you don't want the URL link to remember past conversations when it is reloaded, and in those cases, it can be great to use mode=clear_past_conversations.
First, you will have to have the URL link, which will look something like this:
https://me.botxo.co/webchat/c756edd9-f8f9-42e6-8572-172df8854bdf/?ref=52209
At the end of URL link you should add "&mode=clear_past_conversations, so the URL looks like this:
https://me.botxo.co/webchat/c756edd9-f8f9-42e6-8572-172df8854bdf/?ref=52209&mode=clear_past_conversations
Comments
0 comments
Please sign in to leave a comment.