Identifiants utilisateur propres à une entreprise

Un identifiant utilisateur propre à une entreprise (BSUID) vous permet d'écrire à un utilisateur WhatsApp sans son numéro de téléphone. Il identifie l'utilisateur au sein de votre portefeuille business Meta.

Noms d'utilisateur WhatsApp

Les utilisateurs WhatsApp qui ont un nom d'utilisateur peuvent vous écrire sans partager leur numéro de téléphone. Leurs messages incluent from.bsuid ; from.phone_number peut être absent. Les utilisateurs sans nom d'utilisateur peuvent aussi avoir un BSUID.

Meta inclut le numéro de téléphone si l'utilisateur figure dans votre carnet de contacts Meta ou a échangé des messages ou des appels avec votre numéro professionnel au cours des 30 derniers jours. La règle des 30 jours s'applique par numéro professionnel.

from.username et from.display_name sont facultatifs. Vous ne pouvez pas envoyer de messages à ces valeurs.

Format d'un BSUID

Un BSUID contient un code de pays ISO 3166 alpha-2 en majuscules, un point et jusqu'à 128 lettres ou chiffres. Par exemple : US.13491208655302741918.

Enregistrez et envoyez la valeur complète sans la modifier. Utilisez un numéro d'expéditeur du même portefeuille business. Meta refuse les messages envoyés depuis d'autres portefeuilles.

Le BSUID change lorsque l'utilisateur change de numéro de téléphone. Enregistrez-le donc sous votre propre identifiant client.

Un BSUID parent fonctionne dans les portefeuilles inscrits par une entreprise gérée. Il ajoute ENT. après le code de pays : US.ENT.11815799212886844830. La limite de 128 caractères s'applique à la partie après ENT.. Bird accepte les deux formats.

Demander un numéro de téléphone

Ces exemples de l'API de messagerie montrent uniquement les champs nécessaires à cet échange.

{
  "direction": "inbound",
  "from": {
    "bsuid": "US.13491208655302741918"
  },
  "to": {
    "phone_number": "+14155550100"
  },
  "text": {
    "body": "Can I book a repair?"
  }
}

{
  "direction": "outbound",
  "from": {
    "phone_number": "+14155550100"
  },
  "to": {
    "bsuid": "US.13491208655302741918"
  },
  "interactive": {
    "type": "request_contact_info",
    "body_text": "Share your number."
  }
}

{
  "direction": "inbound",
  "from": {
    "bsuid": "US.13491208655302741918",
    "phone_number": "+14155550101"
  },
  "contact_cards": [
    {
      "origin": "contact_request",
      "phone_numbers": [
        {
          "phone_number": "+14155550101"
        }
      ]
    }
  ]
}

Si l'utilisateur ferme la demande, vous ne recevez ni message ni webhook. Définissez un délai d'attente pour que votre application puisse continuer sans le numéro.

Envoyer un message

Définissez to avec le BSUID et from avec votre numéro professionnel WhatsApp :

{
  "to": "US.13491208655302741918",
  "from": "+14155550100",
  "text": { "body": "Your repair is booked." }
}

Si le message entrant contient uniquement un BSUID, répondez à ce BSUID depuis le même numéro professionnel. Un numéro de téléphone provenant de vos propres données peut ne pas avoir de fenêtre de service ouverte, ce qui provoque 422 E15044.

• Les modèles d'authentification nécessitent un numéro de téléphone.
• Un numéro de téléphone ou un BSUID invalide renvoie 422 E15001.
• Le prix du message dépend du code de pays du BSUID.

La fenêtre de service client s'applique aussi aux BSUID. Une réponse 202 signifie que l'API a accepté votre requête. Vérifiez le statut du message pour confirmer sa livraison.

Rechercher des messages

Dans les messages et les webhooks, from identifie l'expéditeur et to le destinataire. Chacun peut contenir phone_number, bsuid ou les deux.

Pour lister les messages, filtrez par :

• from ou to pour un expéditeur ou un destinataire, avec son numéro de téléphone ou son BSUID.
• bsuid pour les messages envoyés à un même utilisateur WhatsApp ou reçus de lui.

Le filtre phone_number est obsolète. Utilisez from ou to à la place.

Guides associés

• Recevoir des fiches de contact
• Demandes de coordonnées WhatsApp
• Envoyer des messages WhatsApp
• Référence Meta sur les identifiants utilisateur propres à une entreprise