Registrar CSAT de ligação

POST

{{baseURL}}/api/v3/telephony/csat

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

Registra a nota de satisfação de uma ligação, identificada pelo uniqueid da chamada (o mesmo call_id usado no anexo de gravação).

A nota é gravada no CRM, vinculada ao cliente do ticket. Reenvio para a mesma ligação sobrescreve a avaliação anterior em vez de criar outra.

Pré-condições

Três condições precisam estar satisfeitas, senão a chamada falha:

Condição	Falha
A ligação precisa já ter sido registrada (o `uniqueid` vira `external_id` do protocolo)	404
O ticket precisa ter cliente vinculado — ou seja, o ticket foi criado com o bloco `crm`	400
O ticket precisa ter responsável — o que só acontece quando um agente assume o ticket	400

Por isso, num fluxo de telefonia de terceiros, chame o CSAT por último, depois do anexo de gravação.

Limite de 30 requisições por minuto, agregado por instância.

Requisição

Parâmetros Header

Parâmetros Bodyapplication/jsonObrigatório

Examples

nota com comentáriosó a nota

{
    "uniqueid": "1772743063.6136820",
    "nota": 5,
    "resposta_aberta": "Atendimento rápido"
}

Códigos de solicitação

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

cURL

nota com comentáriosó a nota

curl --location --globoff 'https://api-{tenant}.digitalk.com.br/api/v3/telephony/csat' \
--header 'api-key: API_TOKEN (disponível no database da plataforma)' \
--header 'Content-Type: application/json' \
--data '{
    "uniqueid": "1772743063.6136820",
    "nota": 5,
    "resposta_aberta": "Atendimento rápido"
}'

Respostas

🟢200OK

application/json

Avaliação registrada (ou atualizada, se já existia uma para o mesmo atendimento).

Bodyapplication/json

Exemplo

{
    "ok": true,
    "message": "Avaliação registrada com sucesso.",
    "ticket_id": "84cefe00-761e-467c-9f77-fbb05ecb7af9",
    "action": "insert"
}

🟠400Requisição Inválida

🟠401Não Autorizado

🟠404Não Encontrado

🟠429Limite Excedido

🔴500Erro Interno

🔴502Erro no Serviço

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

Página anterior

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

Próxima página

Consultar status da gravação enviada

Registrar CSAT de ligação

Pré-condições#

Requisição

Códigos de solicitação

Respostas

Pré-condições