
Integre o RCS aos seus fluxos de trabalho de autenticação
Tempo de leitura: 5 minutos
Introdução
Serviços de Comunicação Avançada (RCS) é a próxima evolução do SMS, com recursos modernos como identificação de marca verificada, confirmações de leitura e entrega por dados móveis ou Wi-Fi. À medida que mais dispositivos móveis e operadoras passam a oferecer suporte ao RCS por padrão, seus usuários esperam cada vez mais interações seguras e sem interrupções diretamente em seus aplicativos de mensagens.
Para as empresas, isso abre uma grande oportunidade: habilitar a autenticação de dois fatores (2FA) diretamente por meio do RCS.
Neste tutorial, você aprenderá como integrar o RCS aos seus fluxos de trabalho de autenticação usando a Verify API do Vonage Verify. Você também configurará um caminho alternativo para que, caso o RCS não seja compatível com o dispositivo ou a rede do usuário, a solicitação de verificação recorra automaticamente a outro canal, como o SMS.
Pré-requisitos
O npm e o Node estão instalados.
Um celular com recursos RCS.
O que é o RCS e por que usá-lo?
RCS é um aprimoramento do canal SMS, permitindo que as mensagens sejam entregues via Wi-Fi ou dados móveis nos aplicativos de mensagens padrão do Android e do iPhone. Ele também oferece validação de marca e apresenta baixa latência na entrega. Para usar o canal RCS, é necessário um Agente RCS ou um Sender ID .
Perguntas frequentes
Configurar um fluxo de trabalho da Verify API
Um fluxo de trabalho de verificação é uma sequência de etapas criada para autenticar a identidade de um usuário. Isso pode envolver o envio de um SMS ou de um e-mail contendo um código de senha de uso único que pode ser usado para confirmar a identidade do usuário.
Você pode criar um fluxo de trabalho de verificação que utilize primeiro um canal preferencial e, em seguida, recorra automaticamente a um canal diferente caso a tentativa inicial não seja bem-sucedida. Você também tem à disposição uma lista de canais pelos quais pode enviar mensagens, incluindo SMS, autenticação silenciosa, e-mail e WhatsApp.
Vamos configurar um fluxo de trabalho de verificação que utilize o canal RCS como padrão. Se a mensagem não for convertida com sucesso, o próximo canal da lista será utilizado. Usaremos o SMS como segundo canal alternativo, já que ele é onipresente e amplamente disponível.
Configuração do projeto
Configure seu Account da Vonage e Verify o agente
Certifique-se de se cadastrar ou fazer login em um Account da API da Vonage para ter acesso à API.
Abra sua página de configurações da API para acessar sua chave e seu segredo da API da Vonage, ambos exibidos conforme mostrado na captura de tela abaixo. A chave da API está localizada na parte superior da página e, para acessar seu segredo da API, consulte a subseção “Segredo da Account”.
Observação: caso você não se lembre do seu segredo de API criado anteriormente, clique em “+ Criar novo segredo” e guarde-o em um local seguro.

