Glossário
Os termos desta documentação, da tela do cliente e dos chamados de suporte.
Da integração
Interação : Uma ligação ou uma conversa de chat, do início ao fim — ou até onde chegou. É a unidade que a plataforma audita e que conta no limite de uso do cliente.
Ingestão
: O ato de enviar uma interação à plataforma. O nome dos endpoints (/interacoes/ingestao/...).
Chave externa (chaveExterna)
: O identificador da interação no sistema de origem — id do chat, id do bilhete, número do protocolo.
Base da idempotência. Ver Idempotência.
Chave de ingestão
: A credencial da conta, enviada no header X-Api-Key. Uma por cliente, exibida uma única vez.
Ver Autenticação.
Idempotência : A garantia de que reenviar a mesma interação não cria duplicata nem cobra de novo.
Duplicata
: Reenvio cujo conteúdo é idêntico ao que já está gravado. Devolve 200, não cria nada, não cobra.
Parcial : Conversa enviada antes de terminar — o caso da ociosidade. É o que permite complementá-la depois.
Reingestão
: Reenvio de uma conversa parcial que ganhou mensagens novas. Gera uma versão nova, auditada do zero.
Ver Conversa que continuou.
Versão
: Cada estado da conversa que foi auditado. A original é a 1; cada reingestão soma uma. Só a atual
aparece na tela.
Interlocutor
: Quem falou uma mensagem. Lista fechada: Operador, Cliente, Bot, Sistema.
Ver A mensagem.
Metadado : Campo livre da operação — campanha, fila, atendente, equipe — enviado junto com a interação. É por ele que o cliente recorta relatórios. Ver Metadados.
Vaga (consumiuVaga)
: Uma unidade do limite de uso do cliente. Consumida quando há material novo admitido ao processamento.
Do produto
MAIA : A inteligência artificial do QA Analytics — quem transcreve, analisa o sentimento, audita e resume. O cliente não vê provider nem modelo: ele usa a MAIA.
Checklist : O roteiro de auditoria configurado pelo cliente: blocos, critérios (as perguntas) e pesos. Invisível para o parceiro. Qual checklist se aplica a uma interação sai dos metadados dela.
Critério : Uma pergunta do checklist ("o atendente se apresentou?"). Cada uma é avaliada separadamente, com citação conferida na transcrição.
Evidência : O trecho da conversa que sustenta uma resposta da auditoria. Toda acusação tem uma, e ela é procurada no texto antes de valer.
Não conformidade : Um desvio catalogado pelo cliente. Grave zera a nota e notifica o supervisor; branda desconta pontos.
Nota : O resultado da auditoria de uma interação, em percentual do que foi julgado.
Resumo : O parágrafo que a MAIA escreve fechando a leitura da conversa — um para o supervisor ler, outro estruturado, que alimenta os relatórios.
Relatório : A consolidação de um recorte de interações: indicadores calculados do banco, mais a leitura da MAIA sobre os resumos.
Da cobrança
Ciclo : O período de faturamento do cliente. Começa no dia de virada combinado comercialmente — não é necessariamente o mês corrido.
Limite de uso : O teto de conversas por ciclo. Atingido, as novas entram e esperam em vez de serem recusadas. Ver Limite de uso.
Aguardando limite : O status de uma interação gravada que ainda não foi analisada porque o ciclo estourou.
Fila
: O conjunto de interações em Aguardando limite. Escoa por ação explícita do cliente, não sozinha na
virada do ciclo.
Dos status
O ciclo de vida de uma interação. Você vê o primeiro na resposta; os outros ficam na tela do cliente.
| Status | Significa |
|---|---|
Transcrição pendente | Há áudio esperando virar texto. |
Análise pendente | Conteúdo pronto, esperando o sentimento. |
Analisada | Sentimento feito, indo para a auditoria. |
Auditada | Auditoria concluída, com nota. Final bom. |
Concluída | Terminou sem auditoria porque nenhum checklist se aplica. Não é erro. |
Aguardando limite | Gravada e visível, esperando saldo do cliente. |
Falha | Alguma etapa quebrou; o motivo fica na tela. |