Webex

DRUID ChatBot Portal allows you to create the bot once and deploy it in Webex.

Note:  The Webex channel does not support Hero, Choice, Thumbnail and Location steps, but supports Adaptive Cards v2. Do not use Adaptive cards v3 as they will not be rendered in Webex.

Prerequisites

  • You built and published a Druid chat bot.
  • You need to have a Webex developer account. If you have not gone an account, sign up here.
  • You need a Webex Sandbox or an admin account to Webex Control Hub. To get a Webex sandbox, follow instructions provided in Developer Sandbox documentation.
  • For DRUID on premise deployments, make sure that you provide access to/from the necessary messaging endpoints as follows:
    • Outbound webexapis.com
    Inbound DRUID.BotApp
Important!   The Webex channel does not support file download. If you upload a file, the message containing the file is not rendered on Webex.

To integrate a DRUID virtual assistant with Webex, follow these steps:

Step 1. Create a Webex bot

  1. Log in the Webex developer portal.
  2. From the menu under your avatar at the top of this page, select My Webex Apps.

  3. Click Start Building Apps. The Create a New App page appears.
  4. Click Create a Bot to start the wizard.

  5. Provide basic information about the bot: bot name, bot username, and an icon. These fields are end-user facing, so make them as descriptive as possible. Only the bot's first name will be shown when mentioned in messages, so try to avoid spaces in the bot name. The description will be shown to users if you submit your bot to the Webex App Hub.

  6. Click the Add Bot button. A non-expiring bot access token is generated for the new bot. This access token will be used to authenticate your bot with the Webex REST API. Copy the token and keep it somewhere safe, you need it to set up the webhook.

    7. Hint:   If you misplace the access token, you can always generate a new one by finding the bot in My Webex Apps and clicking Regenerate Access Token from the edit page.

Step 2. Activate Webex channel in DRUID

  1. In DRUID Chatbot Portal, select the bot you want to deploy in Webex, click the Channels tab and then Webex. The Webex channel section expands.
  2. In the Bot token field, enter the access token generated in Webex for your bot and click the Generate button.

    3. A secret is generated for Webex integration.

  3. Copy the Secret generated by DRUID and the Druid url and keep them somewhere safe.

  4. Click Publish. Wait until the Webex channel is activated.

After the channel’s activation, the following fields are available in DRUID:

  • [[ChatUser]].ChannelId = "webex"
  • [[ChatUser]].UserId - Stores an unique identifier of the Webex user account.

Step 3. Configure the webhook for your Webex bot in Webex Control Hub

  1. Go to Webex Control Hub and log in.

  2. On Management menu click Organization Settings .

  3. Scroll-down to Alerts section. In the Webhook field, enter the Druid url you copied from DRUID Portal and in the Secret token field enter the Secret generated by DRUID.

  4. Click Save.
  5. On the main menu, click Alerts center and then Manage.
  6. Click Create rule and provide the mandatory details.

  7. In the Delivery channel section, enable Webhook.

  8. Click Save.

Step 4. Talk to your bot

  1. Open your Webex client.
  2. On the main menu, click the chat icon, then the + icon at the top and select Send a direct message.
  3. In the Search field, enter the username of your Webex bot.

  4. Click Invite to Webex. You can now start chatting with the bot. A special badge is added to messages the bot sends so users know they're interacting with a bot instead of a human.