L’API On-Premises ne sera bientôt plus disponible. Consultez notre document Abandon progressif de l’API On-Premises pour de plus amples détails, mais aussi pour connaître la procédure de migration vers notre API Cloud nouvelle génération.

Partager des produits avec la clientèle

Les entreprises peuvent partager des produits avec leur clientèle de différentes façons :

Messages de catalogue : messages de format libre contenant un bouton qui affiche votre catalogue produits dans WhatsApp.
Messages de catalogue basés sur un modèle : messages basés sur un modèle contenant un bouton qui affiche votre catalogue produits dans WhatsApp.
Messages de catalogue avec lien : messages contenant des miniatures du catalogue et un lien vers votre catalogue produits complet.
Messages produits : messages contenant des informations sur un seul produit ou sur 30 produits maximum de votre catalogue produits.
Messages multiproduits basés sur un modèle : messages basés sur un modèle qui regroupent dans un seul message des informations sur jusqu’à 30 produits de votre catalogue e-commerce, répartis dans 10 sections maximum.

Messages de catalogue

Les messages de catalogue sont des messages de format libre qui vous permettent de présenter votre catalogue produits dans son intégralité sur WhatsApp.

Ils contiennent une miniature de produit de votre choix comme image d’en-tête, un corps de texte personnalisé, un texte de titre et de sous-titre fixe, et un bouton Voir le catalogue.

Lorsqu’un·e client·e appuie sur le bouton Voir le catalogue, votre catalogue produits apparaît dans WhatsApp.

Conditions requises

Vous devez avoir importé un inventaire dans Meta dans un catalogue e-commerce connecté à votre compte WhatsApp Business.

Syntaxe de la requête

Pour envoyer un message de catalogue, utilisez le point de terminaison Numéro de téléphone WhatsApp Business > Messages :

POST /<WHATSAPP_BUSINESS_PHONE_NUMBER_ID>/messages

Corps de la requête POST

