Etapa 1: Inscreva-se e faça login
- Vá para a inscrição na Central de Mensagens
- Crie sua conta gratuita
- Você receberá instantaneamente 1.000 créditos gratuitos para testar OTPs
Etapa 2: Integração de API (desenvolvedores, montagem!)
Tornamos isso tão simples que você achará que é trapaça. Não se preocupe, temos trechos de código prontos para que você possa pular o clichê e ir direto para o teste.
Não é fã de leitura de código? Temos um tutorial em vídeo que orienta você passo a passo.
Parâmetro da API para verificar agora
Os parâmetros a seguir precisam ser enviados ao usar as APIs VerifyNow.
URLs de base da API Rest
Todos os endpoints da API da plataforma abaixo devem ser prefixados com o seguinte URL:
https://cpaas.messagecentral.comGerar token
Ao usar a API de verificação de SMS do Verify Now para enviar códigos de verificação por SMS, a chamada inicial deve ser para a API de geração de token.
Essa API retorna um token que deve ser incluído em todas as chamadas subsequentes. É necessário um token de autenticação para validar o usuário e deve ser incluído na seção de cabeçalho de cada solicitação.
Caminho do URL da solicitação:
/auth/v1/authentication/tokencURL
1curl --location 'https://cpaas.messagecentral.com/auth/v1/authentication/token?
2customerId=%3CCustomerId%3E&key=%3CBase64%20Encrypted%20password%3E&scope=NEW&country=91
3&email=test%40messagecentral.com' \
4--header 'accept: */*'
OBSERVAÇÃO: Para converter um comando cURL em código usando o Postman, abra o Postman, importe o comando cURL por meio do botão “Importar” e gere o código no idioma de sua preferência clicando no botão “Código” no lado direito da solicitação.
Resposta JSON
1{
2 "status": Integer,
3 "token": "String"
4}Agarre a oportunidade
Se você é desenvolvedor ou agência de desenvolvimento web, faça uma parceria conosco para acelerar seus ganhos.
Torne-se um parceiro
Enviar OTP
Para enviar OTP em um número de celular, abaixo estão os parâmetros da solicitação. O token de autenticação é necessário para enviar o OTP, que é gerado pela API do token gerado (que você pode encontrar acima na seção Introdução).
Caminho do URL da solicitação:
Uma resposta bem-sucedida retornará um código de status 200.
/verification/v3/sendParâmetros do URL da solicitação:
cURL
1curl --location --request POST 'https://cpaas.messagecentral.com/verification/v3/send?
2countryCode=91&flowType=SMS&mobileNumber=9999999999' \
3--header 'authToken:
4eyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJDLTMzNDMyQTVGNDIGNzQwNCI6ImIhdCI6MTcxMjExOTA0MCwiZXhwIjo'
OBSERVAÇÃO: Para converter um comando cURL em código usando o Postman, abra o Postman, importe o comando cURL por meio do botão “Importar” e gere o código no idioma de sua preferência clicando no botão “Código” no lado direito da solicitação. Você pode alterar o FlowType com base no canal de sua escolha.
Resposta JSON
1{
2 "responseCode": 200,
3 "message": "SUCCESS",
4 "data": {
5 "verificationId": "xxxx",
6 "mobileNumber": "xxxx",
7 "responseCode": "200",
8 "errorMessage": null,
9 "timeout": "60",
10 "smCLI": null,
11 "transactionId": "xxxx"
12 }
13}Validar OTP
O método validateOTP é um endpoint da API REST para validar uma senha de uso único (OTP) para clientes.
Caminho do URL da solicitação:
Uma resposta bem-sucedida retornará um código de status 200.
/verification/v3/validateOtp/- Para suporte a vários idiomas
- por padrão é inglês
- Por enquanto, oferecemos suporte apenas em inglês
cURL
1curl --location 'https://cpaas.messagecentral.com/verification/v3/validateOtp?
2&verificationId=2949&code=1476' \
3--header 'authToken:
4eyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJDLTMzNDMyQTVGNDIGNzQwNCI6ImIhdCI6MTcxMjExOTA0MC'
OBSERVAÇÃO: Para converter um comando cURL em código usando o Postman, abra o Postman, importe o comando cURL por meio do botão “Importar” e gere o código no idioma de sua preferência clicando no botão “Código” no lado direito da solicitação.
Resposta JSON
Uma resposta bem-sucedida retornará um código de status 200.
1{
2 "responseCode": 200,
3 "message": "SUCCESS",
4 "data": {
5 "verficationId": "xxxx",
6 "mobileNumber": "xxxx",
7 "responseCode": "200",
8 "errorMessage": null,
9 "verificationStatus": "VERIFICATION_COMPLETED",
10 "authToken": null,
11 "transactionId": "xxxx"
12 }
13}Códigos de resposta
Ajuda e suporte
Para obter suporte de implementação e qualquer feedback, entre em contato conosco em: support@messagecentral.com
Perguntas frequentes
Como faço para integrar a 2FA de mensagens de texto usando uma API OTP?
Você integra a mensagem de texto 2FA ligando para um API SUPERIOR para enviar um código único e, em seguida, validar a entrada do usuário por meio de um endpoint de verificação. A API gerencia a geração, a expiração, as novas tentativas e a entrega do código. Plataformas como O VerifyNow fornece APIs e SDKs REST prontos para uso para serem lançados rapidamente com OTPs 2FA.
Como posso enviar OTPs 2FA por texto usando uma API REST?
Para enviar TOPs 2FA por mensagem de texto, seu back-end chama uma API REST com o número de telefone e o tipo de verificação do usuário. A API envia a OTP e retorna um ID de verificação. O usuário envia o código, que você verifica por meio de uma segunda chamada de API. Verifique agora suporta esse fluxo para fora da caixa.
Quão rápido deve ser o 2FA baseado em texto nos EUA?
A 2FA baseada em texto nos EUA deve ser entregue dentro 1—2 segundos para a melhor experiência do usuário. Entrega além 5 segundos aumenta as entregas. A velocidade depende de Registro 10DLC, roteamento da operadora e carga de tráfego. Verifique agora otimiza o roteamento para manter um nível consistentemente baixo TOPO latência de entrega.
Como posso melhorar as taxas de entrega de texto OTP nos EUA?
Melhore a entrega usando 10 DLC-números registrados, modelos OTP aprovados, limitação de taxa e lógica de repetição. Evite conteúdo que gere spam e explosões nos horários de pico. Adicionar canais alternativos aumenta significativamente o sucesso. Verifique agora inclui novas tentativas integradas e fallback automático do WhatsApp para maximizar a conclusão da verificação.
Preciso do consentimento do usuário para enviar OTPs de texto nos EUA?
Sim, o consentimento do usuário é necessário para envie OTPs de texto nos EUA embaixo TCPA e FCC regulamentações, embora as OTPs se qualifiquem como mensagens transacionais com “consentimento expresso prévio” potencialmente menos rigoroso em comparação com SMS de marketing. Verifique agora usa modelos e rotas compatíveis, alinhados com as regras das companhias aéreas dos EUA.
Como posso testar APIs OTP de texto sem enviar mensagens reais?
Você pode APIs OTP de texto de teste usando credenciais de sandbox, respostas simuladas ou créditos de teste limitados. Uma caixa de areia simula Envio e verificação OTPy flui sem entrega real. Verifique agora também fornece créditos de teste gratuitos para que os desenvolvedores possam validar a entrega e a latência no mundo real antes da transmissão ao vivo.
Quais são os códigos de erro mais comuns ao enviar OTPs de texto?
Códigos de erro OTP de texto comuns dos EUA incluir 30034 (10DLC não registrado), 30008 (filtragem de spam da operadora), 30023/30024 (limitação de taxa) e 30007 (congestionamento do transportador). Compreender esses códigos ajuda a depurar problemas de entrega rapidamente. Verifique agora apresenta diagnósticos claros para cada falha.
O que significa o código de erro 30034 na entrega OTP de texto?
Código de erro 30034 significa que suas mensagens de texto estão sendo bloqueadas porque seu número ou campanha não está registrado no 10DLC. As operadoras dos EUA rejeitam silenciosamente o tráfego A2P não registrado. Corrija isso registrando sua marca e o caso de uso do OTP ou o uso Verifique agora configuração 10DLC pré-aprovada.
Por que estou recebendo o código de erro 30008 mesmo que minha mensagem tenha sido aprovada?
Erro 30008 indica filtragem de spam da operadora, não rejeição do modelo. As causas incluem texto em maiúsculas, emojis, URLs encurtados ou palavras promocionais. Até mesmo as mensagens aprovadas podem ser filtradas. Usando modelos OTP limpos e pré-aprovados (como os fornecidos pela Verifique agora) ajuda a evitar filtros de spam da operadora.
Como faço para corrigir falhas de OTP causadas pela limitação da operadora (30023/30024)?
A limitação da operadora ocorre quando o volume de mensagens excede as taxas permitidas. Corrija isso implementando limites de taxa, enfileirando os envios OTP, aquecendo os números e distribuindo o tráfego entre os números registrados. Verifique agora gerencia automaticamente a taxa de transferência e as novas tentativas para evitar a limitação durante picos de tráfego.
O que devo fazer quando os OTPs falham devido ao congestionamento da operadora (30007)?
Erro 30007 significa que as redes das operadoras estão congestionadas, geralmente durante os horários de pico. A melhor prática é tentar novamente com recuo exponencial e usar canais alternativos. O VerifyNow tenta novamente automaticamente e pode entregar TOPs via WhatsApp se a entrega do texto estiver atrasada, garantindo que os usuários ainda sejam verificados.