Enregistrement
Vous devez enregistrer votre numéro de téléphone professionnel pour pouvoir l’utiliser dans l’API Cloud. Enregistrez votre numéro de téléphone professionnel dans les cas suivants :
- Création de compte : lorsque vous implémentez cette API, vous devez enregistrer le numéro de téléphone professionnel que vous souhaitez utiliser pour envoyer des messages. La vérification en deux étapes doit être configurée lors de la création du compte afin de renforcer la sécurité.
- Changement de nom : dans ce cas, votre téléphone est déjà enregistré et vous souhaitez changer le nom à l’écran. Pour ce faire, vous devez d’abord déposer une demande de changement de nom dans le gestionnaire WhatsApp. Une fois le nom approuvé, vous devez à nouveau enregistrer votre téléphone sous ce nouveau nom.
- Migration de votre numéro de l’API On-Premises vers l’API Cloud. Voir Exception concernant la migration.
Pour pouvoir enregistrer votre numéro de téléphone professionnel, vous devez d’abord effectuer une vérification de la propriété.
Exception concernant la migration
Si vous migrez un numéro de téléphone de l’API On-Premises vers l’API Cloud, vous devez suivre des étapes supplémentaires avant d’enregistrer un numéro de téléphone avec cette dernière. Consultez la page Migrer entre les API On-Premises et Cloud pour découvrir le processus complet.
Enregistrer un numéro de téléphone professionnel
Pour enregistrer votre numéro de téléphone professionnel vérifié, effectuez un appel POST sur PHONE_NUMBER_ID/register. Ajoutez les paramètres répertoriés ci-dessous.
| Point de terminaison | Authentification |
|---|---|
(Consultez la section Obtenir l’ID du numéro de téléphone) |
Solution Partners must authenticate themselves with an access token with the |
Limites
Les requêtes envoyées au point de terminaison d’enregistrement sont limitées à 10 par numéro professionnel dans une fenêtre mobile de 72 heures.
Lorsque vous envoyez une requête d’enregistrement, nous vérifions le nombre de requêtes que vous avez envoyées pour enregistrer ce numéro au cours des 72 dernières heures. Si vous avez déjà envoyé 10 requêtes, l’API renvoie le code d’erreur 133016, et le numéro ne peut plus être enregistré pendant les 72 heures suivantes.
Paramètres
| Nom | Description |
|---|---|
| Obligatoire. Service de messagerie utilisé. Définissez ce paramètre sur |
| Obligatoire. Si la vérification en deux étapes est déjà activée pour votre numéro de téléphone professionnel vérifié, définissez cette valeur sur le code PIN à 6 chiffres correspondant. Si vous ne vous souvenez plus de votre code PIN, vous pouvez l’actualiser. Si, au contraire, vous n’avez pas activé cette vérification, définissez cette valeur sur un nombre à 6 chiffres, qui sera alors le nouveau code PIN de vérification en deux étapes de votre numéro de téléphone professionnel vérifié. |
| Facultatif. S’il est inclus, le stockage local est activé sur le numéro de téléphone professionnel. La valeur doit être l’indicatif pays ISO 3166 de deux lettres (par ex. Valeurs acceptées : APAC
Europe
LATAM
MEA
NORAM
Une fois activé, il ne peut pas être désactivé ou modifié directement. Vous devez annuler l’enregistrement du numéro et l’enregistrer à nouveau sans ce paramètre (pour le désactiver), ou inclure le paramètre avec le nouvel indicatif pays (pour le modifier). Pour activer le stockage local sur un numéro déjà enregistré, vous devez annuler l’enregistrement du numéro, puis l’enregistrer à nouveau et inclure ce paramètre. |
Exemple de requête sans stockage local
curl 'https://graph.facebook.com/v19.0/106540352242922/register ' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer EAAJB...' \
-d '
{
"messaging_product": "whatsapp",
"pin": "212834"
}
Exemple de requête avec stockage local
curl 'https://graph.facebook.com/v19.0/106540352242922/register ' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer EAAJB...' \
-d '
{
"messaging_product": "whatsapp",
"pin": "212834",
"data_localization_region": "CH"
}
All API calls require authentication with access tokens.
Developers can authenticate their API calls with the access token generated in the App Dashboard > WhatsApp > API Setup.
Solution Partners must authenticate themselves with an access token with the whatsapp_business_messaging and whatsapp_business_management permissions. See System User Access Tokens for information.
Annuler l’enregistrement d’un numéro de téléphone professionnel
L’annulation de l’enregistrement d’un numéro de téléphone professionnel empêche son utilisation avec l’API Cloud et désactive le stockage local sur le numéro, s’il avait été activé.
L’annulation de l’enregistrement ne supprime pas un numéro ou son historique des messages. Pour supprimer un numéro et son historique, consultez Suppression d’un numéro de téléphone dans un compte WhatsApp Business.
Pour annuler l’enregistrement d’un numéro de téléphone professionnel, effectuez un appel POST sur PHONE_NUMBER_ID/deregister :
| Point de terminaison | Authentification |
|---|---|
(Consultez la section Obtenir l’ID du numéro de téléphone) |
Solution Partners must authenticate themselves with an access token with the |
Limites
Les requêtes au point de terminaison d’annulation d’enregistrement sont limitées à 10 par numéro professionnel dans une fenêtre mobile de 72 heures.
Lorsque vous envoyez une requête d’annulation d’enregistrement, nous vérifions le nombre de requêtes que vous avez envoyées pour annuler l’enregistrement de ce numéro au cours des 72 dernières heures. Si vous avez déjà envoyé 10 requêtes, l’API renvoie le code d’erreur 133016, et l’enregistrement du numéro ne peut plus être annulé pendant les 72 heures suivantes.
Exemple
Exemple de requête :
curl -X POST \
'https://graph.facebook.com/v19.0/FROM_PHONE_NUMBER_ID/deregister' \
-H 'Authorization: Bearer ACCESS_TOKEN'
Exemple de réponse positive :
{
"success": true
}