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.
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.
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.
Deux méthodes permettent d’ajouter des numéros supplémentaires à un compte WhatsApp Business (WABA) :
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.
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.
curl 'https://graph.facebook.com/<API_VERSION>/<CUSTOMER_WABA_ID>/phone_numbers' \ -H 'Authorization: Bearer <CUSTOMER_BUSINESS_TOKEN>'
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>" } } }
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.
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.
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.
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}"
{ "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", } ] }
Nom | Description |
---|---|
| 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. |
| 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é. |
| Renvoie le certificat actuel pour ce numéro de téléphone. |
| 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. |
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}"
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.
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.
Nom | Description |
---|---|
| Comporte le champ utilisé pour le filtrage. Dans cet exemple, vous devriez utiliser |
| Spécifie la façon dont vous souhaitez filtrer les comptes. Dans cet exemple, vous devriez utiliser |
| Contient le mode de compte que vous recherchez. Cliquez sur la flèche de la colonne de gauche pour afficher les valeurs acceptées. |
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}"
{ "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" } } }