Orquestração de canais
A Bird define os padrões. Você ajusta uma única chamada.
A disponibilidade de canais, as regras de remetente e as regulamentações diferem por país, e acertá-las é um trabalho de anos. A Bird entrega isso como uma base por país: quais canais funcionam onde, quais remetentes são permitidos e padrões de código sensatos, derivados da operação de email e SMS em escala. Uma chamada de criação já resolve para o plano correto de qualquer país, e o campo de opções pode reordenar ou restringir os canais ou definir o comprimento do código para aquela verificação.
import { BirdClient } from "@messagebird/sdk";
const bird = new BirdClient({
apiKey: process.env.BIRD_API_KEY!,
});
// Send the code, then check it by recipient.
await bird.verify.verifications.create({
to: { phone_number: "+15551234567" },
}).safe();
const { data, error } = await bird.verify.verifications.check({
to: { phone_number: "+15551234567" },
code: userInput,
}).safe();
if (error) throw error;
Sua conta
Confirme que é você.
Digite o código enviado para
+1 ••• ••• 4567Exemplo de código de verificação
A confiança diária de equipas que criam software de classe mundial
Leia mais histórias de clientesOs padrões da Bird acompanham cada chamada.
Cada verificação na Bird Verify API é resolvida com base em um padrão por país que a Bird mantém a partir de anos operando email e SMS, de modo que uma verificação já é encaminhada de forma adequada em todos os países antes de você escrever uma linha de código. Uma opção por requisição ainda pode ajustar uma única chamada: reordenar ou restringir os canais, ou definir o comprimento do código. Você nunca parte do zero.
Duas camadas definem o plano.
A mais restrita prevalece; o que uma requisição não definir é herdado da base por país da Bird.
- 01
Opções por requisição.
Passe channels ou code_length na chamada de criação para reordenar ou restringir os canais, ou definir o comprimento do código, para aquela verificação. Omita qualquer um e o padrão do país será aplicado.
- 02
Base por país do Bird.
Os próprios padrões por país da Bird, derivados da operação de email e SMS em escala: quais canais estão disponíveis, quais remetentes são permitidos e padrões sensatos de código e TTL. O que uma requisição não sobrescrever é resolvido a partir disso, de modo que uma verificação sempre chega a um plano adequado.
O que uma verificação resolve.
Um número brasileiro é resolvido com base nos padrões por país da Bird para o Brasil, refinado por quaisquer opções por requisição na chamada. WhatsApp e SMS estão ambos disponíveis lá, então a verificação reporta esse plano ordenado, com seu id tipado vrf_.
const { data, error } = await bird.verify.verifications.create({
to: { phone_number: "+5511998765432" }, // Brazil
}).safe();
if (error) throw error;
// Resolved from the per-country base, capped by availability and the kill-switch:
// {
// id: "vrf_01k2m9q8e7fh3v0b7m4d2a9xzt",
// status: "pending",
// channels: [{ channel: "whatsapp" }, { channel: "sms" }],
// last_channel: "whatsapp"
// }
Dois limites ficam acima dos padrões.
As duas camadas acima definem os padrões. Dois portões decidem o que é permitido além disso, e cada um apenas restringe o plano resolvido:
Disponibilidade por país. O plano resolvido de um país só inclui canais que a Bird realmente oferece ali. As opções de uma requisição podem reordenar ou restringir esse plano; não podem adicionar um canal que o país não suporta, pois a disponibilidade é uma interseção.
Desativação global. Quando um provedor tem um incidente, a Bird pode remover um canal em todos os lugares de uma vez. O plano resolvido simplesmente recorre ao canal seguinte e é restaurado automaticamente quando a desativação é encerrada.
O plano está em cada resposta.
Resolvido por verificação, retornado na resposta.
- 01
O plano resolvido está na resposta.
Cada verificação reporta os canais ordenados para os quais foi resolvida, de modo que o plano resolvido nunca é um mistério.
- 02
O failover automático executa o plano por si.
Um canal que falha avança a verificação para o próximo no plano, e um temporizador de entrega por tentativa avança quando nenhum estado de entrega é recebido. Todos os códigos da sessão permanecem válidos, para que o destinatário possa usar qualquer mensagem que o alcance. Também pode avançar uma verificação a pedido com uma chamada de próximo canal.
Coloque em prática.
Continue com a documentação, guias e exemplos sobre este tópico. Os recursos estão em inglês.
O resto da plataforma Verify
Uma API, um conjunto de chaves. Explore as outras capacidades.
Padrões por país que você não precisa construir.
Os padrões por país são uma funcionalidade do Bird Verify: os canais, o código e os limites já vêm incluídos, nas mesmas chamadas de criação e verificação.