API OTP - verificação por SMS com failover de fornecedores

    Uma API OTP preparada para o fornecedor que falha.

    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.

    Por que os códigos OTP se perdem

    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.

    Degradação de rotas

    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.

    Filtragem de remetentes e operadoras

    Operadoras reescrevem ou bloqueiam remetentes e filtram conteúdo. O que funciona em um país é rejeitado no seguinte.

    Recibos pouco confiáveis

    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.

    Failover ordenado. E-mail quando o SMS não chega.

    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.

    // 1. Enviar o OTP
    POST /v1/otp/send
    {
    "phone": "+44 7911 123456",
    "email": "user@example.com",
    "length": 6,
    "ttl_seconds": 300
    }
    // 2. Verificar o que o usuário digitou
    POST /v1/otp/verify
    {
    "request_id": "otp_8f2a...",
    "code": "483921"
    }
    API de OTP - Fluxo de failover de entrega
    Entrega garantida
    Sua aplicação
    POST /v1/otp/send
    phone: "+44...", length: 6
    Motor de roteamento OTP
    SMS
    Canal primário
    Vendor A (Vonage)timeout
    Vendor B (Sinch)rejeitado
    SMS esgotado
    Email
    Canal de fallback
    SendGridOTP entregue
    OTP entregue
    Código OTP entregue por e-mail
    Provedores de SMS esgotados - fallback automático por e-mail - código entregue em 1,2 s

    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.

    Respostas para as perguntas de failover dos desenvolvedores

    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 o failover é acionado?

    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.

    Quais fornecedores?

    Use nossas rotas, traga suas próprias contas de fornecedor ou combine as duas. As chamadas da API não mudam.

    E se todas as rotas SMS falharem?

    Se você informou um e-mail, o código é enviado por e-mail sem integração extra.

    Separado do marketing

    OTPs não esperam atrás do tráfego de campanhas e usam sua própria configuração de remetente e fornecedores.

    O que posso auditar?

    Cada envio, nova tentativa e verificação fica registrado com o fornecedor usado, os tempos e o resultado.

    O fluxo de verificação por SMS: dois endpoints, três etapas.

    01

    Enviar

    Faça POST com o telefone do usuário e um e-mail de reserva opcional. Geramos, armazenamos e enviamos o código.

    02

    Failover

    Tentamos seus fornecedores SMS na ordem definida, passando ao próximo se uma tentativa falhar, e recorremos ao e-mail se necessário.

    03

    Verificar

    Faça POST com o código digitado. Conferimos, registramos a tentativa e retornamos sucesso ou um erro tipado.

    Perguntas frequentes sobre a API de OTP

    O que é uma API de OTP?

    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.

    Qual a diferença entre a API de OTP da Flowstates e enviar um SMS por conta própria?

    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.

    Por quais canais os códigos são entregues?

    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.

    Quanto tempo leva a integração?

    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.

    Posso controlar o tamanho e a validade do código?

    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.

    O que acontece quando um fornecedor de SMS degrada?

    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ê.

    Teste o failover com o seu tráfego real.

    Vamos revisar suas rotas OTP, países e pontos de falha atuais antes de você mudar qualquer coisa.