Webex

webex

Webex is a Cisco-powered video conferencing and collaboration platform offering online meetings, webinars, screen sharing, and team messaging

Video Conferencing Team Collaboration Web del proveedor

Acciones

Triggers

Autenticación

—

OAuth gestionado

Sí

Información técnica: el detalle de parámetros, schemas y triggers de esta página está pensado para equipos de integración. Si solo necesitas saber si tu herramienta favorita está disponible, basta con ver la lista de acciones.

Acciones disponibles (28)

Cada acción es una operación que el agente puede ejecutar contra este conector. Haz clic en una acción para ver sus parámetros.

Create RoomWEBEX_CREATE_ROOMAcción

Tool to create a new room. use when you need to spin up a dedicated space for team collaboration or topic discussion.

Parámetros de entrada

titlestringObligatorio
The title for the room.
teamIdstring
The team ID to associate the room with. Optional.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Create TeamWEBEX_CREATE_TEAMAcción

Tool to create a new team. use when you need to group rooms under a shared team.

Parámetros de entrada

namestringObligatorio
The name of the team.
descriptionstring
A description of the team.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Team DetailsWEBEX_GET_TEAM_DETAILSAcción

Tool to retrieve details for a specific team by teamid. use when you need full metadata of a team before performing team-related operations.

Parámetros de entrada

teamIdstringObligatorio
The unique identifier for the team.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List TeamsWEBEX_LIST_TEAMSAcción

Tool to list teams. use when you need to retrieve the teams the authenticated user is a member of.

Parámetros de entrada

maxinteger
Maximum number of teams to return.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List WebhooksWEBEX_LIST_WEBHOOKSAcción

Tool to list webhooks. use after authentication to retrieve webhooks filtered by max or ownership.

Parámetros de entrada

maxinteger
Maximum number of webhooks to return
ownedBystringenum
Filter webhooks by ownership: 'creator' for user-owned, 'org' for org-wide
creatororg

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Create MessageWEBEX_MESSAGING_CREATE_MESSAGEAcción

Tool to post a message to a webex room or person. use when you have a target roomid or private recipient and want to send text, markdown, files, or card attachments.

Parámetros de entrada

textstring
Plain-text message content.
filesstring[]
Public URLs of files to post. Only one URL allowed per message.
roomIdstring
The room ID to post the message in. Required if sending to a room.
markdownstring
Markdown-formatted message. Overrides text if present.
toPersonIdstring
The person ID for sending a private 1:1 message. Mutually exclusive with roomId.
attachmentsobject[]
Content attachments (cards). Only one attachment per message is supported.
toPersonEmailstring
The email address of the person for a private 1:1 message. Mutually exclusive with roomId.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Create RoomWEBEX_MESSAGING_CREATE_ROOMAcción

Tool to create a new room. use to create a dedicated space for collaboration after authentication.

Parámetros de entrada

titlestringObligatorio
Title of the room.
teamIdstring
Optional team ID to associate with the room.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Create Team MembershipWEBEX_MESSAGING_CREATE_TEAM_MEMBERSHIPAcción

Tool to add a person to a webex team by personid or personemail. use when granting a user access to a team; requires teamid and one of personid or personemail.

Parámetros de entrada

teamIdstringObligatorio
The team ID to add the person to.
personIdstring
The person ID to add. Required if personEmail is not provided.
isModeratorboolean
Set to true to make the person a team moderator.
personEmailstring
The email address of the person to add. Required if personId is not provided.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Delete MembershipWEBEX_MESSAGING_DELETE_MEMBERSHIPAcción

Tool to delete a webex membership by its unique identifier. use when you need to remove a member from a space after confirming the membership exists. example: "delete the membership with id y2lzy29zcgfjmdcznza2njg0zdliy2yxnde4ndqyyzq5ndqzotexytk4".

Parámetros de entrada

membershipIdstringObligatorio
Unique identifier for the membership to delete

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Delete MessageWEBEX_MESSAGING_DELETE_MESSAGEAcción

