Ce document est un journal des modifications apportées à la plateforme WhatsApp Business.
API Cloud
API Business Management
API Cloud
API Cloud
API Cloud, API On-Premises
API Cloud
biz_opaque_callback_data
de 256 à 512.API Business Management
cta_url_link_tracking_opted_out
au nœud des modèles de messages WhatsApp pour activer/désactiver le suivi des clics sur un bouton.UTILITY
.API Business Management
API Cloud
health_status
à différents nœuds pour vérifier l’état de la messagerie.biz_opaque_callback_data
aux messages libres pour pouvoir inclure des chaînes arbitraires dans les webhooks de messages.API Business Management
API Business Management, API Cloud, API On-Premises
Flows
API Cloud
data_localization_region
pour le point de terminaison Numéro de téléphone WhatsApp Business > Enregistrement en vue d’activer le stockage local.API Business Management, API Cloud, API On-Premises
code_expiration_minutes
(plutôt qu’à la valeur par défaut de 10 minutes) pour déterminer si le message basé sur un modèle envoyé doit comprendre un bouton de saisie automatique ou de copie de code.code_expiration_minutes
écoulé, le cas échéant (ou après 10 minutes, à défaut).API Cloud
limited_time_offer
.API Cloud
ctwa_clid
pour l’objet referral
dans les webhooks de messages. Indique l’identifiant de clic généré quand l’utilisateur·ice interagit avec une publicité qui clique vers WhatsApp pour envoyer le message.API Cloud, API On-Premises
API Business Management
add_security_recommendation
et code_expiration_minutes
dans la valeur component
.200
si l’utilisateur·ice identifié·e par le token n’a pas reçu l’autorisation d’accès au compte WhatsApp Business appropriée.API Cloud
API Cloud, API On-Premises
API Cloud, API On-Premises
Outils
API Business Management
Inscription intégrée
API Business Management
VERIFIED
de 28 jours (contre 14 auparavant).API Cloud
API Business Management
Outils
API Business Management
2494100
pour l’API Business Management, qui indique qu’un numéro de téléphone professionnel est temporairement en mode de maintenance.API Cloud
Outils
API Cloud
132015
est renvoyé à la place du code 132001
.132016
est renvoyé à la place du code 132001
.API On-Premises
2061
est renvoyé.2062
est renvoyé.API Business Management
API Cloud
API On-Premises
API Business Management
account_alerts
.AUTHENTICATION
, MARKETING
ou UTILITY
.API Business Management
hsm_id
au point de terminaison DELETE sous Compte WhatsApp Business > Modèles de message. Quand ce champ est utilisé, le modèle correspondant à l’ID fourni est supprimé (et non tous les modèles correspondant au nom fourni).API Cloud
last_onboarded_time
au nœud Numéro de téléphone WhatsApp Business. Indique quand les utilisateur·ices ont créé un numéro de téléphone professionnel dans leur compte WhatsApp Business en utilisant le processus d’inscription intégrée.API Cloud
Inscription intégrée
API Business Management, API Cloud, API On-Premises
allow_category_change
au point de terminaison POST sous Compte WhatsApp Business > Modèles de message.INCORRECT_CATEGORY
pour le paramètre reason
des webhooks de statut des modèles.previous_category
aux modèles de message WhatsApp.API Business Management
template_category_update
. En vous abonnant à ce champ, vous recevrez un webhook indiquant l’ancienne et la nouvelle catégorie du modèle chaque fois qu’un changement de catégorie se produit.API Cloud
API On-Premises
API Cloud, API On-Premises
API Business Management
API Cloud, API On-Premises
API Business Management, API Cloud
API Cloud
AUTHENTICATION
MARKETING
UTILITY
code
et details
."code":100
) comptait plusieurs titres uniques qui indiquaient la nature d’une erreur 100. Toutes les erreurs 100 auront désormais pour titre Invalid parameter
. Les anciens titres qui décrivaient la nature d’une erreur 100 donnée ont été déplacés vers la propriété details
. Cette modification se reflète également dans les charges utiles des webhooks qui décrivent une réponse aux erreurs 100.Webhooks de l’API Cloud
errors
dans les webhooks déclenchés par les erreurs de requête (version 16.0 et ultérieures) inclut à présent les propriétés message
et error_data.details
. De plus, les valeurs title
ont été modifiées pour plusieurs codes d’erreur. Désormais, les objets errors
utilisent la structure et les données suivantes :[ { "code": <CODE>, "title" : "<TITLE>", "message": "<MESSAGE>", "error_data": { "details": "<DETAILS>" } }, ... ]
title
a été mise à jour pour les codes d’erreur ci-après. Leurs anciennes valeurs apparaissent maintenant dans error_data.details
.
130470
a maintenant pour titre Re-engagement message
130429
a maintenant pour titre Rate limit hit
131045
a maintenant pour titre Incorrect certificate
131031
a maintenant pour titre Business Account locked
131053
a maintenant pour titre Media upload error
131027
a maintenant pour titre Something went wrong
131042
a maintenant pour titre Business eligibility payment issue
131026
a maintenant pour titre Message Undeliverable
131000
a maintenant pour titre Something went wrong
message
est identique à celle de la propriété title
, ce qu’indique le titre du code d’erreur. Cette propriété correspond à la propriété message
dans les charges utiles de la réponse d’erreur de l’API.error_data.details
intègre à présent les titres des codes d’erreur d’après les codes d’erreur mentionnés ci-dessus et décrit l’origine sous-jacente de l’erreur. Cette valeur correspond à la propriété details
dans les charges utiles de la réponse d’erreur de l’API.Ces changements apparaissent dans les propriétés errors
suivantes, dans les webhooks liés à l’erreur :
entry.changes.value.errors
entry.changes.value.messages.errors
entry.changes.value.statuses.errors
API Cloud
Les entreprises non vérifiées peuvent maintenant lancer jusqu’à 250 conversations sur une période continue de 24 heures.
S’applique à toutes les versions de l’API Cloud.
Ajout d’un nouveau champ phone_number_id
facultatif au point de terminaison Media. Si vous incluez ce paramètre et un ID de numéro de téléphone professionnel, l’opération sera traitée uniquement si l’ID du numéro de téléphone correspond à l’ID du numéro de téléphone sur lequel le contenu multimédia a été importé.
La fonction de mise en cache de contenu multimédia HTTP de l’API Cloud quitte la version bêta et est maintenant accessible à tous·tes.
Désormais, l’API Cloud tentera pendant jusqu’à 7 jours (contre 30 jours auparavant) de distribuer à nouveau les notifications Webhooks dont la distribution a échoué. Voir Échec de distribution des notifications Webhooks.
S’applique à toutes les versions.
template_performance_metrics
. Vous notifie une fois par semaine tous les indicateurs de performance des modèles, y compris le nombre de messages envoyés, le nombre de messages ouverts et les principaux motifs de blocage.S’applique à toutes les versions.
Nouveau champ account_alerts
:
account_alerts
. Vous recevez une notification en cas d’alerte liée à l’entreprise, au compte WhatsApp Business ou au numéro de téléphone de l’entreprise.Nouvelles valeurs pour le champ account_update
:
account_update.events
: ACCOUNT_DELETED
. Indique qu’un numéro de téléphone a été désinscrit ou supprimé d’un compte WhatsApp Business.message_template_status_update.events
: PENDING_DELETION
. Indique qu’un modèle de message a été marqué pour suppression.Exemples de notification Webhooks envoyée lorsque ces nouveaux évènements sont déclenchés :
ACCOUNT_DELETED
: compte WhatsApp Business suppriméPENDING_DELETION
: modèle de message en attente de suppressionAjout des champs du nœud Compte WhatsApp Business suivants :
country
(concerne les versions v15.0+
)ownership_type
(concerne les versions v15.0+
)business_verification_status
(concerne toutes les versions)S’applique à la version 15.0 et aux versions ultérieures.
Ajout des options de filtre suivantes au point de terminaison Business Client WhatsApp Business Accounts :
creation_time
du compte WhatsApp Business à l’aide des opérateurs GREATER_THAN
, LESS_THAN
ou IN_RANGE
.ownership_type
du compte WhatsApp Business à l’aide des opérateurs EQUAL
ou IN
.Ajout des options de filtre suivantes au point de terminaison Business Owned WhatsApp Business Accounts :
creation_time
du compte WhatsApp Business à l’aide des opérateurs GREATER_THAN
, LESS_THAN
ou IN_RANGE
.ownership_type
du compte WhatsApp Business à l’aide des opérateurs EQUAL
ou IN
.country
du compte WhatsApp Business à l’aide des opérateurs EQUAL
ou IN
.Concerne la version 15.0 et les versions ultérieures
Nous avons ajouté les champs du nœud Numéro de téléphone WhatsApp Business suivants :
is_official_business_account
messaging_limit_tier
De plus, vous pouvez filtrer le point de terminaison Numéros de téléphone de compte WhatsApp Business par is_official_business_account
.
L’API Cloud prend désormais en charge jusqu’à 500 messages par seconde (à la fois des textos et des MMS), par requête (contre 350 auparavant). Pour plus d’informations, consultez Débit.
La limite de 350 messages par seconde passe automatiquement à 500. Si vous aviez déjà demandé à passer à 350 messages par seconde, mais que le processus n’était pas finalisé, vous bénéficierez de la nouvelle limite une fois le processus terminé.
Nous testons une version bêta de la mise en cache HTTP de contenus multimédias de l’API Cloud. Si vous êtes un fournisseur de solutions d’entreprise, consultez la rubrique relative à la mise en cache HTTP des contenus multimédias pour savoir comment utiliser les en-têtes dans les réponses du serveur afin que nous mettions en cache vos ressources multimédias en vue de les réutiliser dans de futurs messages.
L’API Cloud prend désormais en charge les légendes sur les documents que vous recevez de votre clientèle ou que vous lui envoyez. Voir Objets multimédias dans la référence Média.
Les comptes WhatsApp Business peuvent désormais compter jusqu’à 6 000 modèles de messages si leur entreprise mère a été vérifiée et qu’au moins un des comptes WhatsApp Business de l’entreprise mère a un numéro de téléphone professionnel avec un nom à l’écran approuvé.
Dans le cadre de ce changement, les versions traduites d’un modèle de message sont désormais comptabilisées dans la limite de modèle d’un compte WhatsApp Business.
Les entreprises en Inde peuvent à présent utiliser une carte de crédit pour payer les messages envoyés à l’aide de la plateforme. Consultez Ajouter une carte de crédit à votre compte WhatsApp Business.
Il est désormais possible de migrer un numéro de téléphone professionnel vers et depuis des comptes WhatsApp Business de l’API Cloud. Voir Migration d’un numéro de téléphone vers un autre compte WhatsApp Business.
API Cloud uniquement.
Vous pouvez désormais utiliser différentes URL de rappel pour chacun de vos comptes WhatsApp Business sans avoir à créer une application unique pour ces comptes. Pour plus d’informations, consultez Remplacement de l’URL de rappel.
Tous les points de terminaison de l’API Cloud prennent désormais en charge les appels de la version 15.
API Cloud uniquement.
Les paramètres texte (components.parameters.text
) des modèles de messages qui n’utilisent qu’un composant de type corps (components.type:body
) peuvent désormais comporter jusqu’à 32 768 caractères. Voir Objet Paramètres.
API Cloud uniquement.
L’API Cloud prend désormais en charge jusqu’à 350 messages par seconde (à la fois des textos et des MMS), par requête (contre 250 auparavant). Pour plus d’informations, consultez Débit.
La limite de 250 messages par seconde passe automatiquement à 350. Si vous aviez déjà demandé à passer à 250 messages par seconde, mais que le processus n’était pas finalisé, vous bénéficierez de la nouvelle limite une fois le processus terminé.
Les réactions sont désormais prises en charge. Consultez Envoyer des messages - Messages de réaction pour savoir comment envoyer et recevoir des réactions, et Exemples de charges utiles - Messages de réaction pour obtenir des exemples de notification de charge utile webhook.
Le champ about
est désormais pris en charge pour les profils professionnels. Pour plus d’informations, consultez Profils professionnels.
La documentation la plus récente sur la demande de migration de 80 à 250 messages par seconde envoyés et reçus (à la fois des textos et des MMS) est désormais disponible. Consultez la page Débit.
Vous pouvez désormais inclure des stickers animés dans les messages sortants envoyés par l’entreprise et recevoir des webhooks de message décrivant ces messages de la même manière que pour l’envoi de stickers non animés. Pour les exigences en matière d’éléments de sticker animé, reportez-vous à la propriété sticker
de l’objet Message.
Vous pouvez désormais inclure des produits et services dans les messages envoyés aux client·es qui peuvent alors les ajouter aux paniers sans avoir à quitter le fil de discussion. Consultez le guide de vente des produits et services pour découvrir comment envoyer des messages présentant un produit unique ou une sélection de produits aux client·es.
Les entreprises peuvent désormais répondre à un message dans un fil de discussion. Les réponses incluront une bulle contextuelle faisant référence au message objet de la réponse. Consultez le guide Envoyer des messages pour découvrir comment répondre à un message.
L’API Cloud prend désormais en charge jusqu’à 250 messages par seconde envoyés et reçus (à la fois des textos et des MMS), par requête. Si vous êtes un·e partenaire entreprise, vous pouvez ouvrir un ticket auprès de l’assistance directe pour demander un débit de 250 messages par seconde en sélectionnant le sujet de question « Cloud API Issues » et le type de demande « Request to migrate to 250 MPS throughput » et en renseignant les informations requises.
v2.43
: 11 octobre 2022v2.43
, des changements seront apportés au comportement du point de terminaison contacts
.
status
. Qu’une personne utilise ou non WhatsApp, le système renverra toujours valid
pour status
dans la réponse et un identifiant wa_id
. Il n’y a aucune garantie que la valeur wa_id renvoyée soit valide. Ces changements sont applicables à la fois pour les réponses directes et pour les réponses de webhook liées aux appels non bloquants. status
et wa_id
renvoyées dans le nœud contacts
. De plus, l’envoi d’un message sur la version v2.39.1
ou supérieure est possible sans devoir appeler le nœud contacts
. Assurez-vous que votre code soit capable de gérer une potentielle erreur 1013
L’utilisateur·ice n’est pas valide lorsque vous tentez d’envoyer un message de modèle, qui sera renvoyé si vous tentez d’envoyer le message de modèle à un numéro de téléphone sans compte WhatsApp
Concernant les messages qui ne sont pas des modèles, l’envoi d’un message à un numéro de téléphone qui n’est pas associé à un compte WhatsApp renverra une erreur 470
.
v2.45
: 10 janvier 2023À compter de la v2.45
, le paramètre cert
facultatif dans le nœud shards
deviendra obligatoire pour toutes les demandes. Veillez à mettre à jour votre intégration pour toujours inclure un paramètre cert
valide lorsque vous appelez le nœud shards
.
À compter de la v2.41.2
, les entreprises pourront utiliser le nœud application
pour filtrer les statuts des messages envoyés qui ne les intéressent pas via l’objet message
contenu dans l’objet webhook
. Dans la v2.45
, le paramètre sent_status
ne sera plus pris en charge. Par conséquent, veillez à mettre à jour votre intégration pour utiliser l’objet webhook
contenu dans le nœud application
pour tous les contrôles de webhook.
À compter de la v2.39.1
, le paramètre recipient_id
sera disponible dans l’objet statuses
et dans l’objet message
. Dans la v2.45
, le paramètre recipient_id
sera retiré de l’objet statuses
. Par conséquent, veillez à mettre à jour votre intégration pour utiliser le paramètre recipient_id
sous l’objet message
.
v2.41.3
)2.41.3
La v2.41.3
du client de notre API Business inclut l’ajout d’un nouvel index de table sur message_receipt_log
afin d’aider les partenaires ayant besoin de haut débit. Par exemple, cela permettra aux partenaires d’envoyer plus de 200 messages/seconde.
v2.41.2
)Avec la version 2.41.2, nous introduisons des modifications aux schémas de base de données pour améliorer les performances du système. Par conséquent, les mises à niveau à partir des versions 2.37.2 et 2.39.x pour les configurations avec de grandes bases de données contenant des millions d’entrées de message et de contact prendront plus de temps que d’habitude.
En règle générale, effectuez les mises à jour pendant les heures creuses et commencez par les configurations à débit plus faible.
Pour les grandes bases de données, procédez comme suit :
Exécutez la collecte de déchets via le point de terminaison /services/message/gc avant la mise à niveau et vérifiez qu’elle réussit.
Veuillez utiliser l’outil dbupgrade pour mettre à niveau les schémas de base de données avant la mise à niveau de la version. Une fois terminé, vous pourrez mettre à niveau les versions d’API avec un temps d’arrêt minimal. Il est vivement recommandé d’arrêter le client de l’API avant d’utiliser l’outil dbupgrade. Vérifiez que l’outil dbupgrade a bien été exécuté (code de sortie 0), et évitez ou limitez les demandes d’API pendant la mise à niveau.
Nous recommandons d’augmenter d’une heure le délai d’interrogation sur vos serveurs de base de données jusqu’à l’exécution complète de la mise à niveau.
Cette version client contient les fonctionnalités et mises à jour suivantes :
delivered
et read
, ce qui leur permet de mieux contrôler les notifications de webhooks pour les messages. Pour ce faire, il est possible d’utiliser le point de terminaison settings/applications.namespace
est facultatif pour l’objet modèleÀ compter d’aujourd’hui, l’API WhatsApp Business Cloud est disponible pour les développeur·ses qui conçoivent des produits ou services pour leur compte ou pour leurs entreprises. Pour commencer, consultez notre guide. Si vous êtes intéressé·e par l’offre d’accès par API à vos clients et clientes, veuillez vous inscrire sur notre liste d’attente.
Les valeurs suivantes pour le paramètre category
du point de terminaison /WHATSAPP-BUSINESS-ACCOUNT-ID/message_template
ne sont plus prises en charge dans la v14.0
et versions ultérieures :
|
|
|
Les valeurs suivantes ont été ajoutées :
TRANSACTIONAL
MARKETING
La version de ce client contient l’ensemble des fonctionnalités et corrections apportées à la v2.39.1
. De plus :
v2.39.2
.v2.39.3
.v2.39.4
, les entreprises seront informées de la réception d’un message éphémère par une notification webhooks dont le type sera défini sur "ephemeral"
. Les entreprises ne pourront pas voir le contenu de ce message.Au moment où nous avons lancé la v2.39.3
, ce dysfonctionnement affectant les messages éphémères était géré par WhatsApp qui désactivait automatiquement ces messages dans le fil de discussion. Nous ne procéderons pas ainsi dans la v2.39.4
. Dans cette version, les entreprises qui reçoivent des messages éphémères doivent demander au client ou à la cliente de désactiver ce type de message, puis de renvoyer le dernier message.
2.3.8
À compter d’aujourd’hui, l’API Cloud inclut les mises à niveau suivantes :
2.3.7
À compter d’aujourd’hui, l’API Cloud est disponible pour tous les fournisseurs de solutions d’entreprise (BSP) et client·es direct·es existants. De plus, nous lançons les fonctionnalités suivantes pour les équipes de développement de l’API Cloud :
POST
à PHONE_NUMBER_ID/deregister
pour supprimer un numéro de téléphone de l’API WhatsApp Business. Pour plus d’informations, consultez la page Inscription.referral
Webhooks de l’API Cloud est différent de l’objet referral
de l’API On-Premises.De plus, Contrôle app n’est plus requis pour les équipes de développement internes utilisant l’API Cloud. Toutes les équipes de développement sont soumises aux limites de messages de la plateforme WhatsApp Business.
Cette version offre les mêmes fonctionnalités que la v2.37.1
, mais la date d’expiration est différente. La v2.37.2
expire le 22 septembre 2022.
Le conteneur Webapp des développeurs et développeuses Kubernetes peut afficher l’erreur CrashLoopBackOff
et refuser de démarrer. Pour résoudre ce problème, ajoutez la ligne suivante dans le fichier YML
de déploiement de Kubernetes dans la configuration Webapp :
command: ["/opt/whatsapp/bin/wait_on_mysql.sh", "/opt/whatsapp/bin/launch_within_docker.sh"]
La v2.39.3
du client de notre API Business est disponible aujourd’hui auprès des équipes de développement. Ce nouveau client intègre deux corrections et des journaux supplémentaires pour le débogage. Ces deux corrections sont les suivantes :
À compter d’aujourd’hui, les utilisateur·ices de la version bêta de l’API Cloud peuvent commencer à envoyer des messages de listes et Répondre. Pour plus d’informations, consultez la documentation suivante :
À compter d’aujourd’hui, les utilisateur·ices de la version bêta de l’API Cloud peuvent ajouter une zone d’URL d’aperçu dans les textos qui incluent une URL. Pour plus d’informations, consultez la documentation suivante :
Nous venons de sortir l’API On-Premises v2.39.2
. Cette version résout un bug qui empêchait l’envoi de messages vidéo dans certaines circonstances.
À compter d’aujourd’hui, les utilisateur·ices de la version bêta de l’API Cloud peuvent commencer à envoyer et recevoir des messages vidéo. La documentation suivante fournit des informations supplémentaires :
À compter d’aujourd’hui, le modèle de tarification WhatsApp, anciennement basé sur les notifications, est basé sur les conversations. Les entreprises sont facturées en fonction du nombre de conversations, qui correspondent à tous les messages envoyés au cours d’une période de 24 heures. Pour en savoir plus, consultez la page Tarifs basés sur les conversations.
À compter d’aujourd’hui, les utilisateur·ices de la version bêta de l’API Cloud peuvent commencer à envoyer et recevoir des messages de localisation et de contact. Pour en savoir plus, consultez la documentation ci-dessous :
Nous prenons désormais en charge un débit de pointe de 80 messages par seconde, par numéro de téléphone. Cela inclut les messages entrants et sortants, ainsi que les textos, les messages modèles et les MMS.
2.39.1
)La version 2.39.1
du client de notre API Business est disponible aujourd’hui auprès des équipes de développement. Ce nouveau client inclut :
Depuis la nouvelle version du client de l’API, il peut vous être demandé de fournir le certificat de votre téléphone au moment de configurer Multiconnect. Cela signifie que lorsque vous appelez le point de terminaison /v1/account/shards, vous pouvez ajouter le certificat encodé au format Base64 dans le champ du certificat. Pour plus d’informations, consultez la section Faire évoluer votre client d’API avec Multiconnect.
Nous avons ajouté graph.whatsapp.com
à la liste des noms d’hôte de serveur WhatsApp auxquels le client de l’API Business doit se connecter. Pour plus d’informations, consultez la section Configurer et déboguer votre réseau, Noms d’hôtes.
Avec la v2.39
, nous avons ajouté le code d’erreur 1031
. Vous recevrez ce message d’erreur si votre compte a été verrouillé et ne permet pas l’envoi de messages en raison d’une infraction aux règles d’intégrité. Pour plus d’informations, consultez la section Messages d’erreur et d’état et Mise en application de la politique.
hsm
a été abandonné avec la v2.39
. Vous devrez utiliser le type template
à la place.webhook_payload_conversation_pricingmodel_disabled
a été abandonné.Dans certaines circonstances, certains messages vidéo ne sont pas envoyés.