Trigger
Starting point of the chatbot flow.
The trigger block is what determines which chatbot is to be executed when a user requests a chat.
Conditions for trigger
As you can have more than one chatbot on your account, the conditions on the trigger help the system qualify the right chatbot for the conversation.
You can also combine multiple conditions using an AND/OR operation.
The conditions on the trigger can be:
URL | The webpage URL the user is on. For example, "URL contains pricing" or "URL equals https://swiftsell.biz" |
Browser language | The default language set by the user on their browser. For example, "Language is French" |
Date range | The date when the user is initiating the chat. For example, you can build a separate chatbot flow that activates during Christmas or for a new launch announcement. |
Keyword | [Only for WhatsApp and SMS] The incoming keyword from the user that started the chat. For example, the user sent a keyword containing "Book appointment". |
Button payload | [Only for WhatsApp and SMS] When the user receives a template message from the business and clicks on a button. |
Conditions are not mandatory. If you have not defined any conditions for your chatbots, the first active chatbot on the list will be activated.
Contact subscription
Applicable only for WhatsApp and SMS.
In channels like WhatsApp and SMS, businesses can reach out to contacts at any time, even if the contact doesn't want to have a conversation.
Countries' laws mandate that companies maintain a subscription status for each contact, meaning that a contact has subscribed or unsubscribed from receiving your communication. This is similar to how unsubscription works on emails.
SUBSCRIBED - Will receive any new template message that the company sends as a promotion.
UNSUBSCRIBED - Will not receive any template message that the company sends as a promotion.
So, based on the conditions you define for the trigger, you can choose to set the subscription status for the contact.
Generally, you should always have two chatbots:
Your main chatbot, which has the 'Subscribed' status
An acknowledgment chatbot for when users type 'STOP.'
Inject data into the chatbot
If you want to send external data to the chatbot, you can use this option. Once enabled, you can map the fields that contain the value with the Swiftsell variable.
Two ways you can inject the data:
Using Query params
With this method, when the Swiftsell snippet is loaded on the website for the first time, the defined query params and their values will be stored in the WotNot variable.
For example, if your URL is the followingwww.swiftsell.biz?cust_id=1234&plan=9896
You can choose to store the values of cust_id and plan on the trigger action block.
Using JSON
With this method, you can inject a JSON payload inside Swiftsell's code snippet and map the objects to be stored in the trigger action block.
To do this you need to add the following object with your desired fields in the Swiftsell code snippet
Copy
Now, let's take an example to understand this.
Assume you are using the chatbot in your web app and already know the user initiating the chat. For your agents to know the user details, you can add their name, email, customer_id, plan, etc. to the Swiftsell code snippet.
Copy
We have stored the “name” and “phone" fields to Swiftsell variables on the trigger action block.
Note:
Swiftsell reads this object only once when the code snippet is fired. Sending data after the code snippet loads will not be read.
Dynamically add the data-session-payload object to the Swiftsell code snippet
Last updated
