Envie verificações RCS com o agente padrão do Vonage Verify RCS

Introdução

O Vonage Verify O Agente Padrão RCS (Rich Communication Services) é um agente RCS pré-registrado e gerenciado centralmente que qualquer cliente da Verify API pode usar para começar a enviar mensagens RCS instantaneamente, sem a necessidade de passar pelo processo tradicional de registro de agentes, que geralmente leva muito tempo.

Nesta publicação, você aprenderá a usar o Agente Padrão do Vonage Verify RCS para começar a enviar mensagens de autenticação RCS confiáveis no mesmo dia em que realizar a integração.

Quando usar o agente padrão

Se sua empresa deseja incorporar o RCS aos seus fluxos de autenticação, mas não quer esperar semanas pela aprovação da operadora, ou se você já utiliza o Vonage Verify para SMS ou WhatsApp e pretende adicionar um canal de mensagens avançadas com o mínimo de esforço, esta publicação é para você. O mesmo vale se você atualmente usa apenas SMS e deseja começar a testar o RCS como um canal adicional.

Se você já tentou começar a usar o RCS e teve dificuldades com o processo de cadastro, não desista ainda. Continue acompanhando para saber mais sobre o Agente Padrão do RCS da Vonage Verify.

Integração na prática

Pré-requisitos

• Uma integração já existente integração com a API do Verify V2 em um ou mais dos países suportados.

Observação: Para usar o agente padrão do Vonage Verify RCS, omita o parâmetro “from” das suas solicitações à Verify API. Você pode começar a enviar mensagens de verificação RCS imediatamente, enquanto o registro do seu agente personalizado continua em paralelo.

Como fazer a solicitação à API

Se você já estiver integrado à Verify API v2, poderá começar a enviar mensagens RCS por meio do Agente Padrão com apenas uma alteração: omita o from campo, pois a Vonage encaminha automaticamente a mensagem pelo Agente Padrão e não é necessário nenhum ID de agente.

Iniciar uma verificação

curl -X POST "https://api.nexmo.com/v2/verify" \

    -H "Authorization: Bearer $JWT" \

    -H 'Content-Type: application/json' \

    -d $'{

        "brand": "TestVerify",

        "code_length": 5,

        "channel_timeout": 30,

        "workflow": [

        {

            "channel": "rcs",

            "to": "+447700900000"

        }

    ]

}'

• JWT (JSON Web Token) — Você pode gerar um novo JWT usando o gerador online de JWT ou a ferramenta CLI da Vonage.

• marca - O nome da sua empresa, da forma como você deseja que ele apareça no corpo da mensagem.

• canal - Deve ser “rcs” para o encaminhamento por meio do Agente Padrão do RCS.

• para - Número de telefone do usuário final no formato E.164.

Resposta bem-sucedida

Uma resposta 202 Accepted confirma que a solicitação de verificação foi enviada. Uma resposta 200 OK confirma que o código correspondeu e que o usuário foi Verify. Verifique o código usando o request_id exatamente como faria com qualquer outro canal do Verify, verifique o código de verificação fornecido.

{
  "request_id": "c11236f4-00bf-4b89-84ba-88b25df97315"
}

Salve o request_id, você precisará dele para verificar o código enviado pelo usuário final.

Para obter detalhes completos sobre os parâmetros, consulte a Referência da API do Verify V2.

Verifique a OTP (senha de uso único)

Assim que o usuário final receber o código OTP, você deverá enviar uma solicitação POST para o /v2/verify/{request_id} ponto de extremidade. Substitua o {request_id} pelo ID que você recebeu na chamada anterior:

curl -X POST "https://api.nexmo.com/v2/verify/$VERIFY_REQUEST_ID" \

  -H "Authorization: Bearer $JWT"\

  -H 'Content-Type: application/json' \

  -d $'{

    "code": "'$VERIFY_CODE'"

  }'

Recurso de fallback multicanal

