Webex Spaces
-->
Webex Teams enables continuous teamwork with video meetings, group messaging, file sharing, and white boarding. Always available. Cisco secure. With the Webex Teams connector, you can send and receive messages, manage files, and manage spaces and teams.
Webex Join a Space You can join an unmoderated space when someone who's already a member of it, adds you to it. Reach out to your co-workers to get added to spaces that they're already using. Or, start a new space to get your team working together.
This connector is available in the following products and regions:
- All of your work takes place within spaces in the Cisco Webex teams app. Inside a space, you can send messages, make calls, have video meetings, share files, and whiteboard. You can choose from three types of spaces: people, spaces, and team spaces, depending on why you need to chat.
- Speed up workloads, track projects, and work faster together right in Webex.
| Service | Class | Regions |
|---|---|---|
| Logic Apps | Standard | All Logic Apps regions except the following: - Azure Government regions - Azure China regions |
| Power Automate | Standard | All Power Automate regions except the following: - US Government (GCC) - US Government (GCC High) - China Cloud operated by 21Vianet |
| Power Apps | Standard | All Power Apps regions except the following: - US Government (GCC) - US Government (GCC High) - China Cloud operated by 21Vianet |
| Connector Metadata | |
|---|---|
| Publisher | Cisco |
Throttling Limits
| Name | Calls | Renewal Period |
|---|---|---|
| API calls per connection | 100 | 60 seconds |
Actions
| Add Member to Space | Add a member to an existing space |
| Add Member to Team | Add a member to a team |
| Create Space | Create space or team space |
| Get Message Details | Shows details for a message, by message ID. |
| Get Messages | Get a list of recent messages for a space |
| Get My Own Details | Lookup your own details |
| Get People | Lookup details and presence information for people in your organization |
| Get Space Details | Return details of a given space |
| Get Spaces List | This action retrieves a list of spaces |
| Send a Message | Send a message to webex teams |
Add Member to Space
Add a member to an existing space
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
| isModerator | True | boolean | Is moderator? | |
Email | personEmail | string | Email address | |
| personId | string | Person ID of the new member | ||
Space | roomId | True | string | Select a space |
Returns
| Name | Path | Type | Description |
|---|---|---|---|
| created | date-time | created | |
id | id | string | id |
| isModerator | boolean | isModerator | |
isMonitor | isMonitor | boolean | isMonitor |
| personDisplayName | string | personDisplayName | |
personEmail | personEmail | string | personEmail |
| personId | string | personId | |
personOrgId | personOrgId | string | personOrgId |
| roomId | string | roomId |
Add Member to Team
Add a member to a team
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
| isModerator | True | boolean | Is Moderator? | |
Email | personEmail | string | Email address | |
| personId | string | Person ID of the new member | ||
Team | teamId | True | string | Select a team |
Returns
| Name | Path | Type | Description |
|---|---|---|---|
| created | date-time | created | |
id | id | string | id |
| isModerator | boolean | isModerator | |
personDisplayName | personDisplayName | string | personDisplayName |
| personEmail | string | personEmail | |
personId | personId | string | personId |
| personOrgId | string | personOrgId | |
teamId | teamId | string | teamId |
Create Space
Create space or team space
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
| teamId | string | Optionally select a team | ||
Title | title | True | string | Space Title |
Returns
| Name | Path | Type | Description |
|---|---|---|---|
| created | date-time | created | |
creatorId | creatorId | string | creatorId |
| id | string | id | |
isLocked | isLocked | boolean | isLocked |
| lastActivity | date-time | lastActivity | |
title | title | string | title |
| type | string | type |
Get Message Details
Shows details for a message, by message ID.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
| messageId | True | string | The message ID |
Returns
| Name | Path | Type | Description |
|---|---|---|---|
created | created | string | created |
| files | array of string | files | |
id | id | string | id |
| markdown | string | markdown | |
mentionedGroups | mentionedGroups | array of string | mentionedGroups |
| mentionedPeople | array of string | mentionedPeople | |
personEmail | personEmail | string | personEmail |
| personId | string | personId | |
roomId | roomId | string | roomId |
| roomType | string | roomType | |
text | text | string | text |
| toPersonEmail | string | toPersonEmail | |
toPersonId | toPersonId | string | toPersonId |
Get Messages
Get a list of recent messages for a space
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
| roomId | True | string | List messages in a space for a given space ID | |
Mentioned People | mentionedPeople | string | List messages where the caller is mentioned by specifying 'me' or the caller personId. | |
| beforeMessage | string | List messages sent before a message, by ID. | ||
Before | before | string | List messages sent before a date and time, in ISO8601 format. | |
| max | integer | Limit the maximum number of messages in the response. |
Returns
| Name | Path | Type | Description |
|---|---|---|---|
items | items | array of object | items |
| items.created | date-time | created | |
id | items.id | string | id |
| items.personEmail | string | personEmail | |
personId | items.personId | string | personId |
| items.roomId | string | roomId | |
roomType | items.roomType | string | roomType |
| items.text | string | text |
Get My Own Details
Lookup your own details
Returns
| Name | Path | Type | Description |
|---|---|---|---|
| avatar | string | avatar | |
created | created | string | created |
| displayName | string | displayName | |
emails | emails | array of string | emails |
| firstName | string | firstName | |
id | id | string | id |
| lastActivity | string | lastActivity | |
lastName | lastName | string | lastName |
| nickName | string | nickName | |
orgId | orgId | string | orgId |
| phoneNumbers | array of object | phoneNumbers | |
type | phoneNumbers.type | string | type |
| phoneNumbers.value | string | value | |
status | status | string | status |
| type | string | type |
Get People
Lookup details and presence information for people in your organization
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
| id | string | List people by ID. Accepts up to 85 person IDs separated by commas. | ||
Email | string | List people with this email address |
Returns
| Name | Path | Type | Description |
|---|---|---|---|
| items | array of object | items | |
avatar | items.avatar | string | avatar |
| items.created | string | created | |
displayName | items.displayName | string | displayName |
| items.emails | array of string | emails | |
firstName | items.firstName | string | firstName |
| items.id | string | id | |
lastActivity | items.lastActivity | string | lastActivity |
| items.lastName | string | lastName | |
nickName | items.nickName | string | nickName |
| items.orgId | string | orgId | |
phoneNumbers | items.phoneNumbers | array of object | phoneNumbers |
| items.phoneNumbers.type | string | type | |
value | items.phoneNumbers.value | string | value |
| items.status | string | status | |
type | items.type | string | type |
| notFoundIds | array of string | notFoundIds |
Get Space Details
Return details of a given space
Webex Space Support
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
| roomId | True | string | Select a space |
Returns
| Name | Path | Type | Description |
|---|---|---|---|
created | created | date-time | created |
| creatorId | string | creatorId | |
id | id | string | id |
| isLocked | boolean | isLocked | |
lastActivity | lastActivity | date-time | lastActivity |
| title | string | title | |
type | type | string | type |
Get Spaces List
This action retrieves a list of spaces
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
| max | integer | Maximum number of spaces to return | ||
Type of space | type | string | (group) only include group spaces, (direct) only include 1 to 1 spaces, returns all if not specified | |
| sortBy | string | (id) the space id, (lastactivity) the last activity timestamp, (created) space creation date |
Returns
| Name | Path | Type | Description |
|---|---|---|---|
items | items | array of object | items |
| items.created | date-time | created | |
creatorId | items.creatorId | string | creatorId |
| items.id | string | id | |
isLocked | items.isLocked | boolean | isLocked |
| items.lastActivity | date-time | lastActivity | |
title | items.title | string | title |
| items.type | string | type |
Send a Message
Send a message to webex teams
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
| files | string | Attach files to this message | ||
Text | markdown | string | Message, in markdown format | |
| roomId | string | Select a recipient space | ||
text | text | string | Message Text, in plain text, used for clients that do not support markdown | |
| toPersonEmail | string | The email address of the recipient when sending a private 1:1 message | ||
Person ID | toPersonId | string | The ID of the recipient when sending a 1:1 message |
Webex Meeting Spaces
Returns
| Name | Path | Type | Description |
|---|---|---|---|
| created | date-time | created | |
id | id | string | id |
| personEmail | string | personEmail | |
personId | personId | string | personId |
| roomId | string | roomId | |
roomType | roomType | string | roomType |
| text | string | text | |
toPersonEmail | toPersonEmail | string | toPersonEmail |
Triggers
| When a membership is created | Someone joined a room that you're in or you've been added to a new room |
| When a membership is deleted | Someone left or was kicked out of a room that you're in, or you left or were removed from a room; only triggers for group rooms, not 1-to-1 rooms |
| When a membership is updated | Someone's membership was updated in a room that you're in; primarily used to detect moderator changes |
| When a message is created | New message posted into a room that you're in |
| When a message is deleted | A message was deleted from a room that you're in |
| When a space is created | A new space was created by you or one of your integrations |
| When a space is updated | A space that you're in was updated; primarily used to detect when a space becomes Locked or Unlocked |
Webex Space Bar
When a membership is created
Someone joined a room that you're in or you've been added to a new room
Returns
| Name | Path | Type | Description |
|---|---|---|---|
| data.created | string | created | |
| data.id | string | id | |
| data.isModerator | boolean | isModerator | |
isMonitor | data.isMonitor | boolean | isMonitor |
| data.personDisplayName | string | personDisplayName | |
personEmail | data.personEmail | string | personEmail |
| data.personId | string | personId | |
personOrgId | data.personOrgId | string | personOrgId |
| data.roomId | string | spaceId |
When a membership is deleted
Someone left or was kicked out of a room that you're in, or you left or were removed from a room; only triggers for group rooms, not 1-to-1 rooms
Returns
| Name | Path | Type | Description |
|---|---|---|---|
| data.created | string | created | |
id | data.id | string | id |
| data.isModerator | boolean | isModerator | |
isMonitor | data.isMonitor | boolean | isMonitor |
| data.personDisplayName | string | personDisplayName | |
personEmail | data.personEmail | string | personEmail |
| data.personId | string | personId | |
personOrgId | data.personOrgId | string | personOrgId |
| data.roomId | string | spaceId |
When a membership is updated
Someone's membership was updated in a room that you're in; primarily used to detect moderator changes
Returns
| Name | Path | Type | Description |
|---|---|---|---|
| data.created | string | created | |
id | data.id | string | id |
| data.isModerator | boolean | isModerator | |
isMonitor | data.isMonitor | boolean | isMonitor |
| data.personDisplayName | string | personDisplayName | |
personEmail | data.personEmail | string | personEmail |
| data.personId | string | personId | |
personOrgId | data.personOrgId | string | personOrgId |
| data.roomId | string | spaceId |
When a message is created
New message posted into a room that you're in
Returns
| Name | Path | Type | Description |
|---|---|---|---|
| data.created | string | created | |
id | data.id | string | id |
| data.personEmail | string | personEmail | |
personId | data.personId | string | personId |
| data.roomId | string | spaceId |
When a message is deleted
A message was deleted from a room that you're in
Returns
| Name | Path | Type | Description |
|---|---|---|---|
| data.created | string | created | |
id | data.id | string | id |
| data.personEmail | string | personEmail | |
personId | data.personId | string | personId |
| data.roomId | string | spaceId |
When a space is created
A new space was created by you or one of your integrations
Returns
| Name | Path | Type | Description |
|---|---|---|---|
| data.created | string | created | |
creatorId | data.creatorId | string | creatorId |
| data.id | string | id | |
isLocked | data.isLocked | boolean | isLocked |
| data.lastActivity | string | lastActivity | |
teamId | data.teamId | string | teamId |
| data.title | string | title | |
type | data.type | string | type |
When a space is updated
A space that you're in was updated; primarily used to detect when a space becomes Locked or Unlocked
Returns
| Name | Path | Type | Description |
|---|---|---|---|
| data.created | string | created | |
creatorId | data.creatorId | string | creatorId |
| data.id | string | id | |
isLocked | data.isLocked | boolean | isLocked |
| data.lastActivity | string | lastActivity | |
teamId | data.teamId | string | teamId |
| data.title | string | title | |
type | data.type | string | type |
Main Capabilities
Webex Space Management handles retention and management needs for Webex Spaces and Direct Room.
✔View & search Space information across all the company
✔Manage Space users
✔Set manual and automatic retention policies based on conditional Space parameters.
Webex Space Management works seamlessly with Webex Teams and consists on 2 main modules:
- ✔Space Operations
- ✔Retention Policy Engine
Feature List
Space Operations
- •Get a list of all the Webex Spaces -Tag the Spaces for automatic policies, search, and management/governance needs. For example Finance, PII. Tags can be added as needed
- •Add or remove users from spaces without being a member of the space
- •Delete space with all of its content
- •Block Spaces prevent any new content but leave existing content accessible
- •Perform advanced search using multiple parameters:
- •Title
- •Tags
- •Active Directory groups,
- •Scope(internal/ External)
- •Specific external domain members
- •Type (Space / Direct message)
- •Last activity period
- •Space webex classification
Retention Policy Engine
The retention Policy engine allows the company to set multiple conditions for setting retention period based on the following parameters:
- •Tags (set in the space management)
- •Active Directory Groups
- •Last activity date. For example, spaces that have been inactive last 30 days.
- •Scope - whether a Space contains external users.
- •Classification
In addition, manual retention period can override the automatic policies
Background
Data Retention Policies
Compliance and internal regulations often require data retention policies. Those usually indicate that after a certain amount of days, data needs to be fully erased. Policies like GDPR require data retention policies.
A common example is companies that need to erase employee or customer data on request or automatically. Also financial firms are usually required to do the same.
Data retention minimizes the risk of a breach or compliance events as less data is exposed in the cloud
Space Management
Webex Teams deployments tenants can sometimes become very large in the number of users and spaces. Company management and compliance teams need visibility of all the Spaces created which is not possible out of the box.
Until this date, there hasn’t been a way of providing clear and complete insights of the number of Spaces, their members, their last activity and whether they contain external members.
Other information such as the users, group membership, and external users is critical to handle both compliance and security risks.n
That information can be vital in order to preserve order and prevent security breaches by allowing external users into the incorrect Spaces
Get a Free Trial
Sign-up for a free trial and demo with a SphereShield expert
Get in touch
Har-Hotzvim Hi-Tech Park, Jerusalem, Israel