> For the complete documentation index, see [llms.txt](https://docs.cekat.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cekat.ai/en/developer-tools/webhook-integration.md).

# Webhook Integration

## Open Devtools

1. Click **App Launcher** (the grid icon) in the **app bar** at the top of the screen.
2. Under **Your Products**, select **Devtools**. It opens as a tab in the app bar.
3. Use the Devtools sidebar to select **API Keys**, **Webhooks**, or **API Tools**. The **Activity** section contains API message logs, and **API Documentation** opens the API reference.

![Devtools in the App Launcher and its sidebar navigation](https://3748649913-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzFvvakHJ5OVubOo4WKlR%2Fuploads%2FQEWjiTTZ1C6lz7w4FHoG%2Fdevtools-app-bar.png?alt=media)

The **Webhook** feature in Cekat AI lets you receive real-time data about user activity on the Cekat platform, such as when a new chat comes in, a conversation is resolved, or another status changes. With webhooks, you can connect Cekat AI to your own internal systems, like your CRM, notification system or company database.

**How to access webhooks**

1. Open **App Launcher → Devtools** from the app bar.
2. Select **Webhooks** under **Integration**.
3. Select **Create webhook** to create a new webhook.

![Webhook list with enabled and disabled Status toggles](https://3748649913-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzFvvakHJ5OVubOo4WKlR%2Fuploads%2FqACZhUOTYUI3TcBExAtA%2Fwebhook-list-status.png?alt=media)

## Edit a webhook

1. Open **App Launcher → Devtools → Webhooks**.
2. Open the webhook you want to change. The **Webhook Detail** page opens.
3. Update **Webhook Name**, **Remote webhook URL**, the **Connected Platforms** filter, or your selections under **Events To Notify**.
4. Click **Save Webhook** to apply your changes.

From **Webhook Detail**, you can also pause or resume delivery using the **Status** toggle, or delete the webhook using the trash icon.

## Webhook capabilities

* **Custom endpoint.** Enter the HTTPS endpoint that should receive notifications from Cekat in **Remote webhook URL**.
* **Optional platform filter.** Select a platform under **Connected Platforms** to limit notifications to that platform. Leave the filter empty to receive selected events from any connected platform.
* **Event selection.** Under **Events To Notify**, select the events you want to receive. Cekat groups events by category. Here are a few examples.

| Category           | Event                                              | When Cekat sends a notification                                                       |
| ------------------ | -------------------------------------------------- | ------------------------------------------------------------------------------------- |
| Messages           | `Message.received`                                 | A new message arrives from a contact.                                                 |
| Messages           | `Message.sent`                                     | A message is sent to a contact.                                                       |
| Messages           | `Message.failed`                                   | A message fails to send.                                                              |
| Conversations      | `Conversation.created`                             | A new conversation is created.                                                        |
| Conversations      | `Conversation.stage_status_updated`                | A conversation stage status changes.                                                  |
| Customer responses | `Conversation.customer_first_response_human_stage` | The customer replies for the first time while the conversation is in the human stage. |
| Contacts           | `Contact.created`                                  | A new contact is created.                                                             |
| Contacts           | `Contact.updated`                                  | A contact is updated.                                                                 |
| AI & notes         | `Ai_summary.generated`                             | Someone uses **Generate AI Summary** in a conversation.                               |
| AI & notes         | `Conversation_note.created`                        | Someone adds a note to a conversation.                                                |
| AI & notes         | `Conversation_note.updated`                        | Someone edits a conversation note.                                                    |
| Templates          | `Template.status_updated`                          | A message template’s status changes.                                                  |

See **Events To Notify** for the full list of available events.

## Enable or disable a webhook

You can enable or disable each webhook directly from the webhook list using the toggle in the **Status** column.

1. Open **App Launcher → Devtools → Webhooks**.
2. Find the webhook you want to manage.
3. In the **Status** column, switch the toggle:
   * **On (blue):** enable the webhook to send notifications for its configured events.
   * **Off (gray):** disable the webhook to stop sending notifications to its endpoint.

When a webhook is disabled, Cekat sends an in-app notification and an email. You can manage both channels in **Notification Settings**.

You can enable the webhook again when you want to resume event delivery. This lets you pause an integration without deleting and recreating the webhook.
