O que é o QA Analytics
O QA Analytics é uma plataforma de auditoria de atendimento assistida por IA. Ela recebe as conversas e ligações de uma operação de atendimento, e a MAIA — a inteligência artificial do produto — faz o trabalho que um time de qualidade faria à mão:
- lê a conversa inteira, transcrevendo áudio quando preciso;
- classifica o sentimento e aponta os momentos de tensão;
- audita o atendimento contra um checklist configurado pelo cliente, critério a critério, citando o trecho da conversa que sustenta cada resposta;
- registra não conformidades — graves ou brandas — com evidência;
- calcula uma nota;
- escreve um resumo para o supervisor;
- consolida tudo em relatórios por período, equipe ou atendente.
Tudo isso acontece sem amostragem: toda interação recebida é analisada.
O papel do parceiro
Você não configura checklist, não vê nota e não lê relatório — isso é do cliente, na tela dele.
Entregar as interações. Uma chamada HTTP no momento certo, com a conversa inteira e uma chave de conta. Esta documentação é sobre como fazer isso direito.
Em duas linhas de código conceitual:
POST {BASE_URL}/api/v1/interacoes/ingestao/whatsapp
X-Api-Key: <chave-da-conta>
O resto — transcrever, analisar, auditar, pontuar, resumir — acontece do lado de cá, de forma assíncrona, depois que a sua chamada já recebeu resposta.
Quando enviar
| Canal | Gatilho | Endpoint |
|---|---|---|
| Ligação (voz) | Imediatamente após o operador desligar | POST /ingestao/voz |
| WhatsApp / chat | Quando o operador tabula (encerra) o atendimento | POST /ingestao/whatsapp |
| WhatsApp / chat | Quando a conversa fica ociosa por 2 a 3 dias sem nova mensagem | POST /ingestao/whatsapp com parcial: true |
Quem observa o tempo passar é você, não o QA Analytics. A plataforma não acompanha o estado do chat na origem — ela recebe o webhook quando você decide que é hora.
Se a conversa enviada por ociosidade continuar depois, você envia de novo, com a conversa completa. A plataforma entende que é uma continuação e audita a versão nova sem perder a antiga. Isso está em Conversa que continuou.
Por onde começar a ler
- Como o sistema funciona — o caminho que uma interação percorre. Vale ler antes do contrato: várias regras só fazem sentido à luz dele.
- Autenticação — a chave da conta e o que acontece quando ela roda.
- Enviar uma conversa — o caso mais comum, com payload completo.
- Checklist de go-live — o que conferir antes de produção.
Uma promessa sobre este contrato
Alterações serão sempre aditivas: campos novos, sempre opcionais. Um campo nunca é removido nem passa a ser obrigatório dentro da mesma versão. Quando algo assim for inevitável, nasce uma versão nova do contrato e as duas ficam no ar até o último parceiro migrar — o seletor de versão no topo desta página é isso.