Todo fornecedor de SMS tem horas ruins: uma operadora rejeita um remetente, uma rota se degrada, os recibos de entrega param de chegar. Nossa API OTP envia o código por uma lista ordenada de fornecedores SMS, passa para o próximo quando uma tentativa falha ou expira e pode recorrer ao e-mail, com dois endpoints REST. Para mensageria geral, veja a API de mensageria.
Resposta rápida
Uma API de OTP é um par de endpoints que envia um código de uso único e verifica o código digitado pelo usuário. A API de OTP da Flowstates envia por vários fornecedores de SMS, com failover em menos de um segundo e fallback automático por e-mail, para que os códigos cheguem mesmo quando uma rota degrada, com cada tentativa registrada.
A maioria das falhas de OTP não é uma queda total. São parciais: um país, uma operadora, um tipo de remetente. Uma integração com um só fornecedor não tem para onde mandar a próxima tentativa.
A rota continua aceitando mensagens, mas entrega com atraso ou não entrega. A API responde sucesso e o usuário nunca vê o código.
Operadoras reescrevem ou bloqueiam remetentes e filtram conteúdo. O que funciona em um país é rejeitado no seguinte.
Recibos de entrega podem atrasar, faltar ou vir errados, então não bastam como sinal de failover. A etapa de verificação é o sinal confiável.
Uma única chamada de envio. Você define a ordem dos fornecedores; se uma tentativa falhar, passamos ao próximo. Se todas as tentativas SMS falharem, o mesmo código pode ir por e-mail.
Uma única chamada de API. Se a entrega por SMS falhar em todos os fornecedores configurados, o OTP é enviado automaticamente por e-mail, garantindo que seu cliente sempre receba o código.
O tráfego OTP usa sua própria rota, separada dos envios de marketing, com sua própria lista de fornecedores e trilha de auditoria.
Quando um fornecedor rejeita a mensagem, retorna um erro ou não responde a tempo. Recibos de entrega sozinhos não são tratados como prova.
Use nossas rotas, traga suas próprias contas de fornecedor ou combine as duas. As chamadas da API não mudam.
Se você informou um e-mail, o código é enviado por e-mail sem integração extra.
OTPs não esperam atrás do tráfego de campanhas e usam sua própria configuração de remetente e fornecedores.
Cada envio, nova tentativa e verificação fica registrado com o fornecedor usado, os tempos e o resultado.
Faça POST com o telefone do usuário e um e-mail de reserva opcional. Geramos, armazenamos e enviamos o código.
Tentamos seus fornecedores SMS na ordem definida, passando ao próximo se uma tentativa falhar, e recorremos ao e-mail se necessário.
Faça POST com o código digitado. Conferimos, registramos a tentativa e retornamos sucesso ou um erro tipado.
Uma API de OTP é um par de endpoints: um envia um código de uso único ao usuário e outro verifica o código digitado. A API cuida da geração do código, validade, limites de tentativas e entrega, então sua aplicação só chama enviar e verificar.
Um envio simples de SMS tem uma rota só e não guarda estado de verificação. A API de OTP faz cascata entre vários fornecedores de SMS com failover em menos de um segundo, recorre ao e-mail quando o SMS não chega e registra cada tentativa por requisição, permitindo diagnosticar em vez de adivinhar.
SMS como canal principal, com fallback automático por e-mail. A ordem dos canais e a ordem de fornecedores por país são configuradas para o seu tráfego no onboarding.
Duas chamadas REST: POST /v1/otp/send devolve um request_id e POST /v1/otp/verify confere o código. A maioria das equipes integra em um dia; a referência está publicada na nossa documentação.
Sim. Tamanho e tempo de vida são parâmetros da requisição, e os limites de reenvio e tentativas são definidos por conta, para acompanhar a sua política de segurança.
A cascata passa automaticamente para a próxima rota configurada e o fallback por e-mail é acionado se o código continuar sem confirmação de entrega. A Flowstates opera o gateway com SLA de 99,99% e investiga falhas de rota por você.
Vamos revisar suas rotas OTP, países e pontos de falha atuais antes de você mudar qualquer coisa.