Control Conversation Transfer Action

This action will transfer the current conversation to a target chatbot inside the same account or give back the transferred conversation to the original chatbot.

Settings

The action uses the following settings:

Setting	Description	Parsed
Mode	Set the action mode to Transfer or Give Back control.	⛔
Target Bot	The name of the bot to whom the conversation will be transferred.	⛔
Behaviour	The name of the behaviour where the conversation will be redirected	⛔
Interaction	The name of the interaction where the conversation will be redirected	⛔
Conversation Key	A conversation variable name that will be used to join the current conversation with the target one on the target chatbot.	✅

Remarks

This action can transfer the current conversation to another chatbot without leaving the current channel. This means that the conversation will continue on the platform being used by the current conversation on the current chatbot.

When the transfer happens, if the target chatbot is published on the same channel as the current conversation (e.g. both chatbots run on WhatsApp) then the transferred conversation will be set on the same channel. If the target chatbot is not published on the same channel as the current conversation, the first available channel on the target chatbot will be selected.

Since the conversation connection becomes a bridge from a bot to another, any execution of this action will use 3 action messages for each activation.

Using the Conversation Key parameter, Xenioo will automatically attempt to find a conversation, on the target chatbot, that has a variable named and valued identically. If found, conversation will be redirected automatically to that conversation. If no conversation is found, a new conversation will be created.

One or more variable can be transferred back and forth between target conversations so that data exchange between the two chatbots can happen automatically.

The conversation happens for the user seamlessly, with no information about the transfer. The conversation happening after the transfer is stored on the target chatbot and not on the original one. As an example, a routing chatbot may redirect to a service specific chatbot: the service specific conversation and data will be stored on the service specific chatbot conversations.

The target chatbot can, in any part of the flow, invoke the Give Back transfer control command and stop the transfer. After this, the conversation will continue on the original chatbot. If possible, Xenioo will continue execution on the original bot from the exact point where it was transferred. If no valid bookmark is found (e.g. the transfer originated from inside a button click operation) the conversation will be reset to the start of the original interaction.

While under transfer state, the target chatbot cannot transfer the conversation to any other bot. Any transfer action executed while the bot is already a transfer target will be ignored.

Trigger

This action does not have any trigger.

Variables

This action produces the following variables after being triggered:

Variable	Description
redirection_ended	Contains "true" if the redirection just ended otherwise empty.
is_redirected	Contains "true" if the current conversation comes from a redirection. Empty otherwise. This variable is available on the target conversation.
redirection_target	Contains the full name of the bot to whom the conversation has been redirected.
redirection_source	Contains the full name of the bot that activated the redirection. This variable is available on the target conversation.

Availability

Channel specific availability follows the table below:

Channel	Availability
Facebook	Fully Available.
WhatsApp	Fully Available.
Telegram	Fully Available.
Web	Fully Available.
Alexa	Fully Available.
Google Assistant	Fully Available.
Slack	Fully Available.
API	Fully Available.

This action can be used inside interactions and as child of other actions. This action requires a Redirection Package to be used on a live chatbot.