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