Fluxos de trabalho flexíveis para a Verify API

A Nexmo Verify API foi projetada para permitir que você confirme se um usuário forneceu um número de telefone correto e válido, enviando-lhe um código PIN e solicitando que ele o insira.

Por padrão, isso é feito enviando-se primeiro uma mensagem SMS com o código PIN e, em seguida, uma ligação telefônica com uma mensagem falada contendo o PIN. Por fim, é feita uma segunda ligação para tentar entrar em contato com o usuário.

Contar com esse processo de várias etapas e modos realmente aumenta as taxas de sucesso na verificação do número de telefone do usuário. No entanto, sabemos que esse não é o melhor fluxo de trabalho possível para todos os usuários; por isso, a Verify API agora conta com um novo recurso: Fluxos de Trabalho Configuráveis.

Controlar o fluxo de trabalho de Verify

Para cada usuário a quem você precise enviar um código PIN, o fluxo de trabalho “adequado” pode ser diferente. É por isso que a Verify API agora permite que você especifique um workflow_id ao fazer a chamada à API, permitindo que você escolha entre cinco padrões de fluxo de trabalho possíveis.

O parâmetro adicional é adicionado junto com os já existentes, de modo que sua chamada à API fica mais ou menos assim (em Node.js):

nexmo.verify.request({
  number: RECIPIENT_NUMBER,
  brand: BRAND_NAME,
  workflow_id: WORKFLOW_ID
}, (err, result) => {
  if (err) {
    console.error(err);
  } else {
    const verifyRequestId = result.request_id;
    console.log('request_id', verifyRequestId);
  }
});

Você também encontrará este trecho de código em outras linguagens no Portal do Desenvolvedor da Nexmo

O workflow_id pode ser qualquer número inteiro entre 1 e 5, e aqui estão os fluxos de trabalho que esses números representam:

Fluxo de trabalho 1 (fluxo de trabalho padrão): SMS -> TTS -> TTS

Envie um código PIN por mensagem de texto e, em seguida, faça duas ligações Voice, caso a solicitação ainda não tenha sido Verify. Esse é o comportamento padrão e, provavelmente, uma boa opção caso você não tenha certeza de qual escolher.

Fluxo de trabalho 2: SMS -> SMS -> TTS

Envie um código PIN por mensagem de texto, envie uma segunda mensagem de texto em seguida e, por fim, faça uma ligação de voz caso a solicitação não tenha sido Verify. Para regiões e/ou usuários em que o SMS seja preferível a uma ligação de voz.

Fluxo de trabalho 3: TTS → TTS

Ligue para o usuário e informe um código PIN; faça uma segunda ligação caso a solicitação ainda não tenha sido verificada. Se você já sabe que uma ligação telefônica é a melhor opção para a situação desse usuário, uma ligação com uma nova tentativa é uma boa maneira de entrar em contato com ele.

Fluxo de trabalho 4: SMS -> SMS

Envie um código PIN por mensagem de texto e, caso o código não tenha sido Verified, envie uma segunda mensagem de texto. Ideal para usuários que não gostam de receber ligações. Incluindo, entre outros, a geração Y.

Fluxo de trabalho 5: SMS -> TTS

Envie um código PIN por mensagem de texto e, caso o código não tenha sido Verified, faça uma ligação Voice. Oferecer as duas opções — mensagem de texto e ligação Voice —, mas com apenas uma tentativa para cada uma, permite incluir muitas pessoas sem ser muito intrusivo.

Aproveite ao máximo seu alcance

Ajustar suas aplicações para aproveitar o melhor fluxo de trabalho para o seu caso de uso (ou até mesmo utilizar opções diferentes para clientes diferentes) pode realmente melhorar as taxas de verificação dos seus clientes.

Estamos super empolgados com o lançamento público desse recurso — conte para a gente como você mudou seus fluxos de trabalho e por quê! Você sempre pode nos encontrar no Twitter @NexmoDev, ou envie um e-mail para devrel@nexmo.com ou fazer uma pergunta no #verify-api canal da Slack da Comunidade Nexmo.