Registrar CSAT de ligação

POST

/api/v3/telephony/csat

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

Respostas

🟢200OK

application/json

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

Bodyapplication/json

🟠400Requisição Inválida

🟠401Não Autorizado

🟠404Não Encontrado

🟠429Limite Excedido

🔴500Erro Interno

🔴502Erro no Serviço

Request Example

Shell

JavaScript

Java

Swift

cURL

nota com comentáriosó a nota

curl --location '/api/v3/telephony/csat' \
--header 'api-key: {{api-key}}' \
--header 'Content-Type: application/json' \
--data '{
    "uniqueid": "1772743063.6136820",
    "nota": 5,
    "resposta_aberta": "Atendimento rápido"
}'

Response Example

200 - Exemplo de Sucesso

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

Modificado em 2026-11-04 02:31:07

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

Respostas

Pré-condições