whatsapp.call.transcription.updated

Usa whatsapp.call.transcription.updated para gestionar este evento en tu endpoint de webhook.

Disparadores

Se produce cuando una transcripción de llamada de WhatsApp iniciada por API pasa a estar disponible o falla permanentemente. Suscríbete a whatsapp.call.transcription.updated cuando configures tu endpoint de webhook. Este evento informa un estado terminal para un recurso multimedia de llamada originado por API. Usa mediaAssetId con la API de descarga de archivos multimedia de llamadas cuando status sea AVAILABLE. Inspecciona error cuando status sea FAILED.

Sintaxis

YCloud envía una solicitud HTTP POST a la URL de webhook que hayas configurado. La siguiente estructura muestra una variante del payload. Los valores entre corchetes angulares son marcadores de posición; sus tipos se enumeran en Parámetros. Los campos opcionales y otras variantes se describen a continuación.

{
  "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>"
    }
  }
}

Parámetros

Valida el encabezado HTTP YCloud-Signature antes de procesar el cuerpo JSON. Consulta la validación de firmas.

Envoltura del evento

Parámetro	Tipo	Obligatorio	Descripción
`id`	string	Sí	ID único del evento. Longitud mínima: `6`. Longitud máxima: `128`.
`type`	string	Sí	Siempre `whatsapp.call.transcription.updated`.
`apiVersion`	string	Sí	La versión de la API utilizada para generar este evento.
`createTime`	string (date-time)	Sí	La fecha y hora en que se creó este evento, formateada en RFC 3339. Por ejemplo, `2022-06-01T12:00:00.000Z`.

Payload del evento

Parámetro	Tipo	Obligatorio	Descripción
`callingTranscription`	object	No	Payload específico del evento `callingTranscription`.

Los cuatro campos comunes de la envoltura son obligatorios. Los campos del payload dependen de la variante del evento. En cada tabla de objetos, Obligatorio se aplica cuando su objeto superior está presente. Los campos opcionales pueden omitirse; un ejemplo no hace que un campo sea obligatorio.

callingTranscription

Parámetro	Tipo	Obligatorio	Descripción
`wacid`	string	Sí	ID de llamada de WhatsApp.
`phoneId`	string	Sí	ID del número de teléfono comercial de WhatsApp utilizado para la entrega de recursos autorizados.
`mediaAssetId`	string	Sí	ID del recurso multimedia de YCloud utilizado con la API de descarga de archivos multimedia de llamadas.
`status`	string	Sí	Valores: `AVAILABLE`, `FAILED`.
`error`	object	No	Solo está presente cuando `status` es `FAILED`.

callingTranscription.error

Parámetro	Tipo	Obligatorio	Descripción
`code`	string	Sí	Código de error estable.
`retryable`	boolean	Sí	Indica si reintentar la operación multimedia ascendente podría tener éxito.

Ejemplo

El siguiente JSON es el cuerpo entregado a tu receptor. Los ID, números de teléfono y otros valores de cuenta son ilustrativos. Ejemplo de payload cuando una transcripción de llamada iniciada por API falla permanentemente

{
  "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
    }
  }
}

Después de verificar la firma y aceptar el evento de forma duradera, devuelve una respuesta 2xx. Procesa las tareas lentas de forma asíncrona.

HTTP/1.1 200 OK

Para ver descripciones paso a paso de situaciones prácticas, consulta los ejemplos comentados.

Primeros pasos

Guías

Endpoints

Webhook reference

whatsapp.call.transcription.updated

Disparadores

Sintaxis

Parámetros

Envoltura del evento

Payload del evento

callingTranscription

Ejemplo

​Disparadores

​Sintaxis

​Parámetros

​Envoltura del evento

​Payload del evento

​callingTranscription

​Ejemplo

Disparadores

Sintaxis

Parámetros

Envoltura del evento

Payload del evento

callingTranscription

Ejemplo