Plateforme WhatsApp Business > API Cloud > Guides

Partager des produits avec la clientèle

Il existe plusieurs moyens de partager des produits avec la clientèle :

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 libres contenant des miniatures du catalogue et un lien vers votre catalogue produits complet.
Messages produits : messages libres 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 object is optional */
      "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	Facultatif. 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

curl 'https://graph.facebook.com/v17.0/106540352242922/messages' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer EAAJB...' \
-d '
{
  "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

Vous pouvez envoyer un lien vers l’ensemble de votre catalogue produits en créant un lien wa.me et en l’insérant dans un message texte type. Dans ce cas, vous pouvez 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 vous désactivez 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, vous devez ajouter votre numéro de téléphone professionnel 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

Les client·es qui reçoivent des messages concernant un ou plusieurs produits peuvent 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 client ou qu’une cliente 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 : à chaque fois qu’un client ou qu’une cliente 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 vous et le client ou la cliente jusqu’à ce qu’il vous soit envoyé. Pour en savoir plus, consultez l’Expérience du panier d’achat.
Envoyer un panier : après avoir ajouté tous les articles nécessaires, les client·es peuvent vous envoyer leur panier. Après cela, vous pouvez 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, 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 client ou la cliente 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. Vous recevrez également une notification webhook indiquant que le message n’a pas pu être distribué, car le client ou la cliente 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 la même conversation.

Les messages concernant un ou plusieurs produits ne peuvent pas être :

envoyés sous forme de notification. Ils peuvent uniquement être envoyés dans le cadre de conversations existantes.

Limites

Contrairement aux messages produits envoyés via l’application WhatsApp Business, les messages envoyés via l’API Cloud n’affichent actuellement pas d’icône de panier dans l’en-tête du fil de discussion.

Mises à jour concernant les produits

Vous pouvez avoir besoin de mettre à jour les propriétés des articles de votre 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.	Vous envoyez un message concernant un ou plusieurs produits qui mentionne le produit A. Vous mettez à jour les propriétés du produit A dans votre 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é	Vous envoyez à un·e client·e un message concernant un ou plusieurs produits qui mentionne le produit B. Vous vendez toutes les unités du produit B disponibles. Vous mettez ensuite à jour votre catalogue en précisant que le produit B n’est plus disponible. Si un client ou une cliente 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.

Vous envoyez un message concernant un ou plusieurs produits qui mentionne le produit A.
Vous mettez à jour les propriétés du produit A dans votre 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é

Vous envoyez à un·e client·e un message concernant un ou plusieurs produits qui mentionne le produit B.
Vous vendez toutes les unités du produit B disponibles. Vous mettez ensuite à jour votre catalogue en précisant que le produit B n’est plus disponible.
Si un client ou une cliente 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 vous envoyer ce panier. D’un point de vue strictement commercial sur WhatsApp :

Un panier correspond uniquement à un fil de discussion entre le client ou la cliente et l’entreprise sur un appareil spécifique : un seul panier est créé par fil de discussion entre vous et la personne, 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 vous soit envoyé. 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. Vous ne pouvez 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 votre inventaire :

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 votre inventaire. 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 des messages de produits, suivez la procédure de démarrage la mieux adaptée à vos besoins :

Tous les appels d’API mentionnés dans le présent guide doivent être authentifiés à l’aide d’un token d’accès. Les équipes de développement peuvent authentifier leurs appels d’API à l’aide du token d’accès généré dans le panneau Espace App > WhatsApp > Configuration de l’API. Les fournisseurs de solutions partenaires doivent s’authentifier à l’aide d’un token d’accès avec l’autorisation whatsapp_business_messaging.

Étape 1 : assembler l’objet interactive

Messages concernant un seul produit

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

Composants requis	Composants facultatifs
Objet action : doit inclure à la fois catalog_id et product_retailer_id.	Objet body Objet footer

Pour plus d’informations, consultez la section Messages, objet interactive. Vers la fin du traitement, l’objet interactive doit ressembler à ce qui suit :

{
  "messaging_product": "whatsapp",
  "recipient_type": "individual",
  "to": "PHONE_NUMBER",
  "type": "interactive",
  "interactive": {
    "type": "product",
    "body": {
      "text": "BODY_TEXT"
    },
    "footer": {
      "text": "FOOTER_TEXT"
    },
    "action": {
      "catalog_id": "CATALOG_ID",
      "product_retailer_id": "ID_TEST_ITEM_1"
    }
  }
}

Messages concernant plusieurs produits

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

Composants requis	Composants facultatifs
Objet header : le type de l’en-tête doit être défini sur texte. N’oubliez pas d’ajouter un objet text avec le contenu souhaité. Objet body Objet action : doit inclure catalog_id et des sections. Les sections doivent être un tableau d’objets décrivant chaque section au moyen d’un titre et de valeurs product_items. La valeur produit_items de chaque section doit être un tableau décrivant chaque produit dans la section au moyen du product_retailer_id et du numéro SKU du produit.	Objet footer

Composants requis

Composants facultatifs

Objet header : le type de l’en-tête doit être défini sur texte. N’oubliez pas d’ajouter un objet text avec le contenu souhaité.
Objet body
Objet action : doit inclure catalog_id et des sections.
- Les sections doivent être un tableau d’objets décrivant chaque section au moyen d’un titre et de valeurs product_items.
  - La valeur produit_items de chaque section doit être un tableau décrivant chaque produit dans la section au moyen du product_retailer_id et du numéro SKU du produit.

Objet footer

Pour plus d’informations, consultez la section Messages, objet interactive. Vers la fin du traitement, l’objet interactive doit ressembler à ce qui suit :

{
  "messaging_product": "whatsapp",
  "recipient_type": "individual",
  "to": "PHONE_NUMBER",
  "type": "interactive",
  "interactive": {
    "type": "product_list",
    "header":{
      "type": "text",
      "text": "HEADER_CONTENT"
    },
    "body": {
      "text": "BODY_CONTENT"
    },
    "footer": {
      "text": "FOOTER_CONTENT"
    },
    "action": {
      "catalog_id": "CATALOG_ID",
      "sections": [
        {
          "title": "SECTION_TITLE",
          "product_items": [
            { "product_retailer_id": "PRODUCT-SKU" },
            { "product_retailer_id": "PRODUCT-SKU" },
            ...
          ]

        },
        {
          "title": "SECTION_TITLE",
          "product_items": [
            { "product_retailer_id": "PRODUCT-SKU" },
            { "product_retailer_id": "PRODUCT-SKU" },
            ...
          ]
        }
      ]
    }
  }
}

Articles manquants

Si aucun des articles fournis dans les appels d’API ci-dessus ne correspond à un produit de votre catalogue, 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 de votre catalogue. Dans ce cas :

Les messages sont bien envoyés.
Les articles sans correspondance sont ignorés.
Vous recevez 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, messaging_product et type. N’oubliez pas de définir le type sur interactive.

curl -X  POST https://graph.facebook.com/v19.0/FROM_PHONE_NUMBER/messages \
 -H 'Authorization: Bearer ACCESS_TOKEN' \
 - d '{
  "messaging_product": "whatsapp",
  "recipient_type": "individual",
  "to": "PHONE_NUMBER",
  "type": "interactive",
  "interactive": {
  // INTERACTIVE OBJECT GOES HERE    
}'

Pour connaître tous les paramètres disponibles, consultez la section Référence, messages.

Étape 3 : envoyer une demande au point de terminaison des messages

Envoyez une requête POST au point de terminaison /PHONE_NUMBER_ID/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 :

{
  "messaging_product": "whatsapp",
  "contacts": [{
      "input": "PHONE_NUMBER",
      "wa_id": "WHATSAPP_ID",
    }]
  "messages": [{
      "id": "wamid.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.

Plateforme WhatsApp Business | API Cloud | API Business Management