Skip to content

Conversation

@Lafetz
Copy link

@Lafetz Lafetz commented Dec 19, 2025

Description

Adds documentation for the Cisco Webex connector, including setup instructions, supported actions, and supported objects from the Admin

Screenshot

Screenshot from 2025-12-19 22-03-56

@Cobalt0s Cobalt0s changed the title feat: add doc for cisco-webex [CON-2760] feat: Add Cisco Webex Dec 22, 2025
Copy link
Collaborator

@Cobalt0s Cobalt0s left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

Copy link
Contributor

@laurenzlong laurenzlong left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

A few thoughts:

  • this provider should simply called webex, not ciscoWebex, since webex is a recognizable name, and we prefer shorter and simpler provider names where-ever possible
  • this doc doesn't have any screenshots or gifs that show users how to create the Webex app

@Cobalt0s
Copy link
Collaborator

A few thoughts:

  • this provider should simply called webex, not ciscoWebex, since webex is a recognizable name, and we prefer shorter and simpler provider names where-ever possible
  • this doc doesn't have any screenshots or gifs that show users how to create the Webex app

Ok, I knew about the shorter naming, but I thought it would be important to include Cisco. My bad.

@Lafetz Lafetz force-pushed the add-cisco-webex-docs branch from 9cf5952 to 14c499c Compare December 26, 2025 20:24
@Lafetz
Copy link
Author

Lafetz commented Dec 26, 2025

A few thoughts:

  • this provider should simply called webex, not ciscoWebex, since webex is a recognizable name, and we prefer shorter and simpler provider names where-ever possible
  • this doc doesn't have any screenshots or gifs that show users how to create the Webex app

Changes made, thanks for the guidance. Let me know if the GIF look good or if anything else needs adjusting.


9. Click **Add Integration**.

![Alt text](/images/provider-guides/webex.gif)
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The gif is missing the mouse cursor so in the first steps it looks like jumping. But that is my preference.

- [events](https://developer.webex.com/docs/api/v1/events/list-events) (Read only)
- [organizations](https://developer.webex.com/docs/api/v1/organizations/list-organizations) (Read only)
- [reports](https://developer.webex.com/admin/docs/api/v1/reports/list-reports) (Read only)
- [meetings](https://developer.webex.com/meeting/docs/meetings) (Read,Write)
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think meetings can be accessed with ordinary user level account.
Some objects require organization-level admin scopes, while others can be accessed with user-level scopes. I think we should mention this in some way.

Admin API is a superset. Maybe there are some Webex docs that we can point out customers to decide what account type do they need. You have a <Note> below which is helpful.

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

(Read,Write) is missing space, unlike other lines.

### Creating a Webex Integration

<Note>
The Admin Suite integration requires organization-level access in Cisco Webex.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

As per the comment above, maybe link some docs about Admin Suite integration.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants