IDs de usuário com escopo de negócio

Por que um contato chega sem número de telefone

Como é um BSUID

{
  "from": {
    "bsuid": "US.13491208655302741918",
    "username": "alexr",
    "display_name": "Alex Rivera"
  }
}

• Passe o valor inteiro, sem alteração. A Meta rejeita um BSUID modificado, então nenhuma parte dele é opcional: o código de país, o ponto e cada caractere do identificador viajam juntos. O Bird valida o formato antes de aceitar um envio, e o código de país precisa estar em maiúsculas e ser um código ISO 3166 alfa-2 real; um prefixo em minúsculas ou desconhecido é recusado em vez de corrigido. O limite de 128 caracteres se aplica ao identificador depois do código de país e depois do segmento ENT. em um BSUID pai.
• Ele tem escopo de portfólio de negócios. Qualquer número de telefone comercial no mesmo portfólio pode enviar mensagens para aquele BSUID; um número em um portfólio diferente não pode, e o envio falha.
• Ele não é permanente. A Meta documenta que o BSUID de um contato é regenerado quando ele troca o número de telefone, então ele identifica um parceiro de conversa em vez de servir como uma chave de cliente durável sua.

Como uma conversa geralmente funciona

1. O contato envia uma mensagem para você. A mensagem recebida traz from.bsuid, e from.phone_number pode estar ausente. Essa mensagem abre a janela de atendimento ao cliente, então você pode responder livremente pelas próximas 24 horas.
2. Você pede o número. Envie uma solicitação de informações de contato, um botão único que permite ao contato compartilhar um número de telefone. A mesma solicitação pode ir em um template pelo botão request_contact_info, que alcança um contato cuja janela já fechou.
3. O contato toca no botão. O número divulgado chega como um cartão de contato de entrada com origin definido como contact_request e o número em phone_numbers. Um cartão de contato divulgado pode descrever outra pessoa ou outro número. Armazene essa divulgação separadamente da identidade WhatsApp do remetente; use as identidades efetivamente fornecidas nas mensagens seguintes em vez de sobrescrever o registro do cliente apenas com base no cartão.

Enviando para um BSUID

{
  "to": "US.13491208655302741918",
  "from": "+13124495648",
  "text": { "body": "Your order shipped." }
}

• O from precisa estar no portfólio ao qual o BSUID está vinculado. Esse é o mesmo requisito de portfólio que a Meta aplica, e uma incompatibilidade falha no WhatsApp em vez de na aceitação.
• Templates de código de verificação de uso único precisam de um número de telefone. Um template gerenciado pelo Bird na categoria authentication, ou um que contenha um botão de código de verificação de uso único, é recusado na aceitação com um 422 E15014 WhatsAppRecipientNotSupportedForTemplate. Um template criado pelo seu espaço de trabalho não é verificado na aceitação: a Meta exige um número de telefone para templates de autenticação one-tap, zero-tap e copy-code, então esse envio é aceito e depois falha.
• Um valor que não é nem um número de telefone nem um BSUID bem formado é recusado na aceitação, com um 422 E15001 WhatsAppInvalidRecipient.
• O preço é definido pelo prefixo de país do BSUID. Um número de telefone fornece o país contra o qual a mensagem é tarifada, e para um envio por BSUID o prefixo de duas letras fornece esse dado.

Lendo e filtrando por BSUID

• Em uma mensagem, from e to trazem cada um um phone_number, um bsuid, ou ambos. Uma mensagem recebida nomeia o contato em from; uma enviada o nomeia em to.
• Em um webhook, os mesmos endereços estão no payload do evento. Consulte eventos do WhatsApp para o envelope.
• Na lista de mensagens, to e from aceitam cada um um BSUID assim como um número de telefone, e cada um corresponde a uma ponta da mensagem. O filtro bsuid corresponde ao contato em qualquer direção. O filtro mais antigo phone_number está descontinuado: to e from o substituem e correspondem a ambos os tipos de identidade.

Próximos passos

• Recebendo cartões de contato: o caminho pelo qual o número compartilhado chega
• Solicitações de informações de contato do WhatsApp: o botão que pede o número
• Enviando mensagens do WhatsApp: o envelope da solicitação, o modelo 202 e tentativas seguras
• Referência de IDs de usuário com escopo de negócio da Meta: o rollout, BSUIDs pai e o restante das superfícies da Meta