IOSOR Guias
Na fila vs enviado: o caminho da mensagem no IOSOR
Entenda como as equipes de produto e finanças compartilham uma máquina de estados unificada para SMS e OTP, equilibrando retenções e status de DLR no IOSOR.
Na fila vs enviado: o caminho da mensagem no IOSOR.
A máquina de estados única para os status na fila e enviado
Quando uma solicitação de API chega à plataforma para transmitir uma mensagem SMS ou OTP para um destino E.164, as equipes de produto e finanças devem consultar exatamente o mesmo estado do ciclo de vida. Nas arquiteturas marca branca tradicionais, a equipe de produto trata 'na fila' (queued) como um estado puramente técnico enquanto finanças aguarda o fechamento mensal. O IOSOR elimina essa desconexão operando uma única máquina de estados determinística.
Reserva financeira na fila versus liquidação final
Ao entrar no estado na fila, o sistema executa uma verificação imediata de saldo. Para manter a solvência da plataforma, as contas devem respeitar o limite mínimo pré-pago de USD 20 antes que o tráfego de saída entre no pipeline. Enquanto está na fila, o custo projetado do segmento SMS fica retido. Se a mensagem transita de na fila para enviado, essa retenção é convertida em débito definitivo. Se a mensagem falhar na validação, a retenção é liberada instantaneamente.
Gatilhos de transição: da ingestão da API ao envio
A fronteira entre na fila e enviado é rígida. Na fila significa que a solicitação foi validada, a tarifa calculada e a mensagem atribuída à fila de disparo com fundos reservados. Enviado indica que o gateway de borda transmitiu a PDU para a interface de rede e recebeu uma confirmação intermediária. Nesse milissegundo, o sistema atualiza o estado de na fila para enviado e dispara um evento de webhook assíncrono.
Conciliando auditorias contábeis com relatórios de entrega
Auditorias financeiras frequentemente divergem dos logs técnicos devido a atrasos nos DLRs. No IOSOR, o estado enviado é o ponto contábil de confirmação do débito final. Status de DLR como DELIVERED ou UNDELIVERED atualizam métricas operacionais sem alterar o registro contábil original.
Manual operacional e arquitetura relacionada
Para manter o alinhamento entre as equipes de engenharia e operações financeiras, siga estes guias de referência sobre processamento de filas, idempotência e mecânica de carteira:
- Operações de consumidor de webhook em alto volume
- Semana piloto da carteira: retenção e débito no tráfego real
- idempotência, retries e dinheiro
Comece com a IOSOR
Abra o console do IOSOR e navegue até a configuração da Máquina de Estados do Ciclo de Vida para alinhar seus ganchos de saída com o pipeline unificado de fila para envio. Configure a integração do seu livro-razão para reconhecer o estado de enviado como o ponto autoritativo para o compromisso final do débito, em vez de aguardar os relatórios de entrega da operadora a jusante.
Conclusão IOSOR
Este guia provou que unificar a telemetria do produto e a cobrança em torno de uma única máquina de estados remove o atrito operacional entre engenharia e finanças. Reservar fundos na entrada da fila e confirmar os débitos finais quando o gateway emite o evento de enviado cria um modelo contábil determinístico que permanece inalterado por recibos de entrega atrasados ou ausentes.
Este guia foi útil?
Guias relacionados
- Mensagens na fila devem reter fundos, não debitar como enviadas
Saiba como o IOSOR gerencia os estados da fila de mensagens no livro-razão. Solicitações de SMS na fila criam uma retenção temporária de saldo.
- Estados do Ciclo de Vida da Mensagem vs Playbooks de Baixa Entrega
Entenda a máquina de estados de SMS desde o envio até a fila, disparo e recebimento do DLR, além de retenções de saldo e webhooks.