Anexar gravação de ligação (telefonia de terceiros)

Registra a gravação de uma ligação feita em PABX próprio do parceiro e anexa o áudio dentro do ticket, reproduzível pelo agente.

A Digitalk baixa o arquivo da URL informada, re-hospeda no storage do tenant e cria a mensagem de áudio no ticket — depois disso a gravação não depende mais da infraestrutura do parceiro.

Fluxo

POST /api/v2/ticket/custom cria o ticket e devolve o id (no topo da resposta, sem envelope).

Este endpoint recebe esse id em ticket_id, junto do identificador da chamada e da URL da gravação.

Resposta 202, não 200

O 202 significa aceito e enfileirado, não "áudio já disponível". O download é assíncrono.

Cuidados

Ponto	Regra
Validade da URL	Precisa continuar acessível por ~20 minutos. A primeira tentativa ocorre ~15s após o 202, e em caso de falha há mais 19 tentativas de minuto em minuto
Query string	Suportada, desde que a extensão venha antes da `?`. `.../call.mp3?sig=abc` funciona; `.../download?file=call` não
Reenvio	Seguro com o mesmo `call_id`: não gera áudio duplicado. Enquanto o download está pendente, o reenvio devolve 202 mas não troca a URL do job em curso; depois de falha definitiva, reprocessa com a URL nova
Identidade da chamada	O `call_id` é a identidade da ligação no tenant. Reaproveitar um `call_id` já usado em outro ticket devolve 422 — proteção contra anexar áudio no atendimento errado
Ligação sem gravação	`recording_url` é obrigatória. Para registrar ligação sem áudio, use uma nota no ticket (`POST /api/v2/ticket/message` com `is_note: true`)
Rede interna	URLs apontando para endereço privado, loopback ou link-local são recusadas
Tamanho	Teto de 100 MB (~1h45 de wav 8 kHz mono). Acima disso o download é abortado e o áudio não entra no ticket — o 202 já terá sido devolvido

Requisição

Parâmetros Header

Parâmetros Bodyapplication/jsonObrigatório

Examples

ligação atendida — anexar gravaçãopayload mínimo (só os obrigatórios)gravação de secretária eletrônica

{
    "call_id": "1772743063.6136820",
    "ticket_id": "84cefe00-761e-467c-9f77-fbb05ecb7af9",
    "recording_url": "https://gravacoes.parceiro.com.br/2026/09/22/call-1772743063.mp3?X-Amz-Signature=abc",
    "phone": "5511988884444",
    "dial_status": "ANSWER",
    "ramal": "5056"
}

Códigos de solicitação

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Respostas

🟢202Aceito

application/json

Gravação aceita e enfileirada para download. O áudio aparece no ticket em alguns minutos.

Bodyapplication/json

Exemplo

{
    "ok": true,
    "message": "Gravação aceita. O áudio aparecerá no ticket em alguns minutos.",
    "call_id": "1772743063.6136820",
    "ticket_id": "84cefe00-761e-467c-9f77-fbb05ecb7af9"
}

🟠400Requisição Inválida

🟠401Não Autorizado

🟠422Não Processável

🟠429Limite Excedido

🔴500Erro Interno