Tool to delete a webex message by its unique identifier. use after confirming the messageid to remove unintended or obsolete messages. example: "delete the message with id y2lzy29zcgfyazovl21lc3nhz2uvywjjmtizndu2nzg5".

Parámetros de entrada

messageIdstringObligatorio
Unique identifier for the message to delete

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Delete RoomWEBEX_MESSAGING_DELETE_ROOMAcción

Tool to delete a webex room by its id. use after confirming the roomid when you need to permanently remove or archive a space. example: "delete the room with id y2lzy29..."

Parámetros de entrada

roomIdstringObligatorio
Unique identifier for the room to delete

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Membership DetailsWEBEX_MESSAGING_GET_MEMBERSHIP_DETAILSAcción

Tool to retrieve details for a specific membership. use when you need metadata for a membership by its id.

Parámetros de entrada

membershipIdstringObligatorio
The unique identifier for the membership.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Message DetailsWEBEX_MESSAGING_GET_MESSAGE_DETAILSAcción

Tool to retrieve details for a specific message. use when you need full content and metadata by message id.

Parámetros de entrada

messageIdstringObligatorio
The unique identifier for the message.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Room DetailsWEBEX_MESSAGING_GET_ROOM_DETAILSAcción

Tool to retrieve details for a specific room. use when you need full metadata of a specific room before posting messages or updating settings.

Parámetros de entrada

roomIdstringObligatorio
Unique identifier for the room.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Team Membership DetailsWEBEX_MESSAGING_GET_TEAM_MEMBERSHIP_DETAILSAcción

Tool to retrieve details for a specific team membership. use when you need metadata for a team membership by its id.

Parámetros de entrada

membershipIdstringObligatorio
The unique identifier for the team membership.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List MembershipsWEBEX_MESSAGING_LIST_MEMBERSHIPSAcción

Tool to list memberships in a webex room. use when you need to retrieve or filter membership details by roomid, personid, personemail, or teamid. supports limiting the response size.

Parámetros de entrada

maxinteger
Limit the maximum number of membership records returned.
roomIdstring
Filter memberships by the Webex room ID.
teamIdstring
Filter memberships associated with a specific team ID.
personIdstring
Filter memberships by the Webex person ID.
personEmailanyemail
Filter memberships by the member's email address.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List MessagesWEBEX_MESSAGING_LIST_MESSAGESAcción

Tool to list messages in a room. use when you need to retrieve chat history filtered by room, time window, or mentions.

Parámetros de entrada

maxinteger
Maximum number of messages to return per request.
beforestring
Filter messages sent before a specific ISO8601 timestamp.
roomIdstringObligatorio
Unique identifier for the room to list messages from.
parentIdstring
Filter messages that are replies to a specific message ID.
beforeMessagestring
Filter messages sent before a specific message, by its ID.
mentionedPeoplestring[]
Filter messages where the caller is mentioned; use 'me' or person IDs.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List RoomsWEBEX_MESSAGING_LIST_ROOMSAcción

Tool to list rooms the authenticated user belongs to. use after authentication when needing to retrieve spaces filtered by team, type, or sorted. example: "list my group rooms sorted by last activity."

Parámetros de entrada

maxinteger
Maximum number of rooms to return.
typestringenum
Filter rooms by type: 'direct' (1:1) or 'group'.
directgroup
sortBystringenum
Sort results by 'id', 'lastactivity' (recent activity), or 'created' (creation date).
idlastactivitycreated
teamIdstring
Limit rooms to those associated with a specific team by ID.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List Team MembershipsWEBEX_MESSAGING_LIST_TEAM_MEMBERSHIPSAcción

Tool to list team memberships. use when you need to retrieve or filter team membership details by teamid, personid, or personemail, with optional max limit. use after confirming the team or person context.

Parámetros de entrada

maxinteger
Limit the maximum number of team membership records returned.
teamIdstring
Filter memberships by the Webex team ID.
personIdstring
Filter memberships by the Webex person ID.
personEmailanyemail
Filter memberships by the member's email address.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Person DetailsWEBEX_PEOPLE_GET_PERSONAcción

