Consultar status da gravação enviada

GET

{{baseURL}}/api/v3/telephony/recording/{call_id}

Última modificação:2026-09-23 17:02:27

Informa o desfecho de um envio feito em POST /api/v3/telephony/recording.

Aquele endpoint responde 202 (aceito e enfileirado) e o download acontece depois — sem esta consulta não há como distinguir "áudio no ticket" de "falhou em silêncio". Falha de download, arquivo acima do teto de 100 MB e destino recusado são todos invisíveis para quem enviou.

Uma consulta cerca de um minuto após o envio resolve a maioria dos casos.

Valores de `status`

Valor	Significado	Ação
`delivered`	O áudio está no ticket. `message_id` identifica a mensagem	Nenhuma
`pending`	Download em andamento; `attempts` traz o número de tentativas	Consultar novamente depois
`failed`	O download falhou; `reason` traz o motivo	Reenviar a gravação com URL válida
`unknown`	O download terminou mas a entrega no ticket não foi confirmada, ou o registro do envio já saiu da retenção	Reenviar a gravação

A consulta divide o teto de 120 req/min com o envio de gravação. Espace o polling.

Requisição

Parâmetros de Caminho

Parâmetros Header

Códigos de solicitação

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --globoff 'https://api-{tenant}.digitalk.com.br/api/v3/telephony/recording/1772743063.6136820' \
--header 'api-key: API_TOKEN (disponível no database da plataforma)'

Respostas

🟢200OK

application/json

Status conhecido para o call_id.

Bodyapplication/json

Examples

áudio disponível no ticketdownload em andamentodownload falhou — reenviar

{
    "ok": true,
    "message": "Gravação disponível no ticket.",
    "call_id": "1772743063.6136820",
    "status": "delivered",
    "message_id": "91823"
}

🟠400Requisição Inválida

🟠401Não Autorizado

🟠404Não Encontrado

🟠429Limite Excedido

🔴500Erro Interno

Modificado em 2026-09-23 17:02:27

Página anterior

Registrar CSAT de ligação

Próxima página

Listar templates HSM (a tela Templates › WhatsApp oficial)

Consultar status da gravação enviada

Valores de status#

Requisição

Códigos de solicitação

Respostas

Valores de `status`