Chatbot Integration Settings
The integration settings page of your chatbot allows you to change or review many global aspects of your chatbot. Additional integrations are available as actions on your chatbot flow.
API Token
This code represent your chatbot API Token. Depending on the different outside integrations you will use you may need it to call specific Xenioo API related to your chatbot.
API Secret
This code is the API Secret used in various real time integrations meant to directly access data of your Account or Chatbot.
Events Webhook URL
In the Events Webhook field you can specify a webhook url that will receive all of the messages that are sent and received by Xenioo for the current chatbot as well as different events you can enable or disable at will.
When the Webhook is activated, Xenioo will automatically send any of the selected events generated by your chatbot every 20 seconds.
The Events Webhook is not intended as a real-time communication API relay as the average interval for events signal is 20 seconds. This means that all events happened in a conversation will be grouped and sent to your hook with a 20 seconds delay. If you are looking to build an alternate view based on real-time conversation events please refer to our Custom Channel solution
The Webhook payload is always an array of items similar to the example below:
Each array entry can have the following fields:
Message type can have one of the following values:
The expected Webhook reply must be a standard HTTP 200 OK. The reply body can be empty.
If your Webhook fails to correctly reply or is unreachable for more than 10 times Xenioo will stop any further call and alert your account. To re-enable the Webhook simply save again the chatbot settings.
A failing Webhook will also trigger an alert email to the account email directly related to the chatbot.
Each message sent to your chatbot by a user or delivered by your chatbot to any user will be queued and delivered to your hook at a latency of maximum 20 seconds.
This feature is used on your bots as long as you have an active paid subscription. Each call to your hook will count as an additional outgoing message. Xenioo will consider one single outgoing message regardless of the amount of in and out messages sent to the hook in each single push. So for example if a hook call contains 30 messages that will still count as only one additional outgoing message.
The specified Webhook is ignored if your bot is running under a free plan.
Last updated