Cisco Webex
Connect GNETiX to Cisco Webex
GNETiX connects to Cisco Webex using a persistent WebSocket connection. This means no webhook URLs, no public endpoints, and no inbound firewall rules are needed. The bot listens for messages in real time over an outbound WebSocket.
Features
| Feature | Supported |
|---|---|
| Direct messages | Yes |
| Group spaces (threaded) | Yes |
| Text messages | Yes |
| Image attachments (vision) | Yes |
| PDF attachments | Yes |
| File attachments | Yes |
| Adaptive cards | Yes |
In group spaces, conversations are automatically threaded. The bot replies in the same thread as the original message, keeping group spaces clean and organized.
Setup
Step
Create a Webex Bot
- Go to the Webex Developer Portal
- Click Create a New App and select Bot
- Fill in the bot name, username, and description
- Save the Bot Access Token -- you will only see it once
Copy the bot token immediately after creation. Webex does not show it again. If you lose it, you must regenerate a new token.
Step
Configure in GNETiX
- Log in to the GNETiX portal as a superuser or org admin
- Navigate to System Settings > Integrations > Webex
- Paste the Bot Access Token
- Click Save
GNETiX connects to Webex automatically. The connection status indicator will show Connected within a few seconds.
Step
Add the Bot to Spaces
Add the bot to any Webex space where you want it to respond. In direct messages, users can message the bot directly by searching for its username.
In group spaces, mention the bot with @BotName to trigger a response.
User Matching
GNETiX matches incoming Webex messages to users by their email address. The email on the Webex account must match the email configured for the user in GNETiX.
Users must also have the Webex platform toggle enabled in their user profile.
Connection Management
The Webex integration uses a WebSocket connection that stays open continuously. If the connection drops (network issues, token rotation, etc.), GNETiX automatically reconnects with exponential backoff.
You can monitor the connection status on the System Settings > Integrations page. The status indicator shows:
- Connected -- WebSocket is active and receiving messages
- Disconnected -- connection is down; GNETiX will retry automatically
- Not configured -- no bot token has been set
Attachments and Vision
When a user sends an image, GNETiX downloads it and passes it to the Director as a vision input. The LLM can describe, analyze, or reason about the image content.
PDF and file attachments are downloaded, extracted where possible, and included in the Director's context as text content.