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

# Chat Assigned webhook

> Receive a real-time callback whenever a chat is assigned.

The **Chat Assigned** webhook notifies your systems the moment a chat is assigned to a user, so you can react in real time — route work, update a CRM, or trigger a follow-up.

## How it works

When a chat is assigned in Clapvo, we send an HTTP `POST` request to the endpoint URL you configure. Your endpoint should respond quickly with a `2xx` status code to acknowledge receipt.

## Configure the webhook

<Steps>
  <Step title="Open the Developer section">
    Go to the **Developer** section in Clapvo, where you manage API tokens and webhooks.
  </Step>

  <Step title="Add a webhook endpoint">
    Enter the HTTPS URL where Clapvo should send the event.
  </Step>

  <Step title="Subscribe to Chat Assigned">
    Select the **Chat Assigned** event.
  </Step>

  <Step title="Save">
    Clapvo starts delivering the event to your endpoint.
  </Step>
</Steps>

## Verify and respond

* Your endpoint must be reachable over HTTPS.
* Return a `2xx` status code to acknowledge the event.
* If your endpoint returns an error or times out, delivery is considered failed.

<Warning>
  Treat the endpoint URL as sensitive. Only accept webhook traffic on an endpoint you control.
</Warning>

## Related

* [Authentication](/docs/api-reference/authentication)
* [Assign a kanban stage](/docs/product/chats/assign-stage)