Para implantações em produção, recomendamos adicionar um canal alternativo, caso o RCS não esteja disponível no dispositivo do destinatário. O fluxo de trabalho abaixo tenta primeiro o RCS e, em caso de falha, recorre ao SMS. Não é necessária nenhuma configuração adicional, pois a Vonage lida com a seleção do canal automaticamente. Na maioria dos países, a mensagem é enviada pelo agente “Vonage Verify”.

curl -X POST "https://api.nexmo.com/v2/verify" \

    -H "Authorization: Bearer $JWT" \

    -H 'Content-Type: application/json' \

    -d $'{

        "brand": "YOUR_BRAND",

        "workflow": [

        {

            "channel": "rcs",

            "to": "'$PHONE_NUMBER'"

        },

        {

            "channel": "sms",

            "to": "'$PHONE_NUMBER'"

        }

    ]

}'

Benefícios do RCS

RCS ConversationO RCS está integrado ao aplicativo “Mensagens” padrão do Android e também está disponível nas versões mais recentes do iOS. Nas versões compatíveis do Android, o Google Messages pode exibir o código acima do teclado como uma sugestão de preenchimento automático com um único toque, permitindo que os usuários verifiquem com um único toque, sem precisar alternar entre aplicativos.

Se você estiver usando o layout de cartão avançado, a OTP é exibida com destaque em um cartão estilizado, e você pode até mesmo adicionar um botão “Copiar código” com um único toque, que é um balão de sugestão abaixo da mensagem que permite aos usuários copiar o código diretamente para a área de transferência, reduzindo o atrito e os erros de digitação nos formulários de login.

O corpo da mensagem com a marca é o valor que você define na chamada de API e que é exibido dentro do corpo da mensagem, de modo que os usuários finais vejam o nome da sua empresa no contexto.

Tabela comparativa entre o agente padrão do RCS e o SMS comum

Perguntas frequentes

P: Qualquer cliente do Verify V2 pode usar esse recurso?

R: Sim, todos os clientes da Verify API nos países suportados podem usar o Agente Padrão sem nenhuma etapa adicional de ativação.

P: O usuário final verá “Vonage Verify” em vez da marca do cliente?

R: Sim, aparecerão mensagens do agente do Vonage Verify. Esse é o comportamento esperado para o Agente Padrão. Se você quiser que o nome da sua própria marca apareça como remetente, registre um agente personalizado. A aprovação do seu agente com a marca própria pode ser realizada paralelamente ao uso do Agente Padrão. Mesmo assim, você pode usar o parâmetro de marca para incluir o nome da sua marca no corpo da mensagem RCS.

P: Existe um limite de volume?

R: Não há limites de volume específicos associados ao uso do Agente Padrão. Aplicam-se os limites de uso padrão da Verify API e as políticas de uso justo. O faturamento das mensagens RCS enviadas por meio do Agente Padrão é idêntico à tabela de preços padrão do Vonage Verify RCS. Não há taxa extra nem sobretaxa pelo uso do Agente Padrão. Todo o uso é atribuído à chave de API individual do cliente, portanto, não há risco de cobrança compartilhada. A cobrança é a mesma, independentemente de o cliente usar o Agente Padrão ou seu próprio ID de agente registrado.

P: E quanto aos países que não constam da lista de países aprovados?

R: Para os países que ainda não são suportados, os clientes devem iniciar por conta própria o registro do agente RCS. A equipe do Verify está expandindo continuamente a cobertura do Agente Padrão. Verifique se o país de destino é compatível.

Conclusão

O Agente Padrão do Vonage Verify RCS permite que você comece a usar o RCS no mesmo dia, e você pode migrar para o seu próprio agente com a sua marca a qualquer momento. Não é necessário enviar documentação da marca e detalhes do caso de uso, passar por processos de aprovação das operadoras que variam de país para país, nem evitar idas e vindas com agregadores antes que uma mensagem possa ser enviada.

Recursos

• RCS Agent Builder | Messages API

• Como usar o agente padrão do Vonage Verify RCS

  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.