{
  "messaging_product": "whatsapp",
  "recipient_type": "individual",
  "to": "<TO>",
  "type": "interactive",
  "interactive" : {
    "type" : "catalog_message",
    "body" : {
      "text": "<BODY_TEXT>"
    },
    "action": {
      "name": "catalog_message",
      "parameters": {
        "thumbnail_product_retailer_id": "<THUMBNAIL_PRODUCT_RETAILER_ID>"
      }
    },

    /* Footer object is optional */
    "footer": {
      "text": "<FOOTER_TEXT>"
  }
}

Propriétés

Espace réservé	Description	Exemple de valeur
`<BODY_TEXT>` Chaîne	Obligatoire. Texte qui apparaît dans le corps du message. 1 024 caractères maximum.	`Hello! Thanks for your interest. Ordering is easy. Just visit our catalog and add items to purchase.`
`<FOOTER_TEXT>` Chaîne	Facultatif. Texte apparaissant dans le pied de page du message. 60 caractères maximum.	`Best grocery deals on WhatsApp!`
`<THUMBNAIL_PRODUCT_RETAILER_ID>` Chaîne	Obligatoire. SKU de l’article. Appelé ID de contenu dans le Gestionnaire des ventes. La miniature de cet article sera utilisée comme image d’en-tête du message. En l’absence de l’objet `parameters`, c’est l’image du premier article de votre catalogue qui s’affiche.	`2lc20305pt`
`<TO>` Chaîne	Numéro de téléphone du client ou de la cliente.	`16505551234`

Exemple de requête

{
  "messaging_product": "whatsapp",
  "recipient_type": "individual",
  "to": "16505551234",
  "type": "interactive",
  "interactive": {
    "type": "catalog_message",
    "body": {
      "text": "Hello! Thanks for your interest. Ordering is easy. Just visit our catalog and add items to purchase."
    },
    "action": {
      "name": "catalog_message",
      "parameters": {
        "thumbnail_product_retailer_id": "2lc20305pt"
      }
    },
    "footer": {
      "text": "Best grocery deals on WhatsApp!"
    }
  }
}'

Exemple de réponse

{
  "messaging_product": "whatsapp",
  "contacts": [
    {
      "input": "16505551234",
      "wa_id": "16505551234"
    }
  ],
  "messages": [
    {
      "id": "wamid.HBgLMTY1MDM4Nzk0MzkVAgARGBI0ODVEREUwQzEzQkVBRjQ1RUUA"
    }
  ]
}

Messages de catalogue basés sur un modèle

Les messages de catalogue basés sur un modèle contiennent un bouton qui affiche votre catalogue produits dans WhatsApp.

Pour envoyer un message de catalogue basé sur un modèle, vous aurez besoin d’un modèle de catalogue. Consultez notre document Modèles de catalogue pour apprendre à créer ces modèles et à les envoyer dans un message basé sur un modèle.

Messages avec lien vers le catalogue

Les entreprises peuvent envoyer un lien vers l’ensemble de leur catalogue produits en créant un lien wa.me et en l’insérant dans un message texte type. Dans ce cas, elles peuvent définir le paramètre preview_url en option sur true pour que le message renvoie un ensemble de miniatures du catalogue produits de chaque URL dans la chaîne body du message.

Notez que si les entreprises désactivent le catalogue, les liens wa.me et le bouton Afficher le catalogue dans les messages avec lien vers le catalogue afficheront un lien de catalogue non valide au moment où quelqu’un appuiera dessus.

Pour créer un lien wa.me, il est nécessaire d’ajouter le numéro de téléphone professionnel de l’entreprise avec l’indicatif pays à la fin de la chaîne suivante :

https://wa.me/c/

Par exemple :

https://wa.me/c/15555455657

Messages sur les produits

Les messages concernant un ou plusieurs produits sont des types de messages interactive.

Exemple de message concernant plusieurs produits :	Exemple de message concernant un seul produit :

Menu s’affichant lorsque quelqu’un clique sur Commencer vos achats :	Exemple de page de détails du produit :

Présentation

Une personne qui reçoit des messages portant sur un ou plusieurs produits peut principalement exécuter trois actions :

Afficher les produits : le client ou la cliente peut afficher une liste des produits ou un produit seulement. À chaque fois qu’un contact clique sur un article spécifique, nous récupérons les informations les plus récentes sur le produit et affichons ce dernier au format PDP (page de détails du produit). Actuellement, les pages au format PDP prennent uniquement en charge les images de produits. Elles n’acceptent pas les vidéos et/ou les fichiers GIF ajoutés au produit.
Ajouter des produits au panier : une personne peut ajouter un produit à son panier, ou modifier les quantités directement à partir de la liste ou dans la page de détails du produit. À chaque fois qu’un contact ajoute un produit au panier, nous récupérons les informations les plus récentes sur l’article. Si l’un des articles change d’état, nous affichons une boîte de dialogue mentionnant qu’un ou plusieurs articles du panier ont été mis à jour. Pour plus d’informations, consultez Mises à jour concernant les produits. Un panier reste dans le fil de discussion entre l’entreprise et le client ou la cliente jusqu’à ce qu’il soit envoyé à l’entreprise. Pour en savoir plus, consultez l’Expérience du panier d’achat.
Envoyer le panier à l’entreprise : après avoir ajouté tous les articles nécessaires, les contacts peuvent envoyer leur panier à l’entreprise avec laquelle ils sont en contact. Après cela, les entreprises peuvent définir les étapes suivantes, par exemple demander des informations de livraison ou proposer des options de paiement.

Quand un·e client·e possède plusieurs appareils liés au même compte WhatsApp, les messages concernant un ou plusieurs produits sont synchronisés sur ces appareils. Cependant, le panier reste enregistré en local, sur un appareil en particulier. Pour en savoir plus, consultez l’Expérience du panier d’achat.

Actuellement, il est possible de recevoir ces types de messages sur les plateformes suivantes :

iOS : 2.21.100 (messages concernant plusieurs produits) et 2.21.210 (messages concernant un seul produit).
Android : 2.21.9.15 (messages concernant plusieurs produits) et 2.21.19 (messages concernant un seul produit).
Web : il existe maintenant un client Web qui prend en charge ces fonctionnalités.

Si la version de l’application utilisée par le ou la destinataire ne prend pas en charge les messages concernant un ou plusieurs produits, nous l’informerons que la réception du message est impossible, car il ou elle utilise une version obsolète de WhatsApp. L’entreprise recevra également une notification webhook indiquant que le message n’a pas pu être distribué, car le ou la destinataire utilise une version obsolète de WhatsApp.

Comportement attendu des messages

Les messages concernant un ou plusieurs produits peuvent être :

transmis d’une personne à une autre,
rouverts par une personne dans le même fil de discussion.

Les messages de catalogue, multiproduit ou concernant un seul produits ne peuvent pas être :

envoyés sous forme de notification. Ils peuvent uniquement être envoyés dans le cadre d’un fil de discussion existant.

Mises à jour concernant les produits

Les entreprises ont parfois besoin de mettre à jour les propriétés des articles dans leur catalogue. Selon la propriété mise à jour, voici comment nous gérons tous les messages mentionnant ce produit :

Propriété mise à jour	Traitement mis à jour
Prix, titre, description et image du produit.	Une entreprise envoie un message concernant un ou plusieurs produits qui mentionne le produit A. L’entreprise met à jour les propriétés du produit A dans son catalogue. Les écrans qui affichent ce produit sont mis à jour dès que le client ou la cliente reçoit le changement du serveur.
Changement de disponibilité	Une entreprise envoie à un·e client·e un message concernant un ou plusieurs produits qui mentionne le produit B. L’entreprise vend toutes les unités du produit B disponibles. Elle met ensuite à jour son catalogue en mentionnant que le produit B n’est plus disponible. Si un·e client·e a déjà ajouté le produit B à son panier, l’article en sera retiré. Le panier affiche une boîte de dialogue mentionnant qu’un article ou plusieurs articles du panier ont été mis à jour. Si le client ou la cliente n’a pas ajouté le produit B dans son panier, le message concernant un ou plusieurs produits stipule maintenant que l’article est indisponible.

Propriété mise à jour

Traitement mis à jour

Prix, titre, description et image du produit.

Une entreprise envoie un message concernant un ou plusieurs produits qui mentionne le produit A.
L’entreprise met à jour les propriétés du produit A dans son catalogue.
Les écrans qui affichent ce produit sont mis à jour dès que le client ou la cliente reçoit le changement du serveur.

Changement de disponibilité

Une entreprise envoie à un·e client·e un message concernant un ou plusieurs produits qui mentionne le produit B.
L’entreprise vend toutes les unités du produit B disponibles. Elle met ensuite à jour son catalogue en mentionnant que le produit B n’est plus disponible.
Si un·e client·e a déjà ajouté le produit B à son panier, l’article en sera retiré. Le panier affiche une boîte de dialogue mentionnant qu’un article ou plusieurs articles du panier ont été mis à jour.
Si le client ou la cliente n’a pas ajouté le produit B dans son panier, le message concernant un ou plusieurs produits stipule maintenant que l’article est indisponible.

Expérience du panier d’achat

Après avoir visualisé les produits, un contact peut les ajouter à son panier et envoyer ce panier à une entreprise. D’un point de vue strictement commercial sur WhatsApp :

Un panier correspond uniquement à un fil de discussion entre la personne et l’entreprise sur un appareil spécifique : un seul panier est créé par fil de discussion entre la personne et l’entreprise, et les paniers ne sont visibles que sur un seul appareil. Dès qu’un panier est envoyé, le client ou la cliente peut ouvrir un autre panier et recommencer le processus.
Un panier n’a pas de date d’expiration : le panier reste dans le fil de discussion jusqu’à ce qu’il soit envoyé à l’entreprise. Une fois envoyé, il est effacé.

Si votre clientèle peut ajouter au panier jusqu’à 99 unités de chaque article du catalogue, il n’existe pas de limite quant au nombre d’articles qui peuvent être ajoutés au panier.

Dès que le panier est envoyé, aucune modification ne peut être apportée. Votre clientèle peut envoyer un nouveau panier si elle estime nécessaire d’ajouter de nouveaux articles ou de modifier la commande. Les entreprises ne peuvent pas envoyer de panier à la clientèle.

Exemple d’expérience de panier d’achat et comportement attendu concernant le changement d’état d’un article.

Pourquoi utiliser cette fonctionnalité ?

Les messages concernant un ou plusieurs produits se prêtent mieux à des expériences d’utilisation simples et personnalisées dans lesquelles il est préférable de guider le client ou la cliente vers un sous-ensemble d’articles susceptibles de lui convenir plutôt que de parcourir un inventaire complet.

Un dispositif simple et efficace

Associez ces fonctionnalités à des outils de navigation tels que le traitement du langage naturel, la recherche de texte ou encore les messages de liste et les boutons de réponse, afin d’obtenir rapidement ce que la personne recherche.

Un service personnalisé

Misez sur un remplissage dynamique pour personnaliser la solution selon la personne ou la situation. Par exemple, vous pouvez afficher un message concernant plusieurs produits, plus précisément les articles le plus souvent commandés par la personne.

Des résultats pour l’entreprise

Vous bénéficiez d’un canal performant pour multiplier les commandes. En effet, pendant les tests, les entreprises ont enregistré une conversion moyenne de 7 % des messages reçus portant sur plusieurs produits.

Aucun modèle

Les messages interactifs ne nécessitent aucun modèle ni aucune approbation préalable. Ils sont générés en temps réel et reflètent toujours les dernières informations sur les articles, les prix et les niveaux de stock de votre inventaire.

Quand utiliser cette fonctionnalité ?

Les messages concernant plusieurs produits sont idéaux lorsque vous voulez orienter votre clientèle vers une sous-partie bien précise de l’inventaire de votre entreprise :

Achats via une conversation. Par exemple, utilisez la fonctionnalité de recherche pour permettre aux client·es de saisir une liste de courses, puis renvoyez en réponse un message contenant plusieurs produits.
Navigation vers une catégorie bien précise. Par exemple, des vêtements de sport.
Offres ou recommandations personnalisées.
Commande d’articles déjà commandés. Par exemple, une personne peut effectuer à nouveau sa commande habituelle de moins de 30 articles.

Les messages concernant un seul produit sont idéaux pour guider les client·es vers un article spécifique de l’inventaire de l’entreprise. Ils offrent des réponses rapides en s’appuyant pour cela sur un ensemble limité d’options du type :

Répondre à la demande spécifique d’un·e client·e.
Fournir une recommandation.
Commander à nouveau un article.

Ces deux fonctionnalités peuvent également être utilisées par un agent humain. Cependant, vous devez créer les outils pour permettre à cet agent de générer dans un fil de discussion un message concernant un ou plusieurs produits.

Premiers pas

Avant d’envoyer chaque message, vous devez obtenir l’ID WhatsApp du destinataire avec un appel au nœud /contacts.

Nous vous recommandons de configurer des webhooks pour recevoir le statut des messages et des notifications de messages entrants. De cette façon, vous pouvez suivre si un message a été envoyé et les réponses des client·es.

Étape 1 : assembler l’objet interactive

Messages concernant sur un seul produit

Pour envoyer un message concernant un seul produit, assemblez un objet interactive de type product avec les composants suivants :

Objet Description

Objet	Description
`body`	Facultatif. Un objet body. Voir toutes les options pour l’objet `body`.
`footer`	Facultatif. Un objet footer. Voir toutes les options pour l’objet `footer`.
`action`	Obligatoire. Le champ action doit inclure : `catalog_id` : ID du catalogue que vous souhaitez utiliser pour ce message. Récupérez cet ID via le Gestionnaire des ventes. `product_retailer_id` : l’identifiant unique d’un produit. Voir toutes les options pour l’objet `action`.

body

Facultatif.

Un objet body. Voir toutes les options pour l’objet body.

footer

Facultatif.

Un objet footer. Voir toutes les options pour l’objet footer.

action

Obligatoire.

Le champ action doit inclure :

catalog_id : ID du catalogue que vous souhaitez utiliser pour ce message. Récupérez cet ID via le Gestionnaire des ventes.
product_retailer_id : l’identifiant unique d’un produit.

Voir toutes les options pour l’objet action.

Vers la fin du traitement, l’objet interactive doit ressembler à ce qui suit :

"interactive": {
    "type": "product",
    "body": {
      "text": "text-body-content"
    },
    "footer": {
      "text": "text-footer-content"
    },
    "action": {
      "catalog_id": "catalog-id",
      "product_retailer_id": "product-SKU-in-catalog"
    }
}

Messages concernant plusieurs produits

Pour envoyer un message concernant plusieurs produits, assemblez un objet interactive de type product_list avec les composants suivants :

Objet	Description
`header`	Obligatoire. Le paramètre `type` de l’en-tête doit être défini sur `text`. N’oubliez pas d’ajouter un objet `text` avec le contenu souhaité. Voir tous les champs `header` disponibles.
`body`	Obligatoire. Un objet `body`. Voir toutes les options pour l’objet `body`.
`footer`	Facultatif. Un objet `footer`. Voir toutes les options pour l’objet `footer`.
`action`	Obligatoire. Le champ action doit inclure : `catalog_id` : ID du catalogue que vous souhaitez utiliser pour ce message. Récupérez cet ID via le Gestionnaire des ventes. `sections` : tableau des objets section. Vous devez inclure une section au moins. À l’intérieur de chaque section, vous pouvez inclure ce qui suit : `title` : insérez un titre pour chaque section si vous prévoyez d’en utiliser plusieurs. `product_items` : tableau des objets product à afficher. Chaque objet product contient un `product_retailer_id` qui correspond à un identifiant unique de produit. Récupérez cet ID via le Gestionnaire des ventes. Voir toutes les options pour l’objet `action`.

Vers la fin du traitement, l’objet interactive doit ressembler à ce qui suit :

"interactive": 
    {
    "type": "product_list",
    "header":{
       "type": "text",
        "text": "text-header-content"
     },
     "body":{
        "text": "text-body-content"
      },
     "footer":{
        "text":"text-footer-content"
     },
     "action":{
        "catalog_id":"catalog-id",
        "sections": [
             {
             "title": "the-section-title",             
             "product_items": [
                  { "product_retailer_id": "product-SKU-in-catalog" },
                  { "product_retailer_id": "product-SKU-in-catalog" },
                            ...
              ]},
              {
              "title": "the-section-title",
              "product_items": [
                 { "product_retailer_id": "product-SKU-in-catalog" }
                           ...
              ]},
               ...
       ]
     },  
    }

Articles manquants

Si aucun des articles fournis dans les appels d’API ci-dessus ne correspond à un produit du catalogue Facebook de l’entreprise, un message d’erreur est généré et le message concernant un ou plusieurs produits n’est pas envoyé à l’utilisateur·ice.

Pour ce qui est des messages concernant plusieurs produits, au moins un article de la liste des produits doit correspondre à un article du catalogue Facebook de l’entreprise. Dans ce cas :

Les messages sont bien envoyés.
Les articles sans correspondance sont ignorés.
L’entreprise reçoit un message d’erreur demandant une mise à jour du catalogue.

Étape 2 : ajouter des paramètres de message courants

Une fois que l’objet interactive est terminé, ajoutez les autres paramètres entrant dans la composition d’un message : recipient_type, to et type. N’oubliez pas de définir le type sur interactive.

{
  "recipient_type": "individual",
  "to" : "whatsapp-id", // WhatsApp ID of the recipient
  "type": "interactive",
  "interactive":{
    // The interactive object  
   }
  }

Pour voir les paramètres utilisés dans tous les types de messages, cliquez ici.

Étape 3 : envoyer un appel `POST` à `/messages`

Envoyez une requête POST au point de terminaison /messages avec l’objet JSON que vous avez assemblé aux étapes 1 et 2. Si votre message est bien envoyé, vous obtenez la réponse suivante :

{
  "messages": [{
    "id": "{message-id}"
  }]
  }

Messages multiproduit basés sur un modèle

Pour envoyer un message multiproduit basé sur un modèle, vous aurez besoin d'un modèle de message multiproduit. Consultez notre document Modèles de messages multiproduit pour apprendre à créer ces modèles et à les envoyer dans un message basé sur un modèle.