Identifiants utilisateur à portée métier

Pourquoi un contact arrive sans numéro de téléphone

À quoi ressemble un BSUID

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

• Transmettez la valeur entière, telle quelle. Meta rejette un BSUID modifié, donc aucune partie n'est facultative : le code pays, le point et chaque caractère de l'identifiant voyagent ensemble. Bird valide le format avant d'accepter un envoi, et le code pays doit être en majuscules et correspondre à un vrai code ISO 3166 alpha-2 ; un préfixe en minuscules ou inconnu est refusé plutôt que corrigé. La limite de 128 caractères s'applique à l'identifiant après le code pays, et après le segment ENT. sur un BSUID parent.
• Il est limité à un portefeuille métier. Tout numéro de téléphone professionnel du même portefeuille peut envoyer un message à ce BSUID ; un numéro d'un autre portefeuille ne le peut pas, et l'envoi échoue.
• Il n'est pas permanent. Meta indique que le BSUID d'un contact est régénéré lorsque celui-ci change de numéro de téléphone, il identifie donc un interlocuteur plutôt que de servir de clé client durable.

Déroulement habituel d'une conversation

1. Le contact vous écrit. Le message entrant contient from.bsuid, et from.phone_number peut être absent. Ce message ouvre la fenêtre de service client, vous pouvez donc répondre librement pendant les 24 heures suivantes.
2. Vous demandez le numéro. Envoyez une demande d'informations de contact, un bouton unique qui permet au contact de partager un numéro de téléphone. La même demande peut transiter par un modèle via son bouton request_contact_info, qui atteint un contact dont la fenêtre a expiré.
3. Le contact appuie sur le bouton. Le numéro divulgué arrive sous forme de carte de contact entrante avec origin défini sur contact_request et le numéro dans phone_numbers. Une carte de contact divulguée peut décrire une autre personne ou un autre numéro. Stockez cette divulgation séparément de l'identité WhatsApp de l'expéditeur ; utilisez les identités effectivement fournies dans les messages suivants plutôt que d'écraser l'enregistrement client à partir de la seule carte.

Envoyer à un BSUID

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

• from doit appartenir au portefeuille auquel le BSUID est rattaché. C'est la même exigence de portefeuille que Meta applique, et une incohérence échoue à WhatsApp plutôt qu'à l'acceptation.
• Les templates de code à usage unique nécessitent un numéro de téléphone. Un template géré par Bird dans la catégorie authentication, ou portant un bouton de code à usage unique, est refusé à l'acceptation avec une 422 E15014 WhatsAppRecipientNotSupportedForTemplate. Un template créé par votre espace de travail n'est pas vérifié à l'acceptation : Meta exige un numéro de téléphone pour les templates d'authentification one-tap, zero-tap et copy-code, donc un tel envoi est accepté puis échoue.
• Une valeur qui n'est ni un numéro de téléphone ni un BSUID bien formé est refusée à l'acceptation, avec une 422 E15001 WhatsAppInvalidRecipient.
• Le prix est déterminé par le préfixe pays du BSUID. Un numéro de téléphone fournit le pays sur lequel un message est tarifé, et pour un envoi par BSUID le préfixe à deux lettres le fournit à la place.

Lecture et filtrage par BSUID

• Sur un message, from et to contiennent chacun un phone_number, un bsuid, ou les deux. Un message entrant nomme le contact sur from ; un message sortant le nomme sur to.
• Sur un webhook, les mêmes adresses figurent dans le payload de l'événement. Consultez Événements WhatsApp pour l'enveloppe.
• Sur la liste de messages, to et from acceptent chacun un BSUID aussi bien qu'un numéro de téléphone, et chacun correspond à une extrémité du message. Le filtre bsuid correspond au contact dans les deux sens. L'ancien filtre phone_number est obsolète : to et from le remplacent et correspondent aux deux types d'identité.

Étapes suivantes

• Recevoir des cartes de contact : le canal par lequel le numéro partagé arrive
• Demandes d'informations de contact WhatsApp : le bouton qui demande le numéro
• Envoyer des messages WhatsApp : l'enveloppe de requête, le modèle 202 et les réessais sûrs
• Référence business-scoped user IDs de Meta : le déploiement, les BSUID parents et les autres surfaces Meta