Pular para o conteúdo principal

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.

StatusSignifica
Transcrição pendenteHá áudio esperando virar texto.
Análise pendenteConteúdo pronto, esperando o sentimento.
AnalisadaSentimento feito, indo para a auditoria.
AuditadaAuditoria concluída, com nota. Final bom.
ConcluídaTerminou sem auditoria porque nenhum checklist se aplica. Não é erro.
Aguardando limiteGravada e visível, esperando saldo do cliente.
FalhaAlguma etapa quebrou; o motivo fica na tela.