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ê manda | A versão 2 fica com |
|---|---|
só m3 | m1, m2, m3 |
m1, m2, m3 | m1, 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.
idA 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.
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.
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ê.
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.