Como usar o agente padrão do Vonage Verify RCS

Se você já está enviando OTPs com a API Vonage Verify, pode começar a enviar mensagens RCS imediatamente, sem precisar registrar um agente nem passar por um processo de aprovação da operadora. O Agente padrão do Vonage Verify RCS é um agente RCS pré-registrado e gerenciado centralmente, operado pela Vonage sob o nome de Vonage Verify. Qualquer cliente da API Verify em um país compatível pode utilizá-la simplesmente omitindo o from campo em sua solicitação existente do Verify V2.

Pré-requisitos

Nota: Não é necessário o registro de agente, a aprovação da operadora nem nenhuma configuração adicional da Account.

Verifique se o seu país de destino está entre os atendidos

Primeiro, verifique se seus usuários finais estão localizados em um dos países onde o Agente Padrão está Ao vivo:

País Nome do agente Status
Reino Unido Vonage Verify Ao vivo
França Vonage Verify Ao vivo
Espanha Vonage Verify Ao vivo
Itália Vonage Verify Ao vivo
Suécia Vonage Verify Ao vivo
Noruega Vonage Verify Ao vivo
Índia Vonage Verify Ao vivo
Nigéria Vonage Verify Ao vivo
Estados Unidos Vonage Verify Ao vivo
Cingapura VonageVFY Em andamento

Dica: Se o país de destino não estiver na lista, inclua um canal alternativo, como SMS no seu fluxo de trabalho. A equipe do Verify está ampliando continuamente a cobertura do Agente Padrão.

Adicione o RCS ao seu fluxo de trabalho Verify

Na sua solicitação existente do Verify V2, adicione "channel": "rcs" para a matriz de fluxos de trabalho. Omita o from campo já que a Vonage encaminha automaticamente a mensagem por meio do Agente Padrão. Não é necessário informar o ID do agente.

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'"
        }
    ]
}'
Parâmetro Obrigatório Tipo Descrição
brand Sim String O nome da sua empresa ou serviço, exibido ao usuário na mensagem de verificação (YOUR_BRAND (neste exemplo)
workflow Sim Matriz Define a sequência de canais para o envio da OTP (por exemplo, RCS, SMS).
workflow.channel Sim String O canal de entrega a ser utilizado (rcs e sms (no exemplo).
workflow.to Sim String O número de telefone para o qual a OTP deve ser enviada, no formato E.164 (por exemplo, +44111223344).

Observação: Ao utilizar seu próprio agente RCS registrado, o from Este campo é obrigatório e deve conter seu ID de agente RCS. Com o agente padrão, omitir from é o que desencadeia isso.

Dica: Sempre inclua o SMS como opção alternativa. Se o dispositivo ou a rede do usuário final não for compatível com RCS, a Vonage recorre automaticamente ao próximo canal no fluxo de trabalho.

Lidar com a resposta

Uma solicitação bem-sucedida retorna um request_id:

{
  "request_id": "REQUEST_ID"
}

Assim que o usuário final enviar a OTP, verifique o código usando o request_id exatamente como você faria com qualquer outro canal do Verify — consulte Verifique o código de verificação fornecido.

Experiência do usuário final com o RCS

Quando uma mensagem de verificação é enviada por meio do Agente Padrão, os usuários finais em dispositivos Android compatíveis recebem uma mensagem RCS avançada com os seguintes recursos:

  • Emblema de remetente verificado — a mensagem chega, verificada pela operadora Vonage Verify agente (VonageVFY (em Cingapura), aumentando a confiança dos usuários.
  • Layout de cartão sofisticado — o OTP é exibido de forma destacada em um cartão com design especial, facilitando a leitura à primeira vista.
  • Botão “Copiar código com um toque” — um recurso de sugestão permite que os usuários copiem o código diretamente para a área de transferência, reduzindo os erros de digitação.
  • Sugestão automática de OTP — 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.
  • Corpo da mensagem com a marca — seu brand esse valor aparece no corpo da mensagem, de modo que os usuários veem o nome da sua empresa no contexto, mesmo que o nome do agente seja Vonage Verify.
  • Não é necessário instalar nenhum aplicativo — O RCS está integrado ao aplicativo “Mensagens” padrão do Android. Não é necessário fazer downloads nem seguir etapas adicionais.

Comportamento e limitações

  • O nome do remetente do agente RCS é sempre Vonage Verify (VonageVFY em Cingapura) e não pode ser personalizado ao usar o Agente Padrão. No entanto, o nome da sua marca aparece no corpo da mensagem por meio do brand parâmetro: Your {brand} code is: {code}.
  • As exclusões se aplicam apenas ao usuário final específico e à sua chave de API — elas não afetam outros clientes que utilizam o mesmo Agente Padrão.
  • Não são necessárias etapas adicionais de configuração, inclusão na lista de permissões ou ativação. Todos os clientes da API Verify nos países compatíveis podem usar o Agente Padrão imediatamente.
  • Aplicam-se os limites padrão de uso da API Vonage Verify e as políticas de uso justo.
  • O faturamento é idêntico aos preços padrão do Vonage Verify RCS. O uso é atribuído à sua chave de API individual.

Registre seu próprio agente RCS

O Agente Padrão é um ponto de partida recomendado e serve como ponte enquanto seu agente personalizado está sendo provisionado. Você pode executar o registro do seu próprio agente em paralelo enquanto utiliza o Agente Padrão, sem interromper o tráfego existente. Para começar, use o RCS Agent Builder no Painel da API da Vonage.

Veja também