There are two types of Endpoints depending on who provides them:
- BotXO provided Endpoints to handover, takeover and keep track of the conversation.
- Third-party provided Endpoints to notify the claim of an agent, and post messages for the third-party system to also keep track of the conversation.
Third-party System Endpoints
The clients who want to integrate their systems with BotXO to automate conversations will need to create two webhooks:
- A webhook in which BotXO can notify the third party system that a user is claiming to talk with a human agent. This webhook needs to accept a POST message with a JSON Body (Currently working as it is implemented)
- A webhook in which BotXO can send the messages from the conversation between the user and the bot. This webhook is also needed when the human agent takes over the conversation in order to receive the messages from the user. (To be implemented)
(More info on how a third-party system should use these two webhooks to be added.)
BotXO Endpoints
The placeholder {botdep_id} refers to the Bot Deployment ID.
- Get chat configuration: styles, persistent menu, etc: It is working right now without access_token.
GET /webbot/api/webchat/{botdep_id}/config/
- Conversational endpoint using Websockets: It is working right now without access_token.
It is the actual conversational endpoint. This endpoint is used when the user is talking with the bot or when the human agent has taken over the conversation. The flow of messages goes through the WebSocket connection.
GET /webbot/api/webchat/{botdep_id}/
- Handover Request to tell the bot to be set to listen mode as the external agent takes control of the conversation between the bot and the user.
GET /webbot/api/webchat/{botdep_id}/handover/{user_id}/
- Endpoint for the external agent to send messages to the user directly while the bot is in listen mode.
POST /webbot/api/webchat/{botdep_id}/handover/{user_id}/
- Endpoint to takeover request to tell the bot to resume the control of the conversation in case it is needed.
GET /webbot/api/webchat/{botdep_id}/takeover/{user_id}/
- Endpoint to setup a webhook to notify the BotXO Platform that human/external intervention is required
https://me.botxo.co/bot/transfer/human/
7. Endpoint to allow an external agent to send messages of the desired module to the user and drive the conversation to that module.
POST /webbot/api/webchat/trigger-response/
Comments
0 comments
Please sign in to leave a comment.