whatsapp.call.recording.updated

Используйте whatsapp.call.recording.updated для обработки этого события на вашей конечной точке Webhook.

Триггеры

Происходит, когда запись звонка WhatsApp, инициированного через API, становится доступной или завершается неустранимой ошибкой. Подпишитесь на whatsapp.call.recording.updated, когда будете настраивать конечную точку Webhook. Это событие сообщает о конечном состоянии медиаресурса звонка, инициированного через API. Используйте mediaAssetId с API загрузки медиа звонка, когда status имеет значение AVAILABLE. Проверьте error, когда status имеет значение FAILED.

Синтаксис

YCloud отправляет HTTP-запрос POST на ваш настроенный URL-адрес Webhook. Следующая структура демонстрирует один из вариантов полезной нагрузки. Значения в угловых скобках являются заполнителями; их типы перечислены в разделе Параметры. Необязательные поля и другие варианты описаны ниже.

{
  "id": "<ID>",
  "type": "whatsapp.call.recording.updated",
  "apiVersion": "<API_VERSION>",
  "createTime": "<CREATE_TIME>",
  "callingRecording": {
    "wacid": "<WACID>",
    "phoneId": "<PHONE_ID>",
    "mediaAssetId": "<MEDIA_ASSET_ID>",
    "status": "<STATUS>"
  }
}

Параметры

Проверьте HTTP-заголовок YCloud-Signature перед обработкой тела JSON. См. раздел проверка подписи.

Оболочка события

Параметр	Тип	Обязательный	Описание
`id`	string	Да	Уникальный идентификатор события. Минимальная длина: `6`. Максимальная длина: `128`.
`type`	string	Да	Всегда `whatsapp.call.recording.updated`.
`apiVersion`	string	Да	Версия API, использованная для формирования этого события.
`createTime`	string (date-time)	Да	Время создания этого события в формате RFC 3339. Например, `2022-06-01T12:00:00.000Z`.

Полезная нагрузка события

Параметр	Тип	Обязательный	Описание
`callingRecording`	object	Нет	Полезная нагрузка `callingRecording`, специфичная для события.

Четыре общих поля оболочки являются обязательными. Поля полезной нагрузки зависят от варианта события. В каждой таблице объектов статус Обязательный применяется, когда присутствует его родительский объект. Необязательные поля могут быть опущены; наличие поля в примере не делает его обязательным.

callingRecording

Параметр	Тип	Обязательный	Описание
`wacid`	string	Да	Идентификатор звонка WhatsApp.
`phoneId`	string	Да	Идентификатор бизнес-номера телефона WhatsApp, используемый для доставки авторизованных ресурсов.
`mediaAssetId`	string	Да	Идентификатор медиаресурса YCloud, используемый с API загрузки медиа звонка.
`status`	string	Да	Значения: `AVAILABLE`, `FAILED`.
`error`	object	Нет	Присутствует только тогда, когда `status` имеет значение `FAILED`.

callingRecording.error

Параметр	Тип	Обязательный	Описание
`code`	string	Да	Постоянный код ошибки.
`retryable`	boolean	Да	Указывает, может ли повторная попытка вышестоящей операции с медиа завершиться успешно.

Пример

Следующий фрагмент JSON представляет собой тело запроса, доставляемое вашему получателю. Идентификаторы, номера телефонов и другие значения учетной записи приведены для наглядности. Пример полезной нагрузки, когда запись звонка, инициированного через API, становится доступной

{
  "id": "evt_call_recording_01JZ8K4V7H3P6Q9R2T5W8X1Y4Z",
  "type": "whatsapp.call.recording.updated",
  "apiVersion": "v2",
  "createTime": "2026-08-04T08:00:00.000Z",
  "callingRecording": {
    "wacid": "wacid.HBgNNjI4MTM2MTkwNTEzMxUCABE",
    "phoneId": "461269257068832",
    "mediaAssetId": "66b1f0c2e4b05c2d8f1a3b47",
    "status": "AVAILABLE"
  }
}

После проверки подписи и надежного сохранения события верните ответ 2xx. Длительные операции обрабатывайте асинхронно.

HTTP/1.1 200 OK

Сценарии использования см. в разделе примеры с пояснениями.

Начало работы

Руководства

Конечные точки

Webhook reference

whatsapp.call.recording.updated

Триггеры

Синтаксис

Параметры

Оболочка события

Полезная нагрузка события

callingRecording

Пример

​Триггеры

​Синтаксис

​Параметры

​Оболочка события

​Полезная нагрузка события

​callingRecording

​Пример

Триггеры

Синтаксис

Параметры

Оболочка события

Полезная нагрузка события

callingRecording

Пример