Webex

Resumen

El provider Webex se integra con Cisco Webex Teams. Soporta:

• Mensajes directos
• Mensajes en espacios (rooms)
• Adaptive Cards
• Adjuntos de archivos
• @mentions

Requisitos previos

• Cuenta de Webex
• Acceso a Webex Developer

Configuración

1. Crea un bot de Webex

   Ve a developer.webex.com:

   • Navega a My Webex Apps → Create a Bot
   • Completa los datos del bot
   • Copia el Bot Access Token

2. Crea un webhook

   El provider creará webhooks automáticamente, o puedes crearlo manualmente:

   • Ve a Documentation → Webhooks API
   • Crea un webhook que apunte a tu endpoint

3. Configura el provider

   answers.json

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

4. Ejecuta la configuración

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

Opciones de configuración

Opción	Requerido	Descripción
enabled	Sí	Habilita/deshabilita el provider
public_base_url	Sí	URL pública para el webhook
access_token	Sí	Access token del bot

Acción Add to WebEx

Después de que setup se completa correctamente, el pack de Webex expone una acción de setup genérica mediante greentic.setup.actions.v1:

Campo	Valor
Etiqueta	Add to WebEx
Tipo	deep_link
Plantilla de URL	https://web.webex.com/teams/messages/new?email={bot_email}
Salida de setup requerida	bot_email

Los hosts de setup pueden renderizarla como botón, mostrar la URL y proporcionar un fragmento HTML. El enlace abre Webex con un mensaje nuevo dirigido al bot.

Funcionalidades

Mensajes de texto

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

Adjuntos de archivos

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

Próximos pasos

• Provider de Slack
• Provider de Teams