1. All Collections >
  2. Canaux >
  3. WhatsApp >
  4. API WhatsApp Cloud

API WhatsApp Cloud

Avatar
JQ Lee
11 min de lecture

Vous pouvez désormais migrer votre compte WhatsApp 360dialog connecté vers l'API WhatsApp Business de respond.io pour bénéficier d'une fiabilité accrue, de coûts réduits et d'un accès à de nouvelles fonctionnalités. En savoir plus sur le processus de migration ici.

Pour connecter l'API WhatsApp Cloud, une application Facebook avec le produit WhatsApp activé est requise. Lis ce guide sur la configuration de ton application Facebook.

Facebook a annoncé la sortie de l'API WhatsApp Cloud le 20 mai, et elle est disponible pour toute entreprise de toute taille, grande ou petite, pour communiquer avec les clients en utilisant l'API officielle WhatsApp.

Cette chaîne a une fenêtre de messagerie limitée à 24 heures en raison des réglementations WhatsApp. En savoir plus sur la politique commerciale de WhatsApp ici.

Connexion à l'API WhatsApp Cloud

Regardez la vidéo ci-dessous pour un guide étape par étape sur la façon de connecter l'API WhatsApp Cloud à respond.io.

How to Connect WhatsApp Cloud API to respond.io

Pour discuter avec vos clients via l'API WhatsApp Cloud, connectez un profil WhatsApp Business et un compte Meta Business.

L'application Facebook et le compte Meta Business sont requis et vous devez être l'administrateur des deux pour vous connecter.

Étape 1 : Accède à Paramètres de l'espace de travail > Clique sur Ajouter un canal

Étape 2 : Localise le canal WhatsApp Cloud API > Clique sur Connecter.

Étape 3 : Clique sur le bouton Se connecter avec Facebook.

Étape 4 : Connectez-vous à l'aide du compte Facebook avec accès administrateur à l'application Facebook et au compte professionnel Meta.

Étape 5 : Dans la liste déroulante, sélectionnez le nom WABA avec le numéro WhatsApp que vous souhaitez connecter.

Étape 6 : Ajoutez l'URL de rappel. Retourne à la section WhatsApp dans l'application Facebook Developer. Accède à la sous-section Configuration et configure l'URL de rappel. Ajoutez l’URL de rappel générée et vérifiez le jeton de respond.io dans les champs correspondants de la boîte de dialogue webhook.

Étape 7 : Sur l’application Facebook, vérifiez et enregistrez les modifications apportées à l’application.

Étape 8 : Abonnez-vous à l'événement webhook. Dans ton application Facebook, sélectionne l'onglet Webhooks sous le panneau Produits et choisis Compte WhatsApp Business dans la liste déroulante. Cliquez sur S'abonner aux messages de l'événement.

Étape 9: Cliquez sur le bouton bascule en haut de la page pour activer le mode direct.

N'oubliez pas de renseigner l'URL de votre politique de confidentialité. Si ce champ est vide, vous ne serez pas autorisé à activer le mode direct.

Étape 10 : Clique sur Enregistrer les modifications pour terminer la configuration.

Une fois que vous avez terminé la configuration, tous les messages envoyés à votre numéro WhatsApp seront maintenant reçus dans votre Espace de travail.

Configuration des canaux

Le canal WhatsApp Cloud API peut être configuré avec un nom de canal unique.

Étape 1 : Accède à Paramètres de l'espace de travail > Clique sur Canaux.

Étape 2 : Localise le canal WhatsApp Cloud API > Clique sur Gérer.

Étape 3 : Configure le nom du canal, utilisé en interne pour identifier le compte.

Étape 4 : Clique sur Enregistrer les modifications pour mettre à jour la configuration du canal.

Métadonnées reçues par chaîne

Différents canaux fournissent différents ensembles de métadonnées de contact à la plate-forme respond.io. Voici la liste des données de contact que vous pourrez obtenir à partir de ce canal :

  • Numéro de téléphone

  • ID du numéro de téléphone

  • Nom du profil

  • identifiant WhatsApp

Gestion du profil de l'API WhatsApp Cloud

S'il est nécessaire d'apporter une modification ou de vérifier votre profil WhatsApp Cloud API, cela peut être fait sur la plateforme respond.io.

Étape 1 : Accède à Paramètres de l'espace de travail > Clique sur Canaux.

Étape 2 : Localise le canal WhatsApp Cloud API > Clique sur Gérer > Profil.

Étape 3 : Clique sur Synchroniser le profil pour obtenir les dernières informations du profil WhatsApp Business.

Étape 4: Modifiez les informations suivantes selon vos besoins.

Champs

Description

Photo de profil

Image affichée comme photo de profil du compte professionnel WhatsApp. Une taille d'image de 640x640 est recommandée.

À propos

Le texte À propos de l'entreprise. Ce texte apparaît dans le profil de l'entreprise sous son image de profil, son numéro de téléphone et ses boutons de contact.

Adresse

Adresse de l'entreprise. Maximum de 256 caractères.

Description

Description de l'entreprise. Maximum de 512 caractères.

E-mail

Adresse e-mail (au format e-mail valide) pour contacter l'entreprise. Maximum de 128 caractères.

Verticale

Secteur d'activité de l'entreprise. Doit être l'une de ces valeurs acceptées : Automobile, Beauté, Spa et salon, Vêtements et habillement, Éducation, Divertissement, Planification et service d'événements, Finance et banque, Alimentation et épicerie, Service public, Hôtels et hébergement, Médical et santé, À but non lucratif, Services professionnels, Shopping et vente au détail, Voyage et transport, Restaurant, Autre. Le secteur d'activité ne peut pas être redéfini sur une valeur vide après sa création.

Site web

URLs (y compris http:// ou https://) associées à l'entreprise (par exemple, site Web, page Facebook, Instagram). Maximum de 2 sites Web avec un maximum de 256 caractères chacun.

Étape 5: Vérifiez les informations et cliquez sur Enregistrer les modifications.

Gestion des modèles de messages WhatsApp

Avant d'envoyer un modèle de message à un contact sur la plateforme respond.io, assure-toi d'avoir fait ce qui suit :

- Soumission du modèle de message pour approbation - Ajout du modèle de message approuvé à l'espace de travail en synchronisant le modèle de message

Soumission de modèles de messages

Étape 1 : Accède à Paramètres de l'espace de travail > Clique sur Canaux.

Étape 2 : Localise le canal WhatsApp Cloud API > Clique sur Gérer.

Étape 3 : Cliquez sur Modèles > Soumettre le modèle pour soumettre un modèle de message pour approbation.

Étape 4: Remplissez les informations requises pour créer un modèle.

Champ

Description

Nom du modèle

Le nom ne peut contenir que des caractères alphanumériques minuscules et des traits de soulignement ( _ )

Catégorie

La catégorie à laquelle appartient le modèle de message.

Langue

La langue dans laquelle le modèle est écrit.

Étape 5: Créez le message en remplissant les composants nécessaires, puis révisez le message dans la section d'aperçu. Vous pouvez inclure les paramètres {{1}}, {{2}}, etc. comme espaces réservés à remplir avec du contenu personnalisé.

Bloc de construction

Description

Corps

Le corps contient le texte le plus important de votre modèle. Seul le texte est pris en charge. Vous pouvez utiliser Markdown pour formater le contenu de ce bloc. En savoir plus.

En-tête

L'en-tête est facultatif et sert de titre ou d'en-tête à votre modèle. Il prend en charge les éléments suivants :
- Texte
- Image
- Vidéo
- Document

* La plateforme Respond.io accepte les téléchargements jusqu'à 20 Mo.

Pied de page

Le pied de page est facultatif et ne prend en charge que le texte. Il peut être utilisé pour fournir des informations supplémentaires dans votre modèle de message.

Bouton

Le bouton est facultatif et ajoute de l'interactivité à vos modèles. Il existe deux types disponibles :
Bouton d'appel à l'action
- Utilisé pour envoyer votre client vers un site Web ou appeler un numéro de téléphone
- Une URL et un numéro de téléphone maximum par modèle
- L'URL peut avoir un paramètre ou une personnalisationRapide

Bouton de réponse
- Utilisé pour obtenir des réponses rapides de votre client
- Maximum 3 boutons de réponse rapide par modèle
- Chaque bouton de réponse rapide ne peut pas comporter plus de 20 caractères

* Les boutons de réponse rapide sont pris en charge uniquement sur les plateformes iOS, Android et Web, mais pas sur la plateforme Windows. Voir plus de détails ici.

Étape 6 : Fournir un exemple de valeur

Ceci n'est applicable que si vous avez inclus des paramètres dans le contenu de votre modèle de message.

Fournir des exemples de valeurs au paramètre dans le modèle de message aidera le réviseur WhatsApp à comprendre le message que vous essayez d'envoyer à vos contacts.

Lien important :Directives relatives aux modèles de messages WhatsApp

Synchronisation des modèles de messages

Étape 1 : Accède à Paramètres de l'espace de travail > Clique sur Canaux.

Étape 2 : Localise le canal WhatsApp Business Platform (API) > Clique sur Gérer.

Étape 3 : Cliquez sur Modèles > Synchroniser le modèle pour commencer le processus de synchronisation.

Le processus de synchronisation est terminé. Cela signifie:

- Les modèles de messages seront répertoriés avec leurs statuts correspondants.- La date et l'heure de la dernière synchronisation seront mises à jour.- Si votre modèle est rejeté, la raison du rejet sera affichée sous le modèle de message rejeté.

Le tableau suivant répertorie les statuts possibles pour les modèles de messages :

Statut

Description

Soumis

Le modèle de message est soumis et en attente d'approbation.

Approuvé

Le modèle de message est approuvé et peut être envoyé aux contacts.

Rejeté

Le modèle de message est rejeté et ne peut pas être utilisé.

Utilisez la recherche et le filtre dans le coin supérieur droit de la liste pour trouver facilement vos modèles !

Types de fichiers pris en charge

Le type de fichier pris en charge par WhatsApp et la taille de fichier maximale pour le type sont les suivants :

  • Audio & Vidéo (16 Mo)

  • Document (100 Mo)

  • Image (5 Mo)

  • Autocollant (100 Ko)

Les messages qui ne sont pas pris en charge auront un affichage de secours avec le texte et le type de message non pris en charge ou de charge utile personnalisée (si disponible). Pour tout type de fichier non pris en charge ou fichier dépassant la taille de fichier maximale envoyée via WhatsApp Cloud API, le fichier sera automatiquement transformé en lien URL sur la plateforme respond.io. Pour les charges utiles personnalisées (Custom Payload), tu peux cliquer sur Afficher plus pour voir la charge utile JSON de ce message. Voici des exemples de messages non pris en charge par l'API WhatsApp Cloud :
- Carte de contact
- Réactions
- Message supprimé
- Sondages
- Message éphémère

Limites de taux

Une limite de débit est le nombre d'appels API qu'une application ou un utilisateur peut effectuer dans une période donnée définie par le canal. En savoir plus sur les limites de débit de ce canal ici.

FAQ et dépannage

Impossible d'envoyer des messages

Assure-toi que le numéro que tu as connecté à la plateforme est un numéro WhatsApp Cloud API.

Les messages n'arrivent pas

Cela peut se produire lorsque le webhook des messages n'est pas abonné.

Étape 1 : Accédez à la page Webhook de l'application Facebook

Ouvrez l'application Facebook et accédez à la page Webhooks.

Étape 2 : Vérifier l’événement auquel vous êtes abonné

Sélectionnez Compte WhatsApp Business et vérifiez si l'événement messages est abonné.

Étape 3 : Envoyer un message de test

Envoyez un message de test au numéro de téléphone WhatsApp et vérifiez s'il est arrivé.

Impossible de recevoir les accusés de lecture

Lorsque l'utilisateur connecté à l'API WhatsApp Cloud modifie son mot de passe Facebook, les autorisations seront obsolètes et devront être actualisées.

Étape 1 : Accède à Paramètres de l'espace de travail > Clique sur Canaux.

Étape 2 : Localise le canal WhatsApp Business Platform (API) > Clique sur Gérer.

Étape 3 : Clique sur Dépannage > Actualiser l'autorisation pour actualiser les autorisations WhatsApp.

Étape 4 : Envoyez un message de test au numéro de téléphone WhatsApp et vérifiez s'il est arrivé.

Impossible d'envoyer des messages sortants : erreur de validation du jeton d'accès

Cela peut se produire pour plusieurs raisons :

  • Lorsque la session de validation du jeton d'accès a expiré.

  • Une modification a été apportée aux privilèges d'administrateur de l'utilisateur dans Meta Business Manager.

  • Il y a eu un changement de mot de passe sur Meta Business Manager.

Pour résoudre cette erreur, tu dois actualiser les autorisations de ton canal WhatsApp Cloud API et renvoyer un message de test.

Vous devez être l'administrateur du Meta Business Manager pour pouvoir actualiser l'autorisation.

Le contact ne reçoit pas de messages

Cela peut se produire lorsque le contact n'a pas accepté les conditions et la politique de confidentialité de WhatsApp.

Si vos contacts ne peuvent pas recevoir de messages de votre numéro d'API WhatsApp Cloud, assurez-vous qu'ils ont accepté les dernières conditions et la politique de confidentialité de WhatsApp.

Quelles sont les exigences pour que le numéro de téléphone soit utilisé pour s'inscrire à l'API WhatsApp Cloud ?

  • Le numéro de téléphone utilisé pour WhatsApp Cloud API ne peut'pas être utilisé dans l'application personnelle ou professionnelle WhatsApp. Vous devrez'supprimer le compte sur l'application personnelle ou professionnelle WhatsApp avant de pouvoir utiliser le numéro pour vous inscrire à une API WhatsApp Cloud.

  • Vous pouvez toujours utiliser le numéro à d'autres fins, comme appeler et recevoir des SMS après l'avoir enregistré sur la plateforme WhatsApp Business.

  • Une fois que vous utilisez un téléphone pour WhatsApp Cloud API, vous ne pouvez plus utiliser ce numéro sur l'application WhatsApp Business.

La vérification de l’entreprise est-elle nécessaire pour commencer à utiliser Cloud API ?

Il n'est pas obligatoire de terminer la vérification d'entreprise Facebook pour commencer à envoyer des messages sur WhatsApp. Sans vérification d'entreprise, votre entreprise pourra toujours :

  • Répondez à un nombre illimité de conversations initiées par les utilisateurs.

  • Envoyez des conversations initiées par l'entreprise (modèles de messages) à 250 clients uniques sur une période continue de 24 heures.

  • Enregistrez jusqu'à 2 numéros de téléphone.

Les entreprises peuvent initier la vérification d'entreprise uniquement lorsqu'elles sont prêtes à développer des conversations initiées par l'entreprise ou souhaitent devenir un compte professionnel officiel.

Puis-je consulter les informations sur mes conversations pour mon compte WhatsApp Business ?

Oui, vous pouvez surveiller vos analyses de messagerie et de dépenses en temps réel pour votre compte professionnel WhatsApp dans l'onglet Insights de votre Meta WhatsApp Manager. En savoir plus ici.

Quelles sont les limites de messagerie WhatsApp ?

Les limites de messagerie déterminent le nombre maximal d'utilisateurs WhatsApp uniques avec lesquels un portefeuille d'entreprise peut initier des conversations à l'initiative de l'entreprise sur une période de 24 heures. Cette limite est partagée entre tous les numéros de téléphone du portfolio.

Ces limites ne s’appliquent pas aux conversations initiées par l’utilisateur. Une conversation initiée par l'entreprise commence lorsque le premier message est envoyé à un client et dure 24 heures.

Une idée reçue courante est que chaque message compte dans la limite — en réalité, plusieurs messages envoyés au même utilisateur dans les 24 heures comptent toujours comme une seule conversation.

En savoir plus ici.

Comment ajouter un mode de paiement à mon compte WhatsApp Business ?

Vous pouvez ajouter un mode de paiement à votre compte WhatsApp Business dans Business Manager. Découvre comment ajouter un mode de paiement à ton compte WhatsApp Business ici.

Pourquoi mon message n'a-t-il pas été envoyé avec une erreur « Problème de paiement d'éligibilité de l'entreprise » ?

Cela est probablement dû au fait que vous avez dépassé le seuil du niveau gratuit mensuel sans mode de paiement valide. Pour résoudre ce problème, ajoute un mode de paiement valide.

Quel est le prix de l'API WhatsApp Cloud ?

À partir du 1er juillet 2025, l'API Cloud de WhatsApp utilise un modèle de tarification hybride. Les Conversations de Service (lorsque tu réponds à un client dans les 24 heures) sont facturées par conversation. Les messages modèles — Marketing, Utilité et Authentification — sont facturés par message envoyé. Les modèles d'utilité sont gratuits s'ils sont envoyés dans les 24 heures, tandis que les modèles d'authentification et de marketing sont toujours facturés par message. Les modèles d'utilité et d'authentification à volume élevé reçoivent des remises tiercées automatiques. Les Conversations d'Entrée Gratuite provenant d'annonces ou de CTA de Page ouvrent une fenêtre gratuite de 72 heures où tous les types de messages sont gratuits.

En savoir plus sur Tarifs WhatsAppici.

Comment supprimer un numéro de téléphone d'un compte professionnel ?

Il y a quelques exigences et étapes nécessaires pour supprimer un numéro de téléphone, en savoir plus ici.

Puis-je utiliser respond.io pour envoyer une diffusion WhatsApp Cloud API avec le numéro de test Meta ?

Vous pouvez envoyer une diffusion de test depuis la plateforme en utilisant le numéro de test Meta. Cependant, une diffusion utilisant le numéro de test est limitée à cinq destinataires. Vous devez d’abord ajouter ces cinq destinataires à la liste des numéros de téléphone dans les outils Meta Developer.

Si vous n'ajoutez pas de destinataires à cette liste ou si vous tentez d'envoyer une diffusion à des destinataires ne figurant pas sur cette liste, vous recevrez ce message d'erreur :

Puis-je supprimer le numéro de test Meta de mon compte Cloud API connecté ?

Non, ce numéro est automatiquement fourni à tous les comptes pour être utilisé pour envoyer des messages de test et ne peut pas être supprimé. Veuillez simplement noter qu’il s’agit d’un numéro de test à ne pas utiliser à d’autres fins.

Pourquoi est-ce que je vois des contacts en double provenant du même canal WhatsApp ?

WhatsApp transmet le numéro de téléphone du Contact dans un format différent du format E.164 utilisé par respond.io. Cette différence entraîne la duplication des contacts de certains pays. Si cela arrive, contacte-nous ici.

Comment modifier le nom d’affichage de mon API Cloud ?

Pour modifier le nom d'affichage de ton Cloud API, suis ces étapes :

  1. Accédez à votre compte WhatsApp FBM > > Numéro de téléphone. Cette page affiche votre limite et votre qualité de messagerie.

  2. Passez la souris sur l’icône en forme de crayon à côté du nom d’affichage pour activer la modification.

  3. Cliquez sur Suivant pour soumettre votre nouveau nom d'affichage à Meta pour approbation.

  4. Attendez la confirmation de l'approbation de Meta.

Quelles étapes dois-je suivre une fois que mon nouveau nom d’affichage pour mon API Cloud est approuvé ?

Après avoir reçu l’approbation de Meta pour votre nouveau nom d’affichage, procédez comme suit :

  1. Réenregistrez votre numéro de téléphone en utilisant le nom d’affichage nouvellement approuvé.

  2. Exécute un appel API POST pour vérifier ton numéro de téléphone.

  3. Effectue un autre appel API POST à réenregistrer le numéro de téléphone vérifié.

  4. Une fois que c'est réussi, la mise à jour du nom d'affichage de ton API Cloud est complète.

Pourquoi ai-je rencontré l'erreur "Erreur de validation du jeton d'accès : la session a été invalidée car l'utilisateur a changé son mot de passe ou Facebook a modifié la session pour des raisons de sécurité" lorsque j'essaie d'envoyer un message ?

Cette erreur se produira si tu as récemment mis à jour tes informations d'identification Facebook, cela peut perturber la connexion au canal sur notre plateforme, entraînant des erreurs lors de l'envoi de messages.

Pour résoudre ce problème, tu dois actualiser les autorisations de la chaîne sur notre plateforme à l'aide de tes informations d'identification Facebook mises à jour. Ce processus nécessite un rôle d’administrateur. En rafraîchissant les autorisations, tu rétabliras la connexion avec tes nouvelles identifiants, garantissant que tes messages sortants sont envoyés avec succès sans rencontrer d'erreurs.

Comment déconnecter WhatsApp Cloud API de respond.io ?

Pour arrêter d'utiliser WhatsApp Cloud API avec respond.io, suis ces étapes :

Étape 1 : Supprime le canal dans respond.io

  • Va dans Paramètres de l'espace de travail > Canaux.

  • Sélectionne ton canal WhatsApp Cloud API.

  • Supprime le canal.

Étape 2 : Supprime le numéro de téléphone depuis WhatsApp Manager

  • Va dans Meta Business Manager.

  • Accède à WhatsApp Manager > Phone Numbers.

  • Supprime le numéro de téléphone.

Que se passe-t-il après avoir désactivé WhatsApp Cloud API ?

  • Respond.io cessera de recevoir et d'envoyer des messages.

  • Les Webhooks connectés à respond.io cesseront de fonctionner.

Important :

  • La suppression du canal dans respond.io ne supprime pas automatiquement le numéro de ton compte Meta Business.

  • Si tu veux réutiliser le numéro dans l'application WhatsApp Business, tu dois d'abord le supprimer du Cloud API (comme l'exige Meta).

  • Si le numéro continue à envoyer des messages via une autre intégration, la tarification standard des conversations Meta peut s'appliquer.

Partager cet article
Telegram
Facebook
Linkedin
Twitter

Vous ne trouvez pas ce que vous recherchez? 🔎