Skip to content
Release: Australia · Updated: 2026-03-12 · Official documentation · View source

Create bot messages

Create channel-specific bot messages.

Before you begin

Role required: admin

Procedure

  1. Navigate to All > Conversational Interfaces > Channel Integrations > Connections and select a connection.

  2. In the Provider Channel Identity tab, select a provider channel identity.

  3. Select New in the Bot Messages table.

  4. In the form, fill in the fields.

    FieldDescription
    NameName of your bot message
    ValueText displayed when a bot message is triggered
    DescriptionDescription of the bot message, such as Welcome message or Instructional message for image upload
    Message TypeDefault selection is Bot Message
    Provider Channel IdentitySelect the Provider Channel Identity
  5. Select Submit.

Parent Topic:Supported Virtual Agent and Agent Chat features for custom chat integrations

Bot message implementation

Use the bot messages API to implement channel-specific bot messages.

Bot message API

Use the following API to incorporate bot messages into your custom chat integration.

Example: Bot message implementation

function getBotMessage(providerId, inboundId, botMessageName) {
    // fetch the bot message using bot messages api
    var botMessages = sn_cs.VASystemObject.getAllBotMessages(providerId, inboundId);
    if (botMessages && botMessages[botMessageName]) {
        var botMessage = botMessages[botMessageName];
        botMessage = botMessage.trim();
        if (botMessage) {
            return botMessage;
        }
    }
}