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

# Примеры Webhook

> Ознакомьтесь с пошаговыми руководствами по конкретным событиям webhook, предварительными требованиями и примерами полезной нагрузки.

<Note>Полный каталог, сформированный на основе схемы, см. в разделе [все примеры](/ru/api-reference/guides/examples/webhook-examples/webhook-payload-examples).</Note>

## Что это такое

Ознакомьтесь с пошаговыми руководствами по конкретным событиям webhook, предварительными требованиями и примерами полезной нагрузки.

## Перед началом работы

* Создайте публичную конечную точку HTTPS в своем приложении.
* Настройте конечную точку Webhook YCloud для необходимых типов событий.
* Надежно сохраните секретный ключ подписи конечной точки.
* Обеспечьте идемпотентность обработки событий.

## Как это работает

YCloud отправляет HTTP-запрос `POST` при возникновении события. Проверьте подпись, надежно сохраните событие, верните ответ `2xx` и выполняйте длительные операции асинхронно.

## Запрос

В приведенных ниже сценариях показаны запросы, отправляемые на ваш URL Webhook. Используйте событие `id` в качестве идентификатора доставки, а `type` — для маршрутизации полезной нагрузки.

## Ответ

Возвращайте статус `2xx` после успешного принятия события.

```http theme={"theme":{"light":"github-light","dark":"github-dark"}}
HTTP/1.1 200 OK
```

<Note>Информацию о настройке конечной точки, проверке подписи и логике повторных попыток см. в разделе [Настройка webhook](/ru/api-reference/guides/api-fundamentals/configure-webhooks).</Note>

## События сообщений и шаблонов

<CardGroup cols={2}>
  <Card title="Проверка шаблона" icon="rectangle-list" href="/ru/api-reference/guides/examples/webhook-examples/whatsapp-template-reviewed-webhook-examples">
    Обработка статусов шаблона: одобрен, отклонен, приостановлен, отключен и архивирован.
  </Card>

  <Card title="Статус сообщения" icon="message-check" href="/ru/api-reference/guides/examples/webhook-examples/whatsapp-message-updated-webhook-examples">
    Обработка отправленных, доставленных, прочитанных и недоставленных исходящих сообщений.
  </Card>

  <Card title="Входящие сообщения" icon="inbox" href="/ru/api-reference/guides/examples/webhook-examples/whatsapp-inbound-message-webhook-examples">
    Разбор текстовых, мультимедийных, геолокационных, контактных, интерактивных, коммерческих и системных сообщений.
  </Card>

  <Card title="Обновления платежей" icon="credit-card" href="/ru/api-reference/guides/examples/webhook-examples/whatsapp-payment-updated-webhook-examples">
    Обработка изменений платежных транзакций WhatsApp.
  </Card>
</CardGroup>

## События Echo и передачи оператору

Для операторов (Agents), подключенных через публичный REST API, используйте эти пошаговые руководства по конкретным событиям.
Для операторов, созданных через консоль, используется отдельный процесс синхронизации папки «Входящие».

<CardGroup cols={2}>
  <Card title="Создано эхо-сообщение (Echo message created)" icon="clone" href="/en/api-reference/guides/examples/webhook-examples/whatsapp-echo-message-created">
    Сохранение эхо-копий исходящих текстовых и мультимедийных сообщений.
  </Card>

  <Card title="Обновлено эхо-сообщение (Echo message updated)" icon="message-check" href="/en/api-reference/guides/examples/webhook-examples/whatsapp-echo-message-updated">
    Обработка обновлений статусов: доставлено, прочитано, отправлено с задержкой и произошел сбой.
  </Card>

  <Card title="Обновлена передача оператору (Agent handover updated)" icon="arrow-right-arrow-left" href="/en/api-reference/guides/examples/webhook-examples/whatsapp-meta-business-agent-handover-updated">
    Отслеживайте передачу управления и учитывайте ограничения ее корреляции.
  </Card>
</CardGroup>

## События аккаунта, приложения и Flow

