Cisco Webex

The Cisco Webex modules enable you to monitor, create, retrieve, update, or delete messages, rooms, attachment actions, memberships, and teams in your Cisco Webex account.

Getting Started With Cisco Webex

Prerequisites

The module dialog fields that are displayed in bold (in the Integromat scenario, not in this documentation article) are mandatory!

Connecting Cisco Webex to Integromat

1. Go to the Cisco Webex Integration page and click Create a new scenario. Open the Cisco Webex module's Create a connection dialog.

2. Enter a name for the connection in the Connection name field, and click Continue.

After you click the Continue button, Integromat will redirect you to the Cisco Webex website, where you will be prompted to log in and grant Integromat access to your account.

2021-01-15_18_08_49-OAuth2_Authorization_-_Webex.png

Confirm the dialog by clicking the Accept button.

Message

Watch Messages

Triggers when messages are added or deleted.

Webhook nameEnter the name for the webhook, e.g., Message Created.
ConnectionEstablish a connection to your Cisco Webex account.
NameEnter a user-friendly name for the webhook, only seen when you list all your webhooks via the API.
EventSelect whether to trigger the module when a message is created or deleted.
FilterSet the filter to return messages based on the filter settings only.

List Messages

Retrieves messages based on filter settings.

ConnectionEstablish a connection to your Cisco Webex account.
Messages From

Select whether to retrieve messages from:

  • Room - to list messages in a room. Enter the ID, or select the room in the Room ID field below.
  • Person by ID - to list messages by the person ID of the message author. Enter (map) the ID of the person in the Person ID field below, or use the Search button to find the ID by user's name or user's email address.
  • Person by email - to list messages by the email address of the message author. Enter the email address of the person in the Person Email field below. 
Parent Message IDEnter (map) the ID of the message to retrieve replies for.
Is MentionedEnable to list messages with these people mentioned. Only the current API user or the person ID of the current user may be specified. Bots must include this parameter to list messages in group rooms (spaces).
Before DateEnter the date and time to retrieve messages sent before a specified date and time. See the list of supported date and time formats.
Before Message IDEnter (map) the ID of the message to retrieve messages sent before this message.
LimitSet the maximum number of messages Integromat will return during one execution cycle.

Create a Message

Posts a message to the room or the specified person.

ConnectionEstablish a connection to your Cisco Webex account.
Send To

Select whether to send a message to:

  • Room - to send a message to the room. Enter the ID, or select the room in the Room ID field below.
  • Person by ID - to send a message to the person. Enter (map) the ID of the person in the Person ID field below, or use the Search button to find the ID by user's name or user's email address.
  • Person by email - to send a message to the person specified by email address, enter the person's email address. Enter the email address of the person in the Person Email field below. 
Content TypeSelect whether you want to create a plain-text message or a markdown-formatted message.
Text / MarkdownEnter the content of the message in the corresponding format. Maximum 7439 characters.
Attachment Type

Select whether to attach a file or an adaptive card.

Parent Message IDEnter (map) the ID of the message you want to reply to.

Get a Message

Retrieves message details.

ConnectionEstablish a connection to your Cisco Webex account.
Message IDEnter (map) the ID of the message you want to retrieve details about.

Delete a Message

Deletes a message.

ConnectionEstablish a connection to your Cisco Webex account.
Message IDEnter (map) the ID of the message you want to delete.

Attachment Action

Watch Attachment Actions

Triggers when an attachment card is submitted.

Webhook nameEnter the name for the webhook.
ConnectionEstablish a connection to your Cisco Webex account.
NameEnter a user-friendly name for the webhook, only seen when you list all your webhooks via the API.
FilterSet the filter to return messages based on the filter settings only.

Create an Attachment Action

Creates a new attachment action - clicks on a submit button in a card.

ConnectionEstablish a connection to your Cisco Webex account.
Message IDEnter (map) the ID of the message that contains the attachment you want to click the submit button on.
Inputs

Enter the attachment action's inputs key-value pairs.

Example:

mceclip0.png

 

Get an Attachment Action

Retrieves details for an attachment action.

ConnectionEstablish a connection to your Cisco Webex account.
Attachment Action IDEnter (map) the ID of the attachment action you want to retrieve details for.

Room

Watch Rooms

Triggers when a room is created or updated.

Webhook nameEnter the name for the webhook, e.g., Room Created.
ConnectionEstablish a connection to your Cisco Webex account.
NameEnter a user-friendly name for the webhook, only seen when you list all your webhooks via the API.
EventSelect whether to trigger the module when a room is created or deleted.
FilterSet the filter to return rooms based on the filter settings.

List Rooms

Retrieves rooms based on filter settings.

ConnectionEstablish a connection to your Cisco Webex account.
Team IDEnter the ID of the team to list rooms associated with the team.
Type

Select the type of room you want to list:

  • Direct to list 1:1 rooms
  • Group to list group rooms.
Sort BySelect the sorting order of the results.
LimitSet the maximum number of rooms Integromat will return during one execution cycle.

Create a Room

Creates a room.

ConnectionEstablish a connection to your Cisco Webex account.
TitleEnter the name for the room.
Team IDSelect or enter the ID of the team with which this room is associated.

Get a Room

Retrieves room details.

ConnectionEstablish a connection to your Cisco Webex account.
Room ID

Enter (map) or select the room you want to retrieve details for.

Update a Room

Updates an existing room.

ConnectionEstablish a connection to your Cisco Webex account.
Room ID

Enter (map) or select the room you want to update.

Title

Enter the new name for the room.

Membership

Triggers when membership is added, updated, or deleted.

Webhook nameEnter the name for the webhook, e.g., Membership Deleted.
ConnectionEstablish a connection to your Cisco Webex account.
NameEnter a user-friendly name for the webhook, only seen when you list all your webhooks via the API.
EventSelect whether to trigger the module when a membership is created, updated, or deleted.
FilterSet the filter to return memberships based on the filter settings.

List Memberships

Retrieves members of the specified room.

ConnectionEstablish a connection to your Cisco Webex account.
Room IDEnter (map or select) the ID of the room to list memberships associated with the room.
Person ID

Enter the ID of the person to list memberships associated with the person, or use the Search button to find the ID by user's name or user's email address. The Room ID field is required when using this parameter.

Person EmailEnter the person's email address to list memberships associated with the person. The Room ID field is required when using this parameter.
LimitSet the maximum number of memberships Integromat will return during one execution cycle.

Create a Membership

Adds a person to a room.

ConnectionEstablish a connection to your Cisco Webex account.
Add Membership By

Select whether to specify the person by ID or email address:

  • ID - Enter (map) the ID of the person in the Person ID field below, or use the Search button to find the ID by user's name or user's email address.
  • Email - Enter the email address of the person in the Person Email field below. 
Is ModeratorEnable this option to set the person as a room moderator.

Get a Membership

Retrieves membership details.

ConnectionEstablish a connection to your Cisco Webex account.
Membership ID

Enter (map) or select via the Search button the ID of the membership you want to retrieve details for.

Update a Membership

Updates properties for a membership.

ConnectionEstablish a connection to your Cisco Webex account.
Membership ID

Enter (map) or select via the Search button the ID of the membership you want to update.

Is Moderator

Enable this option to set the participant as a room moderator.

Room Hidden from Cisco Webex Clients
Enable this option to set the room as hidden from the Webex clients.

Delete a Membership

Deletes a membership.

ConnectionEstablish a connection to your Cisco Webex account.
Membership ID

Enter (map) or select via the Search button the ID of the membership you want to delete.

Team

List Teams

Retrieves a list of teams in your Cisco Webex account.

ConnectionEstablish a connection to your Cisco Webex account.
Limit

Set the maximum number of teams Integromat will return during one execution cycle.

Create a Team

Creates a new team.

ConnectionEstablish a connection to your Cisco Webex account.
Name

Enter a user-friendly name for the team.

Update a Team

Updates a team name.