Tool to get details for a specific person. use when you have a person's id and need full profile information. call after confirming the person's id.

Parámetros de entrada

personIdstringObligatorio
Unique identifier for the person.
callingDataboolean
If true, include the person's calling data in the response.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List PeopleWEBEX_PEOPLE_LIST_PEOPLEAcción

Tool to list people in your organization. use when you need to retrieve people filtered by email, display name, ids, roles, or location.

Parámetros de entrada

idstring
List people by ID. Accepts up to 85 person IDs separated by commas.
maxinteger
Maximum number of people to return per request.
emailstring
List people with this email address. For non-admin calls, either email or displayName is required.
orgIdstring
List people in this organization. Only admin users of another organization (such as partners) may use this parameter.
rolesstring
List of role IDs separated by commas.
locationIdstring
List people present in this location.
callingDataboolean
Include Webex Calling user details in the response. Default is false.
displayNamestring
List people whose name starts with this string. For non-admin calls, either displayName or email is required.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Room DetailsWEBEX_ROOMS_GET_ROOM_DETAILSAcción

Tool to retrieve details for a specific room. use when you need full metadata of a room before posting messages or updating settings.

Parámetros de entrada

roomIdstringObligatorio
Unique identifier for the room.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Update MembershipWEBEX_UPDATE_MEMBERSHIPAcción

Tool to update a membership by membershipid. use when modifying a member's moderator or monitor status in a webex room.

Parámetros de entrada

isMonitorboolean
Set to true to make the user a room monitor.
isModeratorboolean
Set to true to make the user a room moderator.
membershipIdstringObligatorio
Unique identifier of the membership to update.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Update RoomWEBEX_UPDATE_ROOMAcción

Tool to update a room's title and settings. use when you need to rename, lock/unlock, or reassign a webex space.

Parámetros de entrada

titlestring
New user-friendly name for the room.
roomIdstringObligatorio
Unique identifier of the room to update.
teamIdstring
Team ID to associate the room with. Use to move the room under a different team.
isLockedboolean
Lock the room to prevent new users from joining.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Update TeamWEBEX_UPDATE_TEAMAcción

Tool to update a team's name by teamid. use when you need to rename a webex team. example: "change team 12345 name to 'project x team'".

Parámetros de entrada

namestringObligatorio
New user-friendly name for the team.
teamIdstringObligatorio
Unique identifier of the team to update.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Create WebhookWEBEX_WEBHOOKS_CREATE_WEBHOOKAcción

Tool to create a new webhook for events. use when you need to register for webex event notifications.

Parámetros de entrada

namestringObligatorio
User-friendly name for the webhook.
appIdstring
(Internal) Application ID associated with this webhook.
eventstringObligatorioenum
The event type that triggers the webhook (created, updated, or deleted).
createdupdateddeleted
filterstring
Optional filter expression to scope notifications, e.g., 'roomId=Y2lzY29zcGFyazovL3VzL1JPT00vMTIz'.
secretstring
Optional secret used to generate an HMAC payload signature.
ownedBystringenum
Specifies webhook ownership: 'creator' delivers only to creator, 'org' delivers organization-wide.
creatororg
resourcestringObligatorioenum
The Webex resource to monitor. One of: messages, memberships, rooms, teams, team_memberships, meetings, meetingRecordings, meetingTranscripts.
messagesmembershipsroomsteamsteam_membershipsmeetingsmeetingRecordingsmeetingTranscripts
targetUrlanyObligatoriouri
The URL that will receive POST event notifications.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Delete WebhookWEBEX_WEBHOOKS_DELETE_WEBHOOKAcción

Tool to delete a specific webhook. use when you need to remove an existing webhook by its id after confirming the identifier.

Parámetros de entrada

webhookIdstringObligatorio
Unique identifier for the webhook to delete

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Webhook DetailsWEBEX_WEBHOOKS_GET_WEBHOOKAcción

Tool to get details for a specific webhook. use when you need to inspect a webhook's configuration before taking action.

Parámetros de entrada

webhookIdstringObligatorio
The unique identifier of the webhook to retrieve.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not