Criar um aplicativo
Para criar um aplicativo, acesse a página “Criar um aplicativo” no Painel da Vonage e defina um Nome para a sua Application.
Se você pretende usar uma API que utilize Webhooks, precisará de uma chave privada. Clique em “Gerar chave pública e privada”; o download deve iniciar automaticamente. Guarde-a em local seguro; essa chave não poderá ser baixada novamente em caso de perda. Ela seguirá a convenção de nomenclatura private_<seu ID de aplicativo>.key. Agora, essa chave pode ser usada para autenticar chamadas de API. Observação: sua chave não funcionará até que seu aplicativo seja salvo.
Escolha os recursos de que você precisa (por exemplo, Voice, Mensagens, RTC etc.) e forneça os webhooks necessários (por exemplo, URLs de eventos, URLs de resposta ou URLs de mensagens recebidas). Esses itens serão descritos no tutorial.
Para salvar e implantar, clique em “Gerar novo aplicativo” para finalizar a configuração. Seu aplicativo já está pronto para ser usado com as APIs da Vonage.
Configure seu projeto Node
Crie um novo diretório para o seu projeto, inicialize um novo projeto Node e instale as dependências.
mkdir blog-verify_rcs-node-auth-workflows
cd blog-verify_rcs-node-auth-workflows
npm init -y
npm install @vonage/server-sdk @vonage/verify2 Configuração do ambiente
Crie um arquivo .env e vamos adicionar algumas variáveis de ambiente a ele. Vou explicar cada uma delas, explicando para que servem e onde encontrá-las.
VERIFY_BRAND_NAME: Nome que os usuários verão durante a verificação.VONAGE_APPLICATION_PRIVATE_KEY_PATH: Caminho para o arquivo da sua chave privada.VONAGE_APPLICATION_ID: Seu ID de inscrição na Vonage Applications.VERIFY_NUMBER: Número de telefone de teste para receber RCS/SMS.RCS_SENDER_ID: ID do remetente para RCS, disponível na aba “Vincular Accounts externas”.
Enviar um código de verificação usando RCS e mecanismo de fallback no Node.js
Crie um arquivo JavaScript; vou chamar o meu de index.js, e inicialize suas dependências:
// index.js
require("dotenv").config();
const { Vonage } = require("@vonage/server-sdk");
const { Channels } = require("@vonage/verify2");
const vonage = new Vonage({
applicationId: process.env.VONAGE_APPLICATION_ID,
privateKey: process.env.VONAGE_APPLICATION_PRIVATE_KEY_PATH,
});Em seguida, usaremos o método `vonage.verify2.newRequest` do SDK do Vonage Verify V2 para Node.js, adicionando os canais RCS (primeira tentativa) e SMS (alternativa), respectivamente.
// index.js
vonage.verify2
.newRequest({
brand: process.env.VERIFY_BRAND_NAME,
workflow: [
{
channel: Channels.RCS,
to: process.env.VERIFY_NUMBER,
from: process.env.RCS_SENDER_ID,
},
{
channel: Channels.SMS,
to: process.env.VERIFY_NUMBER,
},
],
})
.then(({ requestId }) => console.log(requestId))
.catch((err) => console.error(err)); Execute seu fluxo de trabalho e teste o fallback do RCS
Execute o comando `node` seguido do nome do seu arquivo JavaScript. Ao fazer isso, uma mensagem será enviada para o número que você especificou na variável de ambiente VERIFY_NUMBER. Primeiramente, será feita uma tentativa de contato via RCS; caso isso não seja possível, uma mensagem SMS será enviada como alternativa.
node index.jsObservação: Se você receber uma resposta no seu webhook indicando que a solicitação foi bloqueada, a rede de destino pode ter sido bloqueada pelo sistema antifraude.
Possíveis extensões
Quanto mais pudermos ajudar nossos usuários a mitigar fraudes, melhor. A Verify API da Vonage permite que você verifique seus usuários enviando senhas de uso único (OTPs) para diversos canais. O código que apresentei hoje é semelhante ao guia sobre como enviar uma solicitação de verificação usando vários canais como alternativa; no entanto, este tutorial se concentra nos canais RCS e SMS em JavaScript. Você pode encontrar mais exemplos em outras linguagens nos links da documentação.
Conclusão
É isso aí! Nesta postagem do blog, você viu como é possível usar o canal RCS na Verify API do Vonage e como ela pode recorrer ao próximo canal especificado caso o RCS não esteja disponível no dispositivo.
Tem alguma dúvida ou quer compartilhar o que está criando?
Inscreva-se no Boletim Informativo para Desenvolvedores
Siga-nos no X (antigo Twitter) para ficar por dentro das novidades
Assista aos tutoriais no nosso canal do YouTube
Conecte-se conosco na página de desenvolvedores da Vonage no LinkedIn
Fique conectado e acompanhe as últimas notícias, dicas e eventos para desenvolvedores.
Leitura complementar
Aprimore sua autenticação multifatorial com as APIs da Vonage e o Firebase.
Autenticação em grupo confiável com SMS e Express.
Aprimore sua autenticação multifatorial com as APIs Verify e SIM Swap.