Verificação por SMS do Facebook para testes: números de uso único ou uma linha só sua

Primeira decisão: essa conta do Facebook vai precisar do número de novo?

O Facebook vincula um número de telefone a uma conta por mais do que o primeiro cadastro, então escolha o produto antes de pedir.

• Uma verificação e pronto. Você está testando um fluxo de cadastro, verificando como o seu app se comporta depois do Facebook Login ou confirmando uma localização. Um número de uso único do OTP Gateway serve; ele recebe um único código e depois expira.
• Uma conta que precisa continuar entrando. O login de administrador de uma página de longa duração da sua própria empresa, uma conta de staging compartilhada à qual o seu time de QA volta a cada sprint, ou um número de recuperação de uma conta gerenciada por equipe. O Facebook pode enviar um novo código em qualquer um desses momentos, e um número de uso único já não será seu. Use um Número Virtual Dedicado: disponível apenas nos Estados Unidos e no Canadá, a partir de $1.95/mês, com SMS recebidos no painel e no seu webhook.

A página de números virtuais lista o que uma linha dedicada inclui. Fora dos EUA e do Canadá, não há opção de longo prazo por autoatendimento.

Quando o Facebook envia um código por SMS?

O Facebook usa a verificação por telefone em alguns pontos bem conhecidos: cadastro com número de celular em vez de e-mail, confirmação de um número adicionado a um perfil existente, autenticação em dois fatores quando os códigos por SMS são escolhidos como segunda etapa e recuperação de conta quando alguém perde o acesso. Ele também pode pedir confirmação depois de um login incomum. Cada um desses é um caso de teste à parte que vale cobrir se o seu produto depende de uma conta do Facebook.

De quais países pode vir um número virtual para o Facebook?

O Facebook está disponível hoje em 199 países. Alguns que as equipes escolhem com frequência: Estados Unidos, Brasil, Índia, Nigéria, Filipinas, Alemanha, México, Indonésia, Egito, Turquia, Vietnã, Paquistão, França, Reino Unido, Quênia e Argélia.

O país importa. O Facebook pode localizar idioma e mensagens conforme a região do número, então teste com o mercado em que os seus usuários realmente vivem. Uma conta criada para um lançamento no Brasil deve ser verificada com um número brasileiro, e não com a rota que por acaso for a mais barata.

Como funciona o fluxo da API de código de verificação do Facebook?

Chame https://otproute.com/api/v1 com uma chave Bearer (prefixo or_live_) do console do desenvolvedor. O id do serviço é facebook; o id do país é o valor de api_country, por exemplo br ou ng.

1. Consulte GET /api/v1/prices?country=br&service=facebook para ver o preço e a disponibilidade atuais.
2. Crie a ativação: POST /api/v1/activations com {"service": "facebook", "country": "br"}.
3. Coloque o número retornado no campo de telefone do Facebook no seu teste.
4. Escute o evento activation.sms_received ou recorra à consulta periódica de GET /api/v1/activations/{id} a cada poucos segundos.
5. Se o teste for interrompido, chame POST /api/v1/activations/{id}/cancel.

No lado do webhook, verifique X-OTPRoute-Signature (t=<unix>,v1=<hex>) calculando o HMAC-SHA256 de <t>.<raw body> com o segredo do endpoint, rejeite timestamps antigos e torne o handler idempotente usando o id da ativação como chave; as entregas podem se repetir. As contas têm 10 chaves, 5 endpoints de webhook e 300 requisições por minuto. A consulta periódica é uma boa alternativa para volumes baixos. Veja captura de OTP por webhook para um handler de referência.

Obtendo um código do Facebook pelo painel

Quem não é desenvolvedor pode fazer tudo manualmente: abra o OTP Gateway, selecione Facebook, selecione um país, confira o preço exibido e faça o pedido. Copie o número para o Facebook e acompanhe a ativação no painel; o código aparece quando o SMS chegar. Cancele se mudar de ideia, e o valor volta para a carteira.

Por que o código do Facebook pode não chegar?

Várias coisas podem impedir a chegada: o Facebook pode recusar números virtuais em determinado fluxo, uma rota pode estar congestionada, ou o envio pode simplesmente demorar. A janela de 20 minutos e o reembolso resolvem a parte do dinheiro: você só paga se o código chegar; caso contrário, o valor integral volta para a sua carteira automaticamente.

O que fazer em seguida:

• deixe a janela correr até o fim em vez de cancelar cedo;
• tente de novo mais tarde, ou com a rota de outro país que ainda corresponda ao seu caso de teste;
• evite refazer o pedido em laço rápido, o que não ajuda ninguém;
• para contas que você precisa manter, passe para uma linha dedicada dos EUA ou do Canadá.

Uso responsável de números de telefone no Facebook

Os termos do Facebook esperam uma conta pessoal por pessoa real e uma presença comercial por meio de páginas e ferramentas de negócios ligadas a pessoas reais. Use a OTP Route para testar o fluxo de verificação do seu próprio produto, fazer QA em contas que pertencem à sua organização ou proteger os números pessoais dos funcionários em logins comerciais. Não crie contas para pessoas que não existem nem contorne restrições que o Facebook tenha imposto a uma conta. A OTP Route não é afiliada ao Facebook, o nome é marca registrada de seu titular, e a Política de Uso Aceitável da OTP Route se aplica a cada pedido. Os preços dos dois produtos estão na página de preços.

Perguntas frequentes

Posso receber um OTP do Facebook sem chip?

Sim, para uma única verificação. Peça um número para o serviço facebook no OTP Gateway e leia o código no painel ou pela API.

Qual é o preço de um número de telefone para o Facebook na OTP Route?

Os códigos de uso único começam a partir de $0.20 por código; o endpoint de preços da API mostra o valor exato para cada país. As linhas dedicadas dos EUA e do Canadá começam a partir de $1.95/mês.

O Facebook aceita qualquer número virtual?

Não. O Facebook pode recusar números virtuais em alguns fluxos, e é por isso que você é reembolsado automaticamente se nenhum código chegar em 20 minutos.

Posso entrar de novo na mesma conta do Facebook mais tarde?

Somente se você ainda controlar o número. Para isso, use um Número Virtual Dedicado nos EUA ou no Canadá, em vez de uma ativação de uso único.

É possível fazer a verificação por SMS do Facebook para testes em um job de CI?

Sim. Crie ativações a partir do seu pipeline, receba os códigos por webhook assinado e use o modo sandbox em uma conta de desenvolvimento para ensaiar a integração sem gastar.

Qual país devo escolher para um teste do Facebook?

Aquele em que estão os seus usuários. O Facebook localiza mensagens e verificações por região, então uma rota de país correspondente dá o resultado mais realista.

Os nomes dos serviços são marcas registradas de seus respectivos proprietários. A OTP Route não é afiliada a eles. Use os números de forma lícita e siga os termos de cada serviço e nossa Política de Uso Aceitável.