Pular para o conteúdo principal

Limite de uso

Cada conta tem um teto de conversas por ciclo de faturamento, definido comercialmente. Quando ele é atingido, a plataforma não recusa a ingestão.

O que acontece na parede​

A ingestãocontinua aceitando — responde 201 como sempre
A interaçãoé gravada e fica visível ao cliente
O statusAguardando limite
A respostaaguardandoLimite: true e consumiuVaga: false
A análisenão acontece até o cliente liberar
{
"interacaoId": "019205c8-9a44-7b21-8f03-5e1c92d4a778",
"status": "Aguardando limite",
"resultado": "Criada",
"duplicada": false,
"versao": 1,
"mensagensNovas": 0,
"consumiuVaga": false,
"aguardandoLimite": true,
"pendenteMetadadoObrigatorio": false,
"metadadosNovos": [],
"metadadosIgnorados": []
}

Por que aceitar em vez de recusar​

A conversa aconteceu uma vez e não se refaz. Recusá-la a perderia — e a perderia por uma decisão financeira, que é o pior motivo possível para destruir evidência de auditoria.

Do lado do cliente, o efeito é o certo: ele bateu o teto que escolheu, então o gasto para. Mas o material fica guardado, e ele decide o que fazer — subir o limite, liberar parte da fila, ou esperar a virada do ciclo.

E, do lado do parceiro, isso resolve uma pergunta que nem precisa existir: ninguém precisa reenviar o que não foi recusado.

O que o parceiro faz​

Nada.

Não reenvie

A interação já está gravada. Reenviar o mesmo payload devolve 200 Duplicada — não tira a conversa da fila, não avisa ninguém, não adianta nada.

O cliente vê a fila na tela dele, com quantas conversas esperam e desde quando, e um botão para liberá-las até onde o saldo alcançar. É decisão dele.

O que vale fazer, mesmo sem ser obrigatório​

Logar aguardandoLimite e alertar sua operação quando ele começar a vir true.

O motivo é comercial, não técnico: quando o teto do cliente estoura, ele para de receber auditoria — e você é quem descobre primeiro. Avisar antes de o cliente notar que o dashboard parou de crescer é serviço; esperar o chamado é o contrário.

Um contador simples resolve: se mais de N respostas seguidas vierem com aguardandoLimite: true, avise.

Sobre o ciclo​

O ciclo é o período de faturamento do cliente, e não necessariamente o mês corrido: ele começa no dia de virada combinado comercialmente. Um cliente que assinou dia 15 tem ciclo de 15 a 14.

Na virada, o contador zera. As conversas que estavam na fila não são liberadas automaticamente — o cliente precisa liberá-las. Isso é deliberado: uma fila que se soltasse sozinha gastaria o mês novo com o passado sem ninguém escolher.

Nada disso é visível para o parceiro. Está aqui para explicar por que uma conversa pode continuar em Aguardando limite depois de o mês virar.

O que não é limite de uso​

Vale separar, porque os sintomas se parecem:

SintomaCausaO que fazer
aguardandoLimite: trueTeto de conversas do ciclo.Nada. Logar e, se quiser, avisar.
401 Chave de ingestão inválidaChave errada ou conta suspensa por inadimplência.Falar com o cliente. Não retentar.
Interação em FalhaAlguma etapa quebrou — áudio inacessível, ligação sem transcrição.O motivo está na tela do cliente. Ver O que ainda não existe.

Conta suspensa não vira aguardandoLimite: ela nem passa da autenticação. Ver Autenticação.