Skip to main content

Cisco Webex

Learn to set up Webex bots and integrations to interact with messages and users safely, plus configure Webex steps in Torq workflows.

Updated over a week ago

Webex is a video conferencing and online meeting platform used for virtual collaboration, webinars, and screen sharing.

Torq enables quick and easy integration with Webex, so you can automate anything and everything within moments. Torq's pre-built Webex steps include:

  • Send Message

  • Ask a Question

  • List Users

  • List Rooms

  • Get Action Details

  • +6 more...

If you don't see a step you need, you can create your own in various ways, such as using the Send an HTTP Request step or Torq’s Step Builder, and share it across your organization.

The Webex integration enables you to interact with messages, users, and rooms on behalf of a user account (integration) or a bot.

Be aware that, by Cisco's design, published Webex bots can be interacted with by anyone, regardless of organization. You should implement a check on your bot before taking any actions in response to its triggers.

Use Cisco Webex Steps in Torq

Bots are similar to regular Webex users. They can participate in 1-to-1 and group spaces, and users can message them directly or add them to a group space. In the Webex clients, a special badge is added to a bot's avatar so users know they're interacting with a bot instead of a human.

A bot can only access messages sent to it directly. In group spaces, bots must be @mentioned to access the message. In 1-to-1 spaces, a bot has access to all messages from the user.

Bots do not, however, perform actions within Webex on behalf of a Webex user. For more information about bots, see the Webex documentation.

Step One: Create a Bot in WebEx

  1. Start Building: Log in to developer.webex.com and click Start Building Apps > Create a Bot.

    image.png
    image.png

  2. Fill in Details: Fill in the bot information:

    1. Bot name: The bot's name as it will appear in Webex.

    2. Bot username: Webex users will use this to add your bot to a space, and the username will be passed in the mentionedUsers parameter for message steps. It cannot be changed later.

    3. Icon: The icon of the bot that will appear in Webex.

    4. Description: Information about what the bot will do.

      image.png

  3. Get Access Token: Click Add bot and copy the Bot access token. You will need this when you configure the Webex integration in Torq.

Step Two: Get Your Webext Organization ID

  1. Go to Partner View: Go to your Webex admin view and then Partner view > Customers > View my Organization > My Company.

  2. Go to Company Information: Go to Info > Company Information and copy the organization ID for later use in Torq.

Step Three: Create a Webex Steps Integration in Torq

  1. Navigate to the Integration: Go to Build > Integrations > Steps > Webex and cllick Add Instance.

  2. Fill in the Details: Give the integration a unique and meaningful name.

    1. Webex Access Token: Paste the bot access token created earlier.

    2. Organization ID: Paste your Webex organization ID you copied earlier.

    3. Webhook Secret: Enter a random secret to secure your messages.

  3. Finalize: Click Add.

FAQs

Check your Bot for Legitimacy

Compare the returned orgID to your orgID or list of IDs by implementing the Get user details step and using an If operator that exits the workflow if necessary.

Optional: Advanced Configuration

The following procedures are provided for reference, and are not necessary for normal bot usage.

Create a Webex Integration

Integrations are how you request permission to invoke the Webex REST API on behalf of another Webex user.

  1. Go to Webex Developer Center: Log in to developer.webex.com and click Start Building Apps > Create an Integration.

    image.png

  2. Fill in Details: Fill in the integration information.

    1. Integration name: The name of the integration as it will appear in Webex.

    2. Icon: The icon of integration that will appear in Webex.

    3. Description: Information about what the integration will do.

    4. Redirect URI: The URL where you'll be directed to complete the OAuth setup. You can enter https://app.torq.io. or EU: https://app.eu.torq.io

    5. Scopes: Select all of the scopes to apply to the integration. The scopes determine which APIs can be performed with the integration. The Webex steps in Torq interact with messages, users, rooms, and actions.

  3. Get Details: At the bottom of the page, click Add Integration. Copy and save the Client ID and Client Secret.

  4. Get OAuth URL: Copy the OAuth Authorization URL.

  5. Generate Access Toke:

    1. Open a new web browser and paste the OAuth authorization URL generated when you created the integration.

      1. Scroll to the end of the URL and replace state=set_state_here it with state+hello.

      2. You may be directed to log in to Torq. Copy the code value from the URL bar after you're in Torq.

        image.png

  6. Get Access Token: To get the access token, you need to make a POST call to the following Webex endpoint https://webexapis.com/v1/access_token and, in the body, pass all required parameters. For more detailed information, see the Webex documentation.

    image.png

    1. The response will include the access token. Copy the access token; you'll need this when you create the Webex integration in Torq.

      image.png

Use the Create a Webhook Trigger Step

The Create a webhook trigger step defines which Webex events to send to Torq to trigger workflows. Depending on what you intend to use the integration for, you should use the bot or integration access token generated earlier.

  1. Create Workflow: Go to Build > Workflows and create new workflow.

  2. Add Step: Search for the Create a webhook trigger step and drag it to the designer.

  3. Configure the Step:

    1. EVENT: The action taken on the resource to generate an event.

    2. RESOURCE: The Webex resource is used to generate an event. The list of options is below, with our recommended options bolded (messages or rooms):

      1. attachmentActions

      2. dataSources

      3. memberships

      4. messages

      5. rooms

      6. meetings

      7. recordings

      8. converedRecordings

      9. meetingParticipants

      10. meetingTranscripts

      11. uc_counters

      12. serviceApp

      13. adminBatchJobs

    3. TARGET_URL: Each Webex event trigger subscribes to a single event and resource. To send all Webex events to a single Torq webhook, use the same endpoint URL for TARGET_URL.

    4. WEBHOOK_NAME: a unique name for the Webex webhook trigger

    5. INTEGRATION: the Webex integration in Torq.

Templates

Now that you've added your integrations check out these specially crafted templates by Torq's security experts. Visit Torq's template library for more.

Related Articles
Slack Interaction Payloads
Microsoft Teams Bot
ServiceNow
Discord
Slack Custom App
Did this answer your question?