> ## Documentation Index
> Fetch the complete documentation index at: https://phidatainc-agui.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Webex

**WebexTools** enable an Agent to interact with Cisco Webex, allowing it to send messages and list rooms.

## Prerequisites

The following example requires the `webexpythonsdk` library and a Webex access token which can be obtained from [Webex Developer Portal](https://developer.webex.com/docs/bots).

To get started with Webex:

1. **Create a Webex Bot:**
   * Go to the [Developer Portal](https://developer.webex.com/)
   * Navigate to My Webex Apps → Create a Bot
   * Fill in the bot details and click Add Bot

2. **Get your access token:**
   * Copy the token shown after bot creation
   * Or regenerate via My Webex Apps → Edit Bot
   * Set as WEBEX\_ACCESS\_TOKEN environment variable

3. **Add the bot to Webex:**
   * Launch Webex and add the bot to a space
   * Use the bot's email (e.g. [test@webex.bot](mailto:test@webex.bot))

```shell theme={null}
uv pip install webexpythonsdk
```

```shell theme={null}
export WEBEX_ACCESS_TOKEN=your_access_token_here
```

## Example

The following agent will list all spaces and send a message using Webex:

```python cookbook/14_tools/webex_tool.py theme={null}
from agno.agent import Agent
from agno.tools.webex import WebexTools

agent = Agent(tools=[WebexTools()])

# List all spaces in Webex
agent.print_response("List all space on our Webex", markdown=True)

# Send a message to a Space in Webex
agent.print_response(
    "Send a funny ice-breaking message to the webex Welcome space", markdown=True
)
```

## Toolkit Params

| Parameter             | Type   | Default | Description                                                                                             |
| --------------------- | ------ | ------- | ------------------------------------------------------------------------------------------------------- |
| `access_token`        | `str`  | `None`  | Webex access token for authentication. If not provided, uses WEBEX\_ACCESS\_TOKEN environment variable. |
| `enable_send_message` | `bool` | `True`  | Enable sending messages to Webex spaces.                                                                |
| `enable_list_rooms`   | `bool` | `True`  | Enable listing Webex spaces/rooms.                                                                      |
| `all`                 | `bool` | `False` | Enable all functionality.                                                                               |

## Toolkit Functions

| Function       | Description                                                                                                     |
| -------------- | --------------------------------------------------------------------------------------------------------------- |
| `send_message` | Sends a message to a Webex room. Parameters: `room_id` (str) for the target room, `text` (str) for the message. |
| `list_rooms`   | Lists all available Webex rooms/spaces with their details including ID, title, type, and visibility settings.   |

## Developer Resources

* View [Tools](https://github.com/agno-agi/agno/blob/main/libs/agno/agno/tools/webex.py)