ConnectionEstablish a connection to your Cisco Webex account.
Team IDEnter (map) the ID of the team you want to update.
Name

Enter the new user-friendly name for the team.

Delete a Team

Deletes a team.

ConnectionEstablish a connection to your Cisco Webex account.
Team IDEnter (map) the ID or select the team you want to delete.

Team Membership

List Team Memberships

Retrieves a list of team members.

ConnectionEstablish a connection to your Cisco Webex account.
Team IDEnter (map) the ID or select the team you want to list memberships for.
LimitSet the maximum number of memberships Integromat will return during one execution cycle.

Create a Team Membership

Adds a person to the team.

ConnectionEstablish a connection to your Cisco Webex account.
Team IDEnter (map) the ID or select the team you want to add a person to.
Add Team Membership By

Select whether to specify the person you want to add to the team by the ID or email address:

  • ID - Enter (map) the ID of the person in the Person ID field below, or use the Search button to find the ID by user's name or user's email address.
  • Email - Enter the email address of the person in the Person Email field below. 
Is Moderator

Enable this option to set the person as a team moderator.

Update a Team Membership

Allows you to set the person as a moderator.

ConnectionEstablish a connection to your Cisco Webex account.
Team IDEnter (map) the ID or select the team you want to update.
Team Membership ID

Select the member of the team whose permissions you want to update.

Is Moderator

Enable this option to set the person as a team moderator.

Delete a Team Membership

Removes a member from the team.

ConnectionEstablish a connection to your Cisco Webex account.
Team IDEnter (map) the ID or select the team you want to remove the user from.
Team Membership ID

Select the member whom you want to remove from the team.

Other

Watch Events

Triggers when an attachment action, membership, message, or room event occurs.

Webhook nameEnter the name for the webhook, e.g., Message Created.
ConnectionEstablish a connection to your Cisco Webex account.
NameEnter a user-friendly name for the webhook, only seen when you list all your webhooks via the API.

Make an API Call

Allows you to perform a custom API call.

ConnectionEstablish a connection to your Cisco Webex account.
URL

Enter a path relative to https://webexapis.com.
For example: /v1/people/me/.

For the list of available endpoints, please refer to the Cisco Webex API Documentation.
Method

Select the HTTP method you want to use:

GET
to retrieve information for an entry.

POST
to create a new entry.

PUT
to update/replace an existing entry.

PATCH
to make a partial entry update.

DELETE
to delete an entry.

HeadersEnter the desired request headers. You don't need to add authorization headers; we've already added those for you.
Query StringEnter the request query string.
BodyEnter the body content for your API call.

Example of Use - List Messages

The following API call returns all messages in the specified room in your Webex Teams account:

URL:
/v1/messages

Method:
GET

Query String:
KeyroomId
Value{room_ID}

2021-01-21_16_20_48-Empty_integration___Integromat.png

The result can be found in the module's Output under Bundle > Body > items
In our example, 5 items were returned:

2021-01-21_16_24_06-Empty_integration___Integromat.png


Popular use cases from our blog

procur

How to Automate Procurement in Your Shopify Store - Part 1

Using Notion as CMS for Webflow -Tutorial- -illustration.png

How to Use Notion as a CMS for Your Webflow Site [Tutorial]

Basic-tutorial-for-Revolut-users-illustration.png

How to Create Your First Revolut Business Automation [Tutorial]

cancelled saas subscriptions-ILLUSTRATION.png

How to Track SaaS Subscriptions to Reduce Churn [Tutorial]

jira-excel-automation.png

How to Export From Jira to Excel Using Integromat [Tutorial]

influencer partner code sign up tracking-Illustration.png

How to Track Influencer Campaigns With Integromat

Didn’t find what you were looking for?

Ticket

Create a ticket

Contact our world-class support team and tell us what’s happening.

Create a ticket
Expert

Find an expert

We feature a network of 450+ certified partners across the globe who are ready to help

Find an expert

Automate any workflow in your business

Sign up for a free account today. No credit card required, no time limits on free plan.