Changes a bot's operating mode. Operating modes include:
- LIVE: The normal operating mode. All events are forwarded to the Bot Server via webhooks, and the bot can take any supported action. Only one LIVE bot can be supported on a specific network/externalId at one time.
- MAINTENANCE: No events are sent via webhooks. Any customer messages that arrive while in this mode are explicitly handed off to an AGENT, so that when the bot returns from MAINTENANCE mode, the bot will not start answering conversations already in progress.
- MONITORING: All events are forwarded to the Bot Server via webhooks, however, the bot can not communicate directly with the end-user. Up to either 9 or 10 monitoring bots can be assigned to a specific network/externalId at one time, depending on if a LIVE bot is also assigned to the network/externalId.
See Bot operating modes for more information.
When processing a message from an external user, the Automation Framework automatically transfers control from BOT to AGENT when the current conversation control is undetermined or the conversation is owned by a bot, but the currently registered bot is not in LIVE mode.