<CardGroup cols={2}>
  <Card title="Обновления бизнес-аккаунта" icon="building" href="/ru/api-reference/guides/examples/webhook-examples/whatsapp-business-account-updated-webhook-examples">
    Обработка соответствия требованиям, локации, нарушений, ограничений и изменений состояния аккаунта.
  </Card>

  <Card title="История Business App" icon="clock-rotate-left" href="/ru/api-reference/guides/examples/webhook-examples/whatsapp-business-app-history-message-webhook-examples">
    Синхронизация истории входящих и исходящих сообщений.
  </Card>

  <Card title="Эхо-сообщения Business App" icon="clone" href="/ru/api-reference/guides/examples/webhook-examples/whatsapp-business-app-sent-message-sync-webhook-examples">
    Синхронизация сообщений, отправленных из WhatsApp Business App.
  </Card>

  <Card title="Статус Flow" icon="diagram-project" href="/ru/api-reference/guides/examples/webhook-examples/whatsapp-flow-webhook-examples">
    Обработка изменений статуса жизненного цикла Flow.
  </Card>
</CardGroup>

## События звонков и групп

<CardGroup cols={2}>
  <Card title="Подключение звонка" icon="phone" href="/ru/api-reference/guides/examples/webhook-examples/whatsapp-calling-connect-webhook-examples">
    Обработка предложений (offer) и ответов (answer) SDP для звонков в WhatsApp.
  </Card>

  <Card title="Статус звонка" icon="phone-volume" href="/ru/api-reference/guides/examples/webhook-examples/whatsapp-calling-status-update-webhook-examples">
    Обработка состояний звонка: вызов, принят и отклонен.
  </Card>

  <Card title="Завершение звонка" icon="phone-slash" href="/ru/api-reference/guides/examples/webhook-examples/whatsapp-calling-terminate-webhook-examples">
    Обработка успешного и неудавшегося завершения звонка.
  </Card>

  <Card title="Жизненный цикл группы" icon="users" href="/ru/api-reference/guides/examples/webhook-examples/whatsapp-group-lifecycle-update-webhook-examples">
    Обработка создания и удаления групп.
  </Card>

  <Card title="Участники группы" icon="user-plus" href="/ru/api-reference/guides/examples/webhook-examples/whatsapp-group-participants-update-webhook-examples">
    Обработка изменений списка участников и запросов на вступление.
  </Card>

  <Card title="Настройки группы" icon="users-gear" href="/ru/api-reference/guides/examples/webhook-examples/whatsapp-group-settings-update-webhook-examples">
    Обработка изменений темы и описания группы.
  </Card>

  <Card title="Статус группы" icon="circle-exclamation" href="/ru/api-reference/guides/examples/webhook-examples/whatsapp-group-status-update-webhook-examples">
    Обработка блокировки и восстановления группы.
  </Card>
</CardGroup>

## События контактов

<CardGroup cols={2}>
  <Card title="Контакт создан" icon="user-plus" href="/ru/api-reference/guides/examples/webhook-examples/contact-created-webhook-examples">
    Обработка вновь созданных контактов.
  </Card>

  <Card title="Контакт удален" icon="user-minus" href="/ru/api-reference/guides/examples/webhook-examples/contact-deleted-webhook-examples">
    Удаление или сверка удаленных контактов.
  </Card>

  <Card title="Атрибуты контакта изменены" icon="pen-to-square" href="/ru/api-reference/guides/examples/webhook-examples/contact-attributes-changed-webhook-examples">
    Обработка изменений профиля, пользовательских атрибутов и тегов.
  </Card>

  <Card title="Контакт отписался" icon="user-slash" href="/ru/api-reference/guides/examples/webhook-examples/contact-unsubscribe-created-webhook-examples">
    Обработка новых записей об отказе от рассылки (opt-out).
  </Card>

  <Card title="Контакт повторно подписался" icon="user-check" href="/ru/api-reference/guides/examples/webhook-examples/contact-unsubscribe-deleted-webhook-examples">
    Обработка удаленных записей об отказе от рассылки (opt-out).
  </Card>
</CardGroup>

<Card title="Открыть полный каталог полезных нагрузок" icon="brackets-curly" href="/ru/api-reference/guides/examples/webhook-examples/webhook-payload-examples">
  Ознакомьтесь со всеми типами событий и именованными примерами полезной нагрузки из спецификации OpenAPI.
</Card>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.