Webex

概要

Webex provider は Cisco Webex Teams と統合します。次をサポートします:

• ダイレクトメッセージ
• Space（room）message
• Adaptive Cards
• file attachment
• @mention

前提条件

• Webex account
• Webex Developer access

セットアップ

1. Webex Bot を作成する

   developer.webex.com に移動します:

   • My Webex Apps → Create a Bot に進む
   • bot の詳細を入力する
   • Bot Access Token をコピーする

2. Webhook を作成する

   provider が webhook を自動作成します。手動で作成する場合は:

   • Documentation → Webhooks API に移動する
   • endpoint を向く webhook を作成する

3. provider を設定する

   answers.json

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

4. setup を実行する

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

設定オプション

Option	Required	Description
enabled	Yes	provider を有効/無効にする
public_base_url	Yes	webhook 用の公開 URL
access_token	Yes	bot access token

Add to WebEx アクション

setup が成功すると、Webex pack は greentic.setup.actions.v1 を通じて汎用 setup action を公開します:

フィールド	値
Label	Add to WebEx
Kind	deep_link
URL template	https://web.webex.com/teams/messages/new?email={bot_email}
必須 setup output	bot_email

Setup host はこれを button として表示し、URL を見せ、HTML snippet を提供できます。この link は bot 宛ての新規 message で Webex を開きます。

機能

テキストメッセージ

- 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"

次のステップ

• Slack Provider
• Teams Provider