Integre o RCS aos seus fluxos de trabalho de autenticação

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

1. O que é o RCS?

2. O que é um agente RCS/RBM?

3. Como posso verificar se o RCS está ativo no meu aparelho?

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.

Criar um aplicativo

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

Observaçã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.

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.