Gérer les numéros de téléphone professionnels

Ce guide fournit des informations générales sur les numéros de téléphone pour les fournisseurs de solutions partenaires et les client·es. Il décrit par ailleurs le processus à suivre par les fournisseurs de solutions partenaires pour gérer le numéro de téléphone et les certificats d’un·e client·e.

Informations préliminaires sur les numéros de téléphone professionnels

Les entreprises doivent connaître certains détails concernant les numéros de téléphone et l’inscription intégrée.

Les entreprises ont besoin d’un numéro dédié pour utiliser WhatsApp par le biais d’une inscription intégrée. Si une entreprise possède déjà un numéro actif dans les applications WhatsApp Messenger ou WhatsApp Business, elle ne peut pas utiliser le même numéro de téléphone.

Les entreprises peuvent associer plusieurs numéros de téléphone à leur compte business Meta. Il leur suffit donc d’ajouter un numéro de téléphone et de l’utiliser pour WhatsApp.

Une entreprise ne peut pas s’inscrire à l’aide du flux d’inscription intégrée avec un numéro de téléphone qui a déjà été enregistré dans la version professionnelle ou grand public de WhatsApp.

Pour plus d’informations sur les numéros de téléphone et la plateforme WhatsApp Business, consultez la page Numéros de téléphone.

Pour savoir comment transférer un numéro de téléphone WhatsApp déjà enregistré, consultez la section Transférer un numéro de téléphone.

Instructions destinées à la clientèle professionnelle

Cette section s’adresse aux client·es de l’inscription intégrée et donne des conseils sur les actions possibles avec les numéros de téléphone.

Ajouter des numéros de téléphone à un compte WhatsApp Business

Deux méthodes permettent d’ajouter des numéros supplémentaires à un compte WhatsApp Business (WABA) :

  1. [Recommandation] Repassez par le flux d’inscription intégrée, sélectionnez les comptes Business Manager et WhatsApp Business existants, ajoutez le numéro et vérifiez-le.
  2. Dans Business Manager, accédez à l’onglet Numéros de téléphone du Gestionnaire WhatsApp, puis sélectionnez Ajouter un numéro de téléphone. Avec cette option, le fournisseur de solutions partenaire doit vérifier manuellement le numéro de téléphone, car cette opération n’est pas disponible dans le Business Manager. C’est pour cette raison qu’il est recommandé aux entreprises de suivre le flux d’inscription intégrée pour ajouter des numéros supplémentaires.

Instructions pour les fournisseurs de solutions partenaires

Cette section s’adresse aux fournisseurs de solutions partenaires et fournit des instructions sur la gestion des numéros de téléphone et des certificats des client·es.

Obtenir des numéros de téléphone

Utilisez le point de terminaison GET /<WABA_ID>/phone_numbers pour obtenir une liste des numéros de téléphone professionnels sur le compte WhatsApp Business d’une entreprise.

Requête

curl 'https://graph.facebook.com/<API_VERSION>/<CUSTOMER_WABA_ID>/phone_numbers' \ -H 'Authorization: Bearer <CUSTOMER_BUSINESS_TOKEN>' 

Réponse

En cas de réussite :

{ "data": [ { "verified_name": "<VERIFIED_DISPLAY_NAME>", "code_verification_status": "<VERIFICATION_STATUS>", "display_phone_number": "<DISPLAY_PHONE_NUMBER>", "quality_rating": "<QUALITY_RATING>", "platform_type": "CLOUD_API", "throughput": { "level": "<THROUGHPUT_LEVEL>" }, "webhook_configuration": { "application": "<WEBHOOK_CALLBACK_URL>" }, "id": "<BUSINESS_PHONE_NUMBER_ID>" } ], "paging": { "cursors": { "before": "<BEFORE_CURSOR>", "after": "<AFTER_CURSOR>" } } } 

Enregistrer des numéros de téléphone pour l’API Cloud

Après une vérification réussie du téléphone à partir du flux d’inscription intégrée, l’enregistrement devrait entraîner un appel d’API au point de terminaison register. À cet effet, fournissez un code_method (sms | voice). Le numéro de téléphone étant déjà vérifié, il est inutile de vous soucier du code d’inscription. L’appel d’API verify n’est pas requis.

Autrement, vous pouvez pré-vérifier les numéros de téléphone et les proposer à votre clientèle dans le nouveau flux d’inscription intégrée. Cela leur évitera de vous contacter pour obtenir un mot de passe à usage unique pendant le processus d’intégration. Voir la section Numéros de téléphone pré-vérifiés.

Enregistrer des numéros de téléphone pour l’API On-Premises

Après une vérification réussie du téléphone à partir du flux d’inscription intégrée, l’enregistrement devrait entraîner un appel d’API au point de terminaison account. À cet effet, fournissez un code_method (sms | voice). Le numéro de téléphone étant déjà vérifié, il est inutile de vous soucier du code d’inscription. L’appel d’API verify n’est pas requis.

Autrement, vous pouvez pré-vérifier les numéros de téléphone et les proposer à votre clientèle dans le nouveau flux d’inscription intégrée. Cela leur évitera de vous contacter pour obtenir un mot de passe à usage unique pendant le processus d’intégration. Voir la section Numéros de téléphone pré-vérifiés.

Un numéro de téléphone doit être inscrit jusqu’à 14 jours après l’activation d’un flux d’inscription intégrée. Si aucun numéro n’est inscrit durant cet intervalle, il est nécessaire de relancer le flux d’inscription intégrée.

Obtenir le statut et le certificat du téléphone

Le point de terminaison phone_numbers vous permet de voir le statut du nom d’usage d’un numéro de téléphone et de récupérer le certificat après un changement de nom. Pour plus d’informations, consultez Lecture des numéros de téléphone.

Exemple de requête

Dans l’exemple suivant, utilisez l’ID du compte WhatsApp Business affecté.

curl -i -X GET "https://graph.facebook.com/v21.0/{waba-id}/phone_numbers
  ?fields=
    display_phone_number,
    certificate,
    name_status,
    new_certificate,
    new_name_status
  &access_token={system-user-access-token}"
Pour trouver l’ID d’un compte WhatsApp Business, accédez à Business Manager > Paramètres d’entreprise > Comptes > Comptes WhatsApp Business. Recherchez le compte que vous souhaitez utiliser et cliquez dessus. Un panneau s’ouvre avec les informations sur le compte, y compris l’ID.

Exemple de réponse

{
  "data": [
    {
      "id": "1972385232742141",    
      "display_phone_number": "+1 631-555-1111",
      "last_onboarded_time": "2023-08-22T19:05:53+0000",
      "certificate": "AbCdEfGhIjKlMnOpQrStUvWxYz",
      "new_certificate": "123AbCdEfGhIjKlMnOpQrStUvWxYz",
      "name_status": "APPROVED",
      "new_name_status": "APPROVED",
    }
  ]
}

Paramètres de la réponse

NomDescription

name_status

Statut d’examen de la demande du nom d’usage en cours.

Cliquez sur la flèche de la colonne de gauche pour afficher les options disponibles.

Options disponibles

  • APPROVED : le nom a été approuvé. Vous pouvez télécharger votre certificat maintenant.
  • DECLINED : le nom n’a pas été approuvé. Vous ne pouvez pas télécharger votre certificat.
  • EXPIRED : votre certificat a expiré et ne peut plus être téléchargé.
  • PENDING_REVIEW : votre demande de nom est en cours d’examen. Vous ne pouvez pas télécharger votre certificat.
  • NONE : aucun certificat n’est disponible.

new_name_status

Statut d’examen d’une demande de nom d’usage. Ce champ renvoie des données uniquement si un changement de nom d’usage a été demandé.

certificate

Renvoie le certificat actuel pour ce numéro de téléphone.

new_certificate

Certificat d’un nouveau nom d’usage, après qu’un changement de nom d’usage ait été approuvé. Ce champ ne renvoie des données que si une demande de changement de nom d’usage a été approuvée et est disponible jusqu’à ce que le numéro de téléphone ait été enregistré avec le nouveau certificat.

Obtenir le statut du mot de passe à usage unique du téléphone

Pour savoir si un numéro de téléphone a été vérifié à l’aide d’un mot de passe à usage unique, consultez le champ code_verification_status de ce numéro. Commencez par effectuer un appel GET vers le point de terminaison /{whatsapp-business-account-id}/phone_numbers :

curl -i -X GET \ 
"https://graph.facebook.com/v21.0/{waba-id}/phone_numbers
  ?access_token={your-access-token}"

Le champ « code_verification_status » de la réponse correspond au statut de vérification du mot de passe, avec l’une des options suivantes : VERIFIED ou NOT_VERIFIED. Voici un exemple de réponse :

[
  {
    "code_verification_status": "NOT_VERIFIED",
    "id": "1754951608042154"
  }
]

Vous pouvez également obtenir le statut d’un numéro de téléphone en ciblant son ID :

curl -i -X GET \ 
"https://graph.facebook.com/v21.0/{phone-number-id}
  ?access_token={your-access-token}"
Pour obtenir un ID de numéro de téléphone, appelez https://graph.facebook.com/v21.0/{whatsapp-business-account-ID}/phone_numbers. Remplacez {whatsapp-business-account-ID} par l’ID du compte WhatsApp Business auquel appartient le numéro de téléphone. Pour obtenir un exemple, consultez Obtenir tous les numéros de téléphone.

Filtrer les numéros de téléphone selon leur mode de compte

Vous pouvez interroger des numéros de téléphone et les filtrer selon leur account_mode. Pour la requête, vous pouvez utiliser les paramètres indiqués ci-après.

Paramètres de la requête

NomDescription

field

Comporte le champ utilisé pour le filtrage. Dans cet exemple, vous devriez utiliser account_mode.

operator

Spécifie la façon dont vous souhaitez filtrer les comptes. Dans cet exemple, vous devriez utiliser EQUAL.

value

Contient le mode de compte que vous recherchez.

Cliquez sur la flèche de la colonne de gauche pour afficher les valeurs acceptées.

Valeurs acceptées

  • SANDBOX : le compte n’a pas été vérifié.

  • LIVE : le compte n’est pas éligible à l’environnement de test non vérifié ou est devenu un compte vérifié.

Exemple de requête

Dans l’exemple suivant, utilisez l’ID du compte WhatsApp Business affecté.

curl -i -X GET "https://graph.facebook.com/v21.0/{waba-id}/phone_numbers
  ?filtering=[{
    "field":"account_mode",
    "operator":"EQUAL",
    "value":"SANDBOX"}]
  &access_token={system-user-access-token}"

Exemple de réponse

{
  "data": [
    {
      "id": "1972385232742141",    
      "display_phone_number": "+1 631-555-1111",
      "verified_name": "John’s Cake Shop",
      "quality_rating": "UNKNOWN",
    }
  ],
  "paging": {
	"cursors": {
		"before": "abcdefghij"
		"after": "klmnopqr"
	}
   }
}