Webex (Rooms and Messages)
The Webex (Rooms & Messages) configuration enables workflows to interact with Webex by sending messages to a specific Webex room or by retrieving a list of available rooms using the Webex API.
This activity is commonly used to send alerts, notifications, or status updates to Webex rooms.
Parameter
| Parameter | Description |
|---|---|
| Bearer Token |
Authenticates the request to the Webex API. Accepts a Webex Personal Access Token and can be provided directly or via a variable. Note: Ensure the token has the required permissions to access rooms and post messages. |
| Action |
Defines the operation to be performed. Available options: • List Rooms – Returns all Webex rooms accessible to the authenticated user and used to identify and copy the required Room ID. • Post Message – Sends the specified Message Text to the provided Room ID and requires a valid Bearer Token with messaging permission. Note: The fields displayed in the configuration change based on the selected action. |
| Message Text |
Specifies the content of the message to be sent to the Webex room. Used for sending alerts or notifications and supports dynamic values from variables. Displayed when: Post Message action is selected. |
| Webhook Payload |
Passes input data received from a webhook. This enables dynamic message content or conditional logic based on incoming data. |
| Verbose Output |
Controls the level of detail returned in the response. • True – Returns only essential response data. • False – Returns the full Webex API response. |
| Room ID |
Identifies the Webex room where the message will be posted. Must be the actual Room ID; room names are not supported. Important: Use the List Rooms action to retrieve the correct Room ID before posting a message. Displayed when: Post Message action is selected. |
| Timeout (seconds) |
Maximum wait time for the request to be completed before the operation times out. Default: 30 seconds. |
| Retry count | The number of automated attempts if the initial request fails. |
| Delay between retries (s) |
Wait time between consecutive retry attempts. Default: 1 second. |
| Delay before execution (s) |
Time to wait before the component starts processing. Default: 0 seconds. |
| Delay after execution (s) |
Time to wait after the component finishes processing. Default: 0 seconds. |
| Continue on Error |
Determines the behavior when an unrecoverable error occurs. Available options: • Stop Workflow – Halts workflow execution. • Continue – Skips this step and continues without passing the error downstream. • Continue Using Error Output – Continues execution and routes error details through the error output handle. |
Example:
1. Use List Rooms to retrieve available Webex rooms.
2. Copy the required Room ID.
3. Select Post Message.
4. Provide the Room ID and Message Text.
5. Execute the workflow to send the message.
