Skip to content

Webex

Overview

The Webex provider integrates with Cisco Webex Teams. It supports:

Direct messages
Space (room) messages
Adaptive Cards
File attachments
@mentions

Prerequisites

Webex account
Webex Developer access

Setup

Create a Webex Bot

Go to developer.webex.com:
- Navigate to My Webex Apps → Create a Bot
- Fill in bot details
- Copy the Bot Access Token
Create a Webhook

The provider will create webhooks automatically, or create manually:
- Go to Documentation → Webhooks API
- Create webhook pointing to your endpoint

Configure Provider

{
  "messaging-webex": {
    "enabled": true,
    "public_base_url": "https://your-domain.ngrok-free.app",
    "access_token": "your-bot-access-token"
  }
}

Run Setup

gtc setup --answers answers.json ./my-bundle

Configuration Options

Option	Required	Description
`enabled`	Yes	Enable/disable provider
`public_base_url`	Yes	Public URL for webhook
`access_token`	Yes	Bot access token

Features

Text Messages

- id: reply
  type: reply
  config:
    message: "Hello! How can I help?"

Markdown

- id: formatted
  type: reply
  config:
    message: |
      **Bold** *Italic*
      - List item
      [Link](https://example.com)

Adaptive Cards

- id: card
  type: adaptive-card
  config:
    card:
      type: AdaptiveCard
      version: "1.2"
      body:
        - type: TextBlock
          text: "Welcome!"

File Attachments

- id: send_file
  type: reply
  config:
    message: "Here's your document"
    files:
      - url: "https://example.com/doc.pdf"

Next Steps