respond-io
New
🚀 TikTok Business Messaging est en direct! Transformez les conversations en conversions de manière transparente. En savoir plus.
arrow-icon

Accueil >

Canaux >
WhatsApp >
API WhatsApp Cloud

API WhatsApp Cloud

Avatar
JQ Lee
· 23 Jul 2024
10 min de lecture

Tu peux maintenant migrer ton compte WhatsApp 360 connecté vers l’API WhatsApp de respond.io pour profiter d’une plus grande fiabilité, de coûts plus bas et de l’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. Lisez ce guide sur la façon de configurer votre application Facebook.

Facebook a annoncé la sortie de WhatsApp Cloud API le 20 mai, et il est disponible pour n'importe quelle entreprise de n'importe quelle taille, gros et petit 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èglements de WhatsApp. En savoir plus sur la politique d'affaires de WhatsApp's ici.

Connexion de 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.

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

Facebook App et Meta Business Account sont requis et vous devez être l'administrateur des deux pour vous connecter.

Étape 1 :Accédez àParamètres de l'espace de travail> Cliquez surAjouter un canal

Étape 2 :Localisez le canal API WhatsApp Cloud > Cliquez surConnect.

Étape 3 : Cliquez sur le boutonSe connecter avec Facebook.

Étape 4 : Connectez-vous en utilisant le compte Facebook avec un accès admin au compte Facebook App et Meta Business.

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

Étape 6 : Ajouter l'URL de rappel. Retournez à la sectionWhatsAppdans l'application développeur Facebook. Naviguez vers la sous-sectionConfigurationet configurez l'URL de rappel. Ajoute l'URL de rappel générée et vérifie le jeton de respond.io aux champs correspondants dans la boîte de dialogue du 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. Sur votre application Facebook, sélectionnez l'ongletWebhookssous le panneauProductset sélectionnezWhatsApp Business Accountdans la liste déroulante. Cliquez sur l'évènement des messages d'abonnement.

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

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

Étape 10: Cliquez 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 désormais reçus dans votre espace de travail.

Configuration du canal

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

Étape 1 :Accédez àParamètres de l'espace de travail> Cliquez surCanaux.

Étape 2 :Localisez le canal API WhatsApp Cloud > Cliquez surGérer.

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

Étape 4 :Cliquez surEnregistrer les modifications pour mettre à jour la configuration du canal.

Métadonnées reçues par canal

Différents canaux fournissent différents ensembles de métadonnées de Contact à la plateforme 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

  • ID WhatsApp

Gestion du profil API WhatsApp Cloud

S'il y a un besoin de faire un changement ou de vérifier votre profil de l'API WhatsApp Cloud, cela peut être fait sur la plateforme respond.io.

Étape 1 :Accédez àParamètres de l'espace de travail> Cliquez surCanaux.

Étape 2 :Localisez le canal API WhatsApp Cloud > CliquezGérer > Profil.

Étape 3: Cliquez sur Synchroniser le profil pour obtenir les dernières informations de profil WhatsApp de WhatsApp.

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

Champs

Libellé

Photo de profil

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

À propos de

L'entreprise's À propos du texte. 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.

Adresses

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

Libellé

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

Courriel

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

Vertical

L'industrie de l'entreprise. Doit être l'une de ces valeurs acceptées:AutomotiveBeauty, Spa and SalonClothing and ApparelEducationEntertainmentEvent Planning and ServiceFinance and BankingFood and GroceryPublic ServiceHotel and LodgingMedical and HealthNon-profit Professional ServicesShopping and RetailTravel and TransportationRestaurantOtherThe business vertical ne peut pas être retardée à 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 effectué les actions suivantes :

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

Soumettre des modèles de message

Étape 1 :Accédez àParamètres de l'espace de travail> Cliquez surCanaux.

Étape 2 :Localisez le canal API WhatsApp Cloud > CliquezGé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

Libellé

Nom du modèle

Le nom ne peut contenir que des caractères alphanumériques en minuscules et des tirets bas ( _ )

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. en tant que marqueurs à remplir avec du contenu personnalisé.

Bloc de construction

Libellé

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 ici.

En-tête

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

* Réponse. o plate-forme accepte les téléchargements jusqu'à 20 Mo.

Pied de page

Le pied de page est optionnel et ne supporte 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 l'interactivité à vos modèles. Il y a deux types disponibles :
Bouton Appel à l'action
- Utilisé pour envoyer votre client à un site Web ou appeler un numéro de téléphone
- Maximum une URL et un numéro de téléphone par modèle
- L'URL peut avoir un paramètre ou une personalizationQuick

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 avoir plus de 20 caractères

