Pular para o conteúdo principal

Conversa que continuou (reingestão)

O caso: você enviou uma conversa por ociosidade, marcada parcial: true, porque o cliente parou de responder. Dias depois ele volta e o atendimento continua.

O que fazer: enviar de novo — a conversa inteira ou só as mensagens novas, o que for mais fácil para o seu sistema. A plataforma monta o histórico completo nos dois casos.

O que a plataforma faz​

Ela une o que você mandou com o que já tem, casando as mensagens pelo id, e compara o resultado com a última versão gravada:

  • igual → resultado: "Duplicada", 200, nada acontece;
  • mudou → cria uma versão nova da interação: resultado: "Reingerida", 201, versao: 2, mensagensNovas: N, mensagensEditadas: M.

Os dois formatos chegam ao mesmo lugar. Numa conversa que tinha m1 e m2 e ganhou m3:

Você mandaA versão 2 fica com
só m3m1, m2, m3
m1, m2, m3m1, m2, m3

A versão nova é auditada do zero, sobre a conversa completa. A versão anterior não é alterada nem apagada: a auditoria feita sobre ela continua válida e consultável no histórico.

Isso depende do id

A união casa as mensagens pelo id que você manda. Sem ele a plataforma não tem como distinguir a fala que já tem da que acabou de chegar — por isso o id é obrigatório em toda conversa que pode ser continuada. Ver abaixo.

Por que versão nova, e não alterar a existente​

Alterar a conversa gravada seria mais simples, e está errado por um motivo que só aparece depois.

A auditoria aponta evidência por posição: "o critério de saudação falhou, veja a fala 3". Se uma mensagem for inserida no meio da conversa — uma que chegou fora de ordem cronológica —, todas as posições seguintes andam. A auditoria de ontem passaria a citar a fala errada.

E não quebraria: apontaria para outra fala, plausível, e ninguém notaria. Uma auditoria que aponta a fala errada é pior que uma auditoria que não existe, porque parece confiável.

Criando versão nova, a linha antiga não muda nunca — e a evidência dela continua apontando para o material sobre o qual foi escrita.

As regras​

Só conversa parcial aceita continuação​

Conversa enviada com parcial: false é imutável. Reenviá-la com conteúdo diferente devolve 200 Duplicada e não muda nada.

O motivo: a auditoria foi feita sobre um material, e mudar o material depois transformaria a nota registrada em resposta a uma pergunta que ninguém mais consegue ler. Se o cliente já viu a nota, ela precisa continuar significando algo.

Não há como reabrir pela API

Se a origem marcou parcial: false por engano e a conversa continuou, o conteúdo novo não entra. Não existe endpoint para reabrir. Marcar parcial corretamente é a única proteção.

O id da mensagem é obrigatório aqui​

Toda conversa enviada com parcial: true exige id em todas as mensagens. Sem ele a resposta é 400, e a conversa não entra.

É o que sustenta tudo o que está nesta página. Sem o id, a plataforma não distingue a fala que já tem da que acabou de chegar: a conversa inteira reenviada viraria falas duplicadas — sete falas virariam doze —, e a auditoria julgaria um atendimento em que tudo foi dito duas vezes.

Vale também na continuação de uma conversa parcial, mesmo quando você a fecha com parcial: false. É continuação do mesmo jeito, e sem o id a união é impossível do mesmo jeito.

Só fica de fora a conversa que nasce fechada, com parcial: false no primeiro envio: ela nunca será continuada.

O id faz uma segunda coisa, e ela vale dinheiro do cliente: é por ele que a plataforma reaproveita as transcrições já pagas dos áudios. Sem esse casamento, cada reingestão retranscreveria a conversa inteira, cobrada por minuto.

Detalhe em A mensagem e o interlocutor.

Nada é apagado por omissão​

Uma fala que existia na versão anterior e não veio no seu payload é mantida. A plataforma não tem como distinguir "a origem apagou esta mensagem" de "a origem mandou só o delta" — e entre os dois erros, apagar é o que não tem volta.

Consequência prática: não há como remover uma mensagem de uma conversa pela API. Se algo entrou errado, o caminho é corrigir o texto, não sumir com a fala.

Corrigir o texto de uma mensagem é possível, e fica registrado​

Mande a mesma mensagem, mesmo id, com o texto novo. Ele passa a valer, e a resposta conta a correção em mensagensEditadas.

A fala fica marcada com a versão em que mudou, e o texto anterior continua legível na versão antiga. Isso não é burocracia: a nota da versão anterior foi dada sobre o texto antigo, e quem for auditar precisa saber que o que ele está lendo não é o que a IA leu.

Corrigir texto custa uma vaga

A correção muda o material, então nasce uma versão nova e o cliente paga por ela. Corrigir acentuação em massa depois do envio é uma forma cara de não fazer nada.

Um caso não conta como edição: mensagem de áudio que a plataforma transcreveu e que você passa a mandar com texto próprio. Ali você está fornecendo o que antes não tinha, não corrigindo o que disse — e o seu texto vence o nosso.

Cada versão consome uma vaga​

Uma conversa que volta três vezes conta três no limite de uso do cliente. Não é cobrança dupla do mesmo trabalho: são três auditorias, sobre três materiais diferentes, cada uma com sua nota e seu resumo.

Reprocessar a mesma versão (ação do cliente na tela dele, para recalibrar prompt) é de graça — isso não passa por você.

Onde isso pode incomodar o cliente

Quem dispara a reingestão é o gatilho de ociosidade, que é política da origem — sua ou do Mais Contato. Se o prazo de ociosidade for curto, uma conversa que se arrasta por uma semana pode gerar três ou quatro versões, e o cliente vê quatro conversas no contador por um atendimento que ele conta como um.

Isso está previsto e é o comportamento correto, mas vale alinhar o prazo de ociosidade com o cliente antes do go-live. A carteira dele mostra a quebra ("1.240 conversas · 180 reingestões") justamente para esse número não chegar como surpresa.

O que aparece na tela do cliente​

Só a versão atual. Uma conversa reingerida três vezes aparece uma vez na listagem, no relatório e na média de nota — não quatro. As versões anteriores existem no histórico, acessíveis a partir da atual.

Isso importa para você porque explica uma pergunta que o cliente pode fazer: "por que o contador diz 1.240 e eu vejo 1.060 conversas?" A resposta é a quebra por reingestão.

Exemplo completo​

O par de payloads — primeiro envio parcial e a continuação — está em Enviar uma conversa, Exemplo 3.

Voz não tem isso​

Não existe parcial no endpoint de voz: uma ligação termina quando termina. Ligação enviada não aceita reingestão — reenviar com conteúdo diferente devolve 200 Duplicada.