> ## Documentation Index
> Fetch the complete documentation index at: https://docs.keephq.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Zoom Chat

> Zoom Chat provider allows you to send Zoom Chats using the Incoming Webhook Zoom application.

<Tip>
  For this integration, you will need to add and configure the Incoming Webhook application from the Zoom App Marketplace: [https://marketplace.zoom.us/apps/eH\_dLuquRd-VYcOsNGy-hQ](https://marketplace.zoom.us/apps/eH_dLuquRd-VYcOsNGy-hQ)
</Tip>

## Authentication

This provider requires authentication.

* **webhook\_url**: Zoom Incoming Webhook Full Format Url (required: True, sensitive: True)
* **authorization\_token**: Incoming Webhook Authorization Token (required: True, sensitive: True)
* **account\_id**: Zoom Account ID (required: False, sensitive: True)
* **client\_id**: Zoom Client ID (required: False, sensitive: True)
* **client\_secret**: Zoom Client Secret (required: False, sensitive: True)

Certain scopes may be required to perform specific actions or queries via the provider. Below is a summary of relevant scopes and their use cases:

* **user:read:user:admin**: View a Zoom user's details
* **user:read:list\_users:admin**: List Zoom users

## In workflows

This provider can be used in workflows.

As "action" to make changes or update data, example:

```yaml theme={null}
actions:
    - name: Query zoom_chat
      provider: zoom_chat
      config: "{{ provider.my_provider_name }}"
      with:
        severity: {value}  # The severity of the alert.
        title: {value}  # The title to use for the message. (optional)
        message: {value}  # The text message to send. Supports Markdown formatting.
        tagged_users: {value}  # A list of Zoom user email addresses to tag. (optional)
        details_url: {value}  # A URL linking to more information. (optional)
```

Check the following workflow example:

* [zoom\_chat\_example.yml](https://github.com/keephq/keep/blob/main/examples/workflows/zoom_chat_example.yml)

## Connecting with the Provider

### Enable the Incoming Webhook Application

The Incoming Webhook application is available in the Zoom App Marketplace.

<Frame width="100" height="200">
  <img height="10" src="https://mintcdn.com/keep-docs/ClZI9_krJzVDBqPb/images/zoom_chat-provider1.png?fit=max&auto=format&n=ClZI9_krJzVDBqPb&q=85&s=b2f1827ad64c4b21650af447efbdbc1f" data-path="images/zoom_chat-provider1.png" />
</Frame>

<Frame width="100" height="200">
  <img height="10" src="https://mintcdn.com/keep-docs/ClZI9_krJzVDBqPb/images/zoom_chat-provider2.png?fit=max&auto=format&n=ClZI9_krJzVDBqPb&q=85&s=f1154a3963db77636368dc3f20823bda" data-path="images/zoom_chat-provider2.png" />
</Frame>

### Create Team Chat Channel:

This channel will be the recipient of the Keep notifications.

<Frame width="100" height="200">
  <img height="10" src="https://mintcdn.com/keep-docs/ClZI9_krJzVDBqPb/images/zoom_chat-provider3.png?fit=max&auto=format&n=ClZI9_krJzVDBqPb&q=85&s=eaad42b59fc5b23cc3df11cc3caf070d" data-path="images/zoom_chat-provider3.png" />
</Frame>

<Frame width="100" height="200">
  <img height="10" src="https://mintcdn.com/keep-docs/ClZI9_krJzVDBqPb/images/zoom_chat-provider4.png?fit=max&auto=format&n=ClZI9_krJzVDBqPb&q=85&s=2d88ea4dc23c1ec7ae4b91677b576dd3" data-path="images/zoom_chat-provider4.png" />
</Frame>

### Enable the Incoming Webhook Application

Send `/inc connect <connection name>` to the channel to enable a webhook with authorization code. The app will respond with the webhook url and authorization code.

<Tip>
  You should use the "Full Format" Incoming Webhook Url, which ends in `?format=full`.
</Tip>

<Frame width="100" height="200">
  <img height="10" src="https://mintcdn.com/keep-docs/ClZI9_krJzVDBqPb/images/zoom_chat-provider5.png?fit=max&auto=format&n=ClZI9_krJzVDBqPb&q=85&s=a40bb2204dd74d47ff03518479e8dac4" data-path="images/zoom_chat-provider5.png" />
</Frame>

<Frame width="100" height="200">
  <img height="10" src="https://mintcdn.com/keep-docs/ClZI9_krJzVDBqPb/images/zoom_chat-provider6.png?fit=max&auto=format&n=ClZI9_krJzVDBqPb&q=85&s=025db84adc6fd4376c1a83a935ef6645" data-path="images/zoom_chat-provider6.png" />
</Frame>

## (Optional) Enabling User JID Lookup

Messages can optionally include Zoom user JIDs, which are used to tag a particular Zoom user in a message.
This is useful, for example, if a team subscribes to a chat channel but members only wish to be notified when they are explicitly tagged.

### Create a Zoom Application

User lookup requires authorization. Create an internal only, Zoom Server to Server OAuth application.

<Frame width="100" height="200">
  <img height="10" src="https://mintcdn.com/keep-docs/ClZI9_krJzVDBqPb/images/zoom_chat-provider7.png?fit=max&auto=format&n=ClZI9_krJzVDBqPb&q=85&s=9f1585425a00bb671e33498f3aa15932" data-path="images/zoom_chat-provider7.png" />
</Frame>

<Frame width="100" height="200">
  <img height="10" src="https://mintcdn.com/keep-docs/ClZI9_krJzVDBqPb/images/zoom_chat-provider8.png?fit=max&auto=format&n=ClZI9_krJzVDBqPb&q=85&s=dc42457330fa43afcbf14c5493bb15d1" data-path="images/zoom_chat-provider8.png" />
</Frame>

### Assign Required Scopes

<Frame width="100" height="200">
  <img height="10" src="https://mintcdn.com/keep-docs/ClZI9_krJzVDBqPb/images/zoom_chat-provider9.png?fit=max&auto=format&n=ClZI9_krJzVDBqPb&q=85&s=375ac8b34a62d71d241825931e4a2d45" data-path="images/zoom_chat-provider9.png" />
</Frame>

<Frame width="100" height="200">
  <img height="10" src="https://mintcdn.com/keep-docs/ClZI9_krJzVDBqPb/images/zoom_chat-provider10.png?fit=max&auto=format&n=ClZI9_krJzVDBqPb&q=85&s=fbef6dd4ed99b4bfeb0009e74a22cdd7" data-path="images/zoom_chat-provider10.png" />
</Frame>