whatsapp.call.transcription.updated

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

Триггеры

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

Синтаксис

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

{
  "id": "<ID>",
  "type": "whatsapp.call.transcription.updated",
  "apiVersion": "<API_VERSION>",
  "createTime": "<CREATE_TIME>",
  "callingTranscription": {
    "wacid": "<WACID>",
    "phoneId": "<PHONE_ID>",
    "mediaAssetId": "<MEDIA_ASSET_ID>",
    "status": "<STATUS>",
    "error": {
      "code": "<CODE>",
      "retryable": "<RETRYABLE_VALUE>"
    }
  }
}

Параметры

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

Конверт события

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

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

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

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

callingTranscription

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

callingTranscription.error

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

Пример

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

{
  "id": "evt_call_transcription_01JZ8K5A9C4D7E0F3G6H9J2K5M",
  "type": "whatsapp.call.transcription.updated",
  "apiVersion": "v2",
  "createTime": "2026-08-04T08:01:00.000Z",
  "callingTranscription": {
    "wacid": "wacid.HBgNNjI4MTM2MTkwNTEzMxUCABE",
    "phoneId": "461269257068832",
    "mediaAssetId": "66b1f0d9e4b05c2d8f1a3b48",
    "status": "FAILED",
    "error": {
      "code": "CALLING_TRANSCRIPTION_PROCESSING_FAILED",
      "retryable": false
    }
  }
}

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

HTTP/1.1 200 OK

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

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

Руководства

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

Webhook reference

whatsapp.call.transcription.updated

Триггеры

Синтаксис

Параметры

Конверт события

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

callingTranscription

Пример

​Триггеры

​Синтаксис

​Параметры

​Конверт события

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

​callingTranscription

​Пример

Триггеры

Синтаксис

Параметры

Конверт события

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

callingTranscription

Пример