* Boutons de réponse rapide ne sont pris en charge que sur iOS, Android et les plateformes web, mais pas sur la plate-forme Windows. Reportez-vous à plus de détails ici.

Étape 6: Fournir la valeur de l'échantillon

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 message

Étape 1 :Accédez àParamètres de l'espace de travail> Cliquez surCanaux.

Étape 2 :Localisez le canal > Cliquez surGérer de la plateforme WhatsApp Business Platform (API).

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

Le processus de synchronisation est terminé. Cela signifie :

- Les modèles de messages seront listés avec leurs statuts correspondants.- La dernière date synchronisée sera mise à jour. Si votre modèle est rejeté, la raison du rejet sera affichée sous le modèle de message rejeté.

La table suivante liste les statuts possibles pour les modèles de message :

Statut

Libellé

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 en haut à droite 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 est le suivant:

  • Audio & Vidéo (16Mo)

  • Document (100 Mo)

  • Image (5 Mo)

  • Autocollant (100 KB)

Les messages qui ne sont pas pris en charge afficheront un affichage de secours avec message non pris en charge ou payload personnalisé texte et type (si disponible). Pour tout type de fichier ou fichier non pris en charge qui dépasse la taille maximale de fichier envoyée via l'API WhatsApp Cloud, le fichier sera automatiquement transformé en lien URL sur la réponse. o plate-forme. Pour une charge payante personnalisée, vous pouvez cliquer sur Afficher plus depour afficher la charge utile JSON de ce message. Exemples de messages non pris en charge pour l'API WhatsApp Cloud sont:
- Carte de contact
- Réactions
- Message supprimé
- Sondages
- Message éphémère

Limites de taux

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

FAQ et dépannage

Impossible d'envoyer des messages

Assurez-vous que votre numéro've connecté à la plateforme est un numéro d'API WhatsApp Cloud.

Les messages ne sont pas en attente

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

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

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

Étape 2 : Vérifiez l'événement souscrit

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 reçus de lecture

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

Étape 1 :Accédez àParamètres de l'espace de travail> Cliquez surCanaux.

Étape 2 :Localisez le canal > Cliquez surGérer de la plateforme WhatsApp Business Platform (API).

Étape 3 : Cliquez sur Dépannage >Rafraîchir la permissionpour 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 les messages sortants: Validation du jeton d'accès

Cela peut se produire pour quelques raisons :

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

  • Il y a eu une modification des privilèges d'administration de l'utilisateur's dans Meta Business Manager.

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

Pour résoudre cette erreur, vous devez actualiser les autorisations de votre canal WhatsApp Cloud API et envoyer à nouveau un message de test.

Vous devez être l'administrateur de Meta Business Manager pour pouvoir actualiser les autorisations.

Contacter ne pas recevoir de messages

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

Si vos Contacts ne peuvent pas recevoir de messages de votre numéro API WhatsApp Cloud, assurez-vous qu'ils ont accepté les derniers termes de WhatsApp et la politique de confidentialité.

Quelles sont les conditions requises 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 l'API WhatsApp Cloud peut't être utilisé dans l'application WhatsApp personnelle ou professionnelle. Vous'devrez supprimer le compte sur l'application WhatsApp personnelle ou professionnelle avant de pouvoir utiliser ce numéro pour vous inscrire à une API WhatsApp Cloud.

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

  • Une fois que tu utilises un téléphone pour l'API WhatsApp Cloud, tu ne peux plus utiliser ce numéro sur WhatsApp Business App.

La vérification professionnelle est-elle nécessaire pour commencer à utiliser l'API Cloud ?

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

  • Répondre à un nombre illimité de conversations initiées par l'utilisateur.

  • Envoyez des conversations d'entreprise (modèles de messagerie) à 250 clients uniques pendant une période de 24 heures.

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

Les entreprises peuvent initier la Vérification de l'Entreprise uniquement quand elles sont prêtes à développer des conversations initiées par l'entreprise ou souhaitent devenir un Compte Officiel d'Entreprise.

Puis-je voir mes connaissances de conversation pour mon compte WhatsApp Business ?

Oui, vous pouvez surveiller votre messagerie et vos dépenses d'analyse en temps réel pour votre compte WhatsApp dans l'onglet Aperçu de votre gestionnaire Meta WhatsApp. En savoir plus sur ici.

Quelles sont les limites de la messagerie WhatsApp ?

Les limites de messagerie déterminent le nombre maximum de conversations entreprises que chaque numéro de téléphone peut envoyer sur une période de 24 heures ouvrables. Ces limites ne s'appliquent pas aux conversations initiées par les utilisateurs. Une conversation d'entreprise commence dès que le premier message est transmis à un client et se termine 24 heures plus tard. En savoir plus sur ici.

Comment ajouter une méthode de paiement à mon compte WhatsApp Business ?

Tu peux ajouter une méthode de paiement à ton compte WhatsApp Business dans Business Manager. Apprenez à ajouter une méthode de paiement à votre compte WhatsApp Business ici.

Pourquoi mon message n'a-t-il pas été envoyé avec une erreur "Problème de paiement d'admissibilité"?

Ceci est probablement dû au fait que vous dépassez le seuil de palier mensuel gratuit sans méthode de paiement valide. Pour résoudre ce problème, ajoutez une méthode de paiement valide.

Quel est le prix de l'API WhatsApp Cloud ?

L'API WhatsApp utilise un modèle de tarification basé sur la conversation qui charge les entreprises pour le nombre de conversations qu'ils ont. Une conversation commence lorsque le message de votre entreprise' est envoyé à un client et dure une fenêtre de service à la clientèle 24 heures sur 24,au cours de laquelle n'importe quel nombre de messages peuvent être échangés entre le client et l'entreprise. Les entreprises facturent des frais pour chaque conversation, quel que soit le nombre de messages envoyés ou reçus dans cette fenêtre de service à la clientèle.

En savoir plus sur Tarifs WhatsApp ici.

Comment puis-je 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, lisez plus de ici.

Puis-je utiliser respond.io pour envoyer une diffusion de l'API WhatsApp Cloud 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 à l'aide du 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 essayez d'envoyer une diffusion à des destinataires qui ne sont pas dans cette liste, vous recevrez ce message d'erreur :

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

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

Pourquoi est-ce que je vois des Contacts en double depuis le même canal WhatsApp ?

WhatsApp passe 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 fait dupliquer les Contacts de certains pays. Si cela se produit, fais appel à nous ici.

Comment puis-je changer le nom d'affichage de mon API Cloud ?

Pour changer le nom d'affichage de votre API Cloud, suivez ces étapes :

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

  2. Survolez l'icône crayon à côté du nom d'affichage pour activer l'édition.

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

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

Quelles étapes devrais-je prendre 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, complétez les étapes suivantes :

  1. Ré-enregistrez votre numéro de téléphone en utilisant le nom affiché nouvellement approuvé.

  2. Exécutez un appel d'API POST à vérifiez votre numéro de téléphone.

  3. Faites un autre appel à l'API POST pour réinscrire le numéro de téléphone vérifié.

  4. Une fois que vous avez réussi, la mise à jour du nom affiché de votre API Cloud's est terminée.

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

Cette erreur se produira si vous avez récemment mis à jour vos identifiants Facebook, cela peut perturber la connexion à la Chaîne sur notre plateforme, entraînant des erreurs lors de l'envoi de messages.

Pour résoudre ce problème, vous devez actualiser les autorisations de la chaîne sur notre plateforme en utilisant vos identifiants Facebook mis à jour. Ce processus nécessite un rôle d'administration. En actualisant les autorisations, vous'rétablirez la connexion avec les nouveaux identifiants, en vous assurant que vos messages sortants sont envoyés avec succès sans rencontrer d'erreurs.

Partager cet article
Telegram
Facebook
Linkedin
Twitter

Articles connexes 👩‍💻

Démarrage rapide de WhatsApp Business Platform (API)
Obtenez un compte WhatsApp Business API rapidement pour commencer à discuter avec vos clients.
Coexistence WhatsApp
Découvrez comment connecter l'application WhatsApp Business à respond.io pour une messagerie et une automatisation transparentes.
Se préparer pour les conversations entrantes
Apprenez à propos des fenêtres de conversation, à envoyer des modèles de messages et à configurer un point d'entrée simple pour gérer les messages WhatsApp de vos clients.
Préparez-vous pour la messagerie promotionnelle
Apprenez à diffuser des messages promotionnels en utilisant les modèles de messages WhatsApp.
Compte professionnel officiel WhatsApp (Ticket Bleu)
Apprenez à obtenir un compte WhatsApp officiel de l'entreprise.

Vous ne trouvez pas ce que vous recherchez? 🔎