@bitbasti/chat-adapter-webex

Community Webex adapter for Chat SDK.

Installation

npm install chat @bitbasti/chat-adapter-webex

Usage

import { Chat } from "chat";
import { createWebexAdapter } from "@bitbasti/chat-adapter-webex";

const bot = new Chat({
  userName: "mybot",
  adapters: {
    webex: createWebexAdapter({
      botToken: process.env.WEBEX_BOT_TOKEN!,
      webhookSecret: process.env.WEBEX_WEBHOOK_SECRET,
    }),
  },
});

bot.onNewMention(async (thread, message) => {
  await thread.post(`Hello from Webex! You said: ${message.text}`);
});

Environment variables

Configuration

Platform setup

1. Go to the Webex Developer Portal and sign in.
2. Navigate to My Webex Apps → Create a New App → Create a Bot.
3. Fill in the bot name, username, and icon, then click Add Bot.
4. Copy the Bot Access Token — this is your WEBEX_BOT_TOKEN. Store it securely; it is only shown once.
5. Create a webhook pointing to your server:
   • Target URL: https://your-domain.com/api/webhooks/webex
   • Resource: messages | Event: created
   • Resource: attachmentActions | Event: created
   • Secret: a random string — this is your WEBEX_WEBHOOK_SECRET
6. Add the bot to a Webex space and mention it to verify the integration.

See the Webex Webhooks Guide for details on webhook registration.

Features

• Mentions and DMs
• Rich text (bold, italic, code, links) via Markdown
• Adaptive Cards (buttons, selects, radio selects, fields, sections)
• Modals (form cards with submit/close actions)
• File uploads (single file per message)
• Thread support (parentId-based threading)
• Webhook signature verification (HMAC-SHA1)

Limitations

• Reactions are not supported by Webex bot tokens — addReaction / removeReaction throw NotImplementedError
• Typing indicators are not available in the Webex Messaging API
• Only one file upload per message is supported
• Cards and file uploads cannot be combined in the same message

License

MIT