Pular para o conteúdo principal

Como o sistema funciona

Vale entender o caminho que uma interação percorre, porque várias regras da integração só fazem sentido à luz dele.

O que isso significa para quem integra​

A resposta HTTP volta no passo 1​

Tudo a partir do passo 2 é assíncrono e leva de segundos a minutos, dependendo do volume e de haver áudio. Você não espera a análise, e não há como pedi-la de volta pela API — o resultado vive na tela do cliente.

A resposta devolve o status inicial da interação, que normalmente é Análise pendente (texto já transcrito) ou Transcrição pendente (há áudio a transcrever). Ver A resposta.

A plataforma não guarda o áudio​

Ela guarda a URL e busca o arquivo quando precisa: para transcrever, e depois para o supervisor ouvir na tela. Por isso a URL precisa continuar válida por muito tempo — não só até a transcrição acontecer. Ver URLs de áudio.

O conteúdo é guardado no formato da plataforma​

Não como o payload da origem: fala a fala, com quem falou e quando. É isso que permite julgar a conduta do atendente sem confundi-la com a do cliente.

Por isso o interlocutor de cada mensagem é obrigatório e vem de uma lista fechada. Errá-lo não produz erro HTTP — produz auditoria errada. Ver A mensagem e o interlocutor.

A auditoria cita a conversa​

Cada resposta do checklist vem com o trecho que a sustenta, e esse trecho é procurado na transcrição antes de valer. Uma citação que a MAIA inventou não passa: o modelo consegue produzir uma frase plausível, não consegue fazê-la existir no texto.

Consequência para você: conversa truncada ou com falas fora de ordem degrada a auditoria, mesmo que o payload passe na validação. Mande a conversa como ela aconteceu.

Cada etapa tem custo, e ele é do cliente​

Transcrição é cobrada por minuto de áudio; auditoria faz uma chamada de IA por critério do checklist. O cliente contrata um teto de conversas por ciclo, e ao bater nele as novas entram e esperam em vez de serem recusadas. Ver Limite de uso.

Nada disso exige ação do parceiro. Exige saber que existe, para não interpretar aguardandoLimite: true como falha.

Os status que uma interação atravessa​

Você vê o primeiro na resposta; os outros ficam na tela do cliente. Estão aqui porque um chamado de suporte vai citá-los.

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. É o final bom.
ConcluídaTerminou sem auditoria porque nenhum checklist se aplica aos metadados desta interação. Não é erro — é configuração do cliente.
Aguardando limiteO ciclo do cliente chegou ao teto. A conversa está gravada e visível, só não foi analisada.
FalhaAlguma etapa quebrou, e o motivo fica escrito na tela. Reprocessável pelo cliente.