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ão | continua aceitando — responde 201 como sempre |
| A interação | é gravada e fica visível ao cliente |
| O status | Aguardando limite |
| A resposta | aguardandoLimite: true e consumiuVaga: false |
| A análise | nã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.
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:
| Sintoma | Causa | O que fazer |
|---|---|---|
aguardandoLimite: true | Teto de conversas do ciclo. | Nada. Logar e, se quiser, avisar. |
401 Chave de ingestão inválida | Chave errada ou conta suspensa por inadimplência. | Falar com o cliente. Não retentar. |
Interação em Falha | Alguma 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.