Publicités clic vers WhatsApp

Ce guide explique comment créer et publier des publicités clic vers WhatsApp à l’aide de l’API Marketing.

Les publicités clic vers WhatsApp dirigent automatiquement les internautes qui cliquent sur vos publicités vers des conversations avec votre entreprise sur WhatsApp. Utilisez ces publicités pour toucher les internautes à grande échelle et leur offrir un service personnalisé de qualité.

Les publicités clic vers WhatsApp prennent en charge les publicités avec une image, une vidéo, un carrousel ou un diaporama. Vous pouvez également inclure des invites d’appel dans votre publicité.

Si vous souhaitez créer des publicités qui redirigent les internautes vers Messenger ou des discussions Instagram, consultez les procédures relatives aux Publicités clic vers Messenger ou Publicités clic vers Instagram. Vous pouvez également créer des publicités qui choisissent la destination la plus pertinente pour l’internaute. Pour plus d’informations, consultez la page relative aux Publicités qui renvoient à la multi-destination.

Présentation de la création de publicités

Ce document décrit les étapes à suivre pour configurer votre intégration pour les publicités clic vers WhatsApp.

Vous devez :

1. Créer une campagne publicitaire
2. Créer un ensemble de publicités qui associe vos publicités à votre campagne publicitaire
3. Créer un contenu publicitaire pour le type de publicité WhatsApp que vous souhaitez diffuser
4. Créer une publicité en liant votre contenu publicitaire à votre ensemble de publicités
5. Publier votre publicité sur Facebook, Instagram et Messenger

Avant de commencer

Ce guide considère que vous disposez des éléments suivants :

• Un compte publicitaire avec Meta
• Tous les éléments (images, vidéos, etc.) qui seront utilisés dans vos publicités sur les serveurs Meta, déjà importés
• Une page Facebook avec un numéro WhatsApp associé manuellement ou via l’API

Pour réussir les appels aux points de terminaison mentionnés dans ce guide, vous aurez besoin des éléments suivants :

• Un token d’accès de Page demandé par un·e utilisateur·ice autorisé·e à effectuer la tâche ADVERTISE sur la Page
• Les autorisations suivantes accordées à un·e internaute utilisant votre application :

  • ads_management
  • pages_manage_ads
  • pages_read_engagement
  • pages_show_list

Étape 1 : créer une campagne publicitaire

Commencez par créer votre campagne publicitaire. Pour ce faire, envoyez une requête POST au point de terminaison /act_<AD_ACCOUNT_ID>/campaigns où <AD_ACCOUNT_ID> est l’ID de votre compte publicitaire Meta. Votre requête doit inclure :

Paramètres

Requête standard

curl -X POST \
  -F 'name=Click to WhatsApp Campaign' \
  -F 'objective=OUTCOME_ENGAGEMENT' \
  -F 'status=ACTIVE' \
  -F 'special_ad_categories=[]' \
  -F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/campaigns

Requête de campagne d’appel

curl -X POST \
  -F 'name=Click to WhatsApp Calling Campaign' \
  -F 'objective=OUTCOME_ENGAGEMENT' \
  -F 'status=PAUSED' \
  -F 'special_ad_categories=[]' \
  -F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/campaigns

Réponse

Si la requête aboutit, votre application reçoit une réponse JSON contenant l’ID de la campagne que vous venez de créer.

{
  "id": "<AD_CAMPAIGN_ID>"
}

Mise à jour

Vous pouvez mettre à jour une campagne en envoyant une requête POST à /<AD_CAMPAIGN_ID>.

Lecture

Pour vérifier que vous avez bien créé une campagne clic vers WhatsApp, vous pouvez envoyer une requête GET à /<AD_CAMPAIGN_ID>. Consultez la section Campagne publicitaire, Référence pour obtenir la liste complète des paramètres disponibles.

Requête

curl -X GET -G \
  -d 'fields=name,status,objective' \
  -d 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/<AD_CAMPAIGN_ID>

Réponse

{
  "name": "Click to WhatsApp Campaign",
  "status": "PAUSED",
  "objective": "OUTCOME_ENGAGEMENT",
  "id": "<AD_CAMPAIGN_ID>"
}

Étape 2 : créer un ensemble de publicités

Une fois que vous disposez d’une campagne publicitaire, créez votre ensemble de publicités. Pour créer un ensemble de publicités, envoyez une requête POST au point de terminaison /act_<AD_ACCOUNT_ID>/adsets où <AD_ACCOUNT_ID> est l’ID de votre compte publicitaire Meta. Votre requête doit inclure :

Paramètres

Consultez la section Référence sur le compte publicitaire d’un ensemble de publicités pour obtenir la liste complète des paramètres disponibles.

Requête

curl -X POST \
  -H "Content-Type: application/json" \
  -d '{
    "access_token":"<ACCESS_TOKEN>",
    "bid_amount":"<BID_AMOUNT>",
    "billing_event":"IMPRESSIONS",
    "campaign_id":"<CAMPAIGN_ID>",
    "daily_budget":"<DAILY_BUDGET>",
    "destination_type":"WHATSAPP",
    "name": "<AD_SET_NAME>",
    "optimization_goal": "IMPRESSIONS",
    "promoted_object": {
      "page_id": "<PAGE_ID>"
    },
    "status": "PAUSED",
    "start_time": "<START_TIME>",
    "targeting": { 
      "geo_locations": { "countries":["US","CA"] },
      "device_platforms": ["mobile", "desktop"]
    } 
  }' \
"https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adsets"

Réponse

{
  "id": "<AD_SET_ID>"
}

Mise à jour

Vous pouvez mettre à jour un ensemble de publicités en envoyant une requête POST à /<AD_SET_ID>.

Lecture

Pour vérifier que vous avez bien créé un ensemble de publicités clic vers WhatsApp, vous pouvez envoyer une requête GET à /<AD_SET_ID>. Consultez la section Ensemble de publicités, Référence pour obtenir la liste complète des paramètres disponibles.

Requête

curl -X GET -G \
  -d 'fields=name,destination_type,optimization_goal,bid_strategy,status' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/<AD_SET_ID>

Réponse

{
  "name": "Click to WhatsApp Campaign",
  "status": "PAUSED",
  "objective": "OUTCOME_ENGAGEMENT",
  "id": "<AD_SET_ID>"
}

Étape 3 : créer un contenu publicitaire

Le contenu publicitaire vous permet d’ajouter des éléments à vos publicités. Pour créer un contenu publicitaire, envoyez une requête POST au point de terminaison /act_<AD_ACCOUNT_ID>/adcreatives où <AD_ACCOUNT_ID> est l’ID de votre compte publicitaire Meta. Votre requête doit inclure :

Paramètres

Consultez la section Référence sur les contenus publicitaires pour obtenir la liste complète des paramètres disponibles.

Rédaction d’un message de bienvenue de la Page

Par défaut, le message visible par les internautes sera « Bonjour ! Puis-je en savoir plus à ce sujet ? ». Vous pouvez créer des expériences d’utilisation plus adaptées pour vos publicités clic vers WhatsApp en personnalisant le message d’accueil de vos publicités dans le champ page_welcome_message sous object_story_spec.

Note : si vous utilisez le message WhatsApp pour déclencher des flux de bot, veillez à travailler avec votre BSP et vos agences pour le mettre à jour afin que les flux ne soient pas perturbés.

Exemple

Ajout d’un message de saisie automatique à un message d’accueil

"page_welcome_message": {
  "type": "VISUAL_EDITOR",
  "version": 2,
  "landing_screen_type": "welcome_message",
  "media_type": "text",
  "text_format": {
    "customer_action_type": "autofill_message",
    "message": {
      "autofill_message": {
        "content": "<AUTOFILL_MESSAGE>"
      },
      "text": "<GREETING_MESSAGE>"
    }
  }
}

Ajout de prises de contact à un message d’accueil

"page_welcome_message": {
  "type": "VISUAL_EDITOR",
  "version": 2,
  "landing_screen_type": "welcome_message",
    "media_type": "text",
    "text_format": {
      "customer_action_type": "ice_breakers",
      "message": {
        "text": "<GREETING_MESSAGE>",
        "ice_breakers": [
          {
            "title": "<ICEBREAKER>"
          },
          {
            "title": "<ICEBREAKER>"
          },
          {
            "title": "<ICEBREAKER>"
          }
        ]
      }
    }
  }
}

Ajout d’un message avec une invite d’appel

curl \
  -F 'object_story_spec={
      "page_id": "<PAGE_ID>"
      "link_data": {
     "image_hash":<IMAGE_HASH>
            "call_to_action": {
              	"type": "WHATSAPP_MESSAGE",
              	"value": {
                  	"app_destination": "WHATSAPP"
             	 }
          },
          "link": "https://api.whatsapp.com/send",
          "name": <AD_HEADLINE>",
          "page_welcome_message":
       "type": "VISUAL_EDITOR",
        "version": 2,
        "landing_screen_type": "ctwa_call_prompt",
        "media_type": "text",
        "text_format": {
          "message": {
            "text": "<MESSAGE>"", 
            "call_prompt_data": {
              "call_prompt_message": "<CALL_PROMPT_MESSAGE>"
            }
          }
        },
        "user_edit": false
      },
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives

Réponse

{
  "id": "<AD_CREATIVE_ID>"
}

Exemples de création de contenu publicitaire

Requête

curl -X POST \
  -H "Content-Type: application/json" \
  -d '{
        "name": "Sample ad creative",
        "object_story_spec": {
          "page_id": "<PAGE_ID>",
          "link_data": {
            "name": "<AD_HEADLINE>",
            "message": "<AD_PRIMARY_TEXT>",
            "description": "<AD_DESCRIPTION>",
            "image_hash": "<IMAGE_HASH>",
            "link": "https://api.whatsapp.com/send",
            "page_welcome_message": "<PAGE_WELCOME_MESSAGE>",
            "call_to_action": {
              "type": "WHATSAPP_MESSAGE",
              "value": {
                "app_destination": "WHATSAPP"
              }
            }
          }
        },
        "degrees_of_freedom_spec": {
          "creative_features_spec": {
            "standard_enhancements": {
              "enroll_status": "OPT_IN"
            }
          }
        }
      }' \
"https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives"

Réponse

Si la requête aboutit, votre application reçoit une réponse JSON contenant l’ID du contenu publicitaire que vous venez de créer.

{
  "id": "<AD_CREATIVE_ID>"
}

Création de contenus publicitaires à l’aide de contenus Instagram

Vous pouvez également utiliser votre contenu Instagram existant pour vos contenus publicitaires.

curl -X POST \
  -H "Content-Type: application/json" \
  -d '{
        "source_instagram_media_id": "<INSTAGRAM_MEDIA_ID>",
        "instagram_user_id": "<INSTAGRAM_USER_ID>",
        "object_id": "<PAGE_ID>",
        "call_to_action": {
          "type": "WHATSAPP_MESSAGE",
            "value": {
              "link": "https://api.whatsapp.com/send",
              "app_destination": "WHATSAPP"
            }
          }
        },
        "degrees_of_freedom_spec": {
          "creative_features_spec": {
            "standard_enhancements": {
              "enroll_status": "OPT_IN"
            }
          }
        }
      }' \
  https://graph.facebook.com/latest-api-version />/act_<AD_ACCOUNT_ID>/adcreatives

Mise à jour

Vous pouvez mettre à jour un contenu publicitaire en envoyant une requête POST à /<AD_CREATIVE_ID>.

Lecture

Pour vérifier que vous avez bien créé un contenu publicitaire clic vers WhatsApp, vous pouvez envoyer une requête GET à /<AD_CREATIVE_ID>. Consultez la section Contenu publicitaire pour obtenir la liste complète des paramètres disponibles.

Requête

curl -X GET -G \
  -d 'fields=name,object_story_spec{link_data{call_to_action,page_welcome_message}}' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/<AD_CREATIVE_ID>

Réponse

{
  "name": "Sample ad creative",
  "object_story_spec" {
    "page_welcome_message": {
      "type": "VISUAL_EDITOR",
      "version": 2,
      "landing_screen_type": "welcome_message",
      "media_type": "text",
      "text_format": {
        "customer_action_type": "autofill_message",
        "message": {
          "autofill_message": {
            "content": "Sample autofill message"
          },
        "text": "Sample greeting message"
        }
      }
    }
  },
  "id": "<AD_CREATIVE_ID>"
}

Étape 4 : créer une publicité

Les publicités vous permettent d’associer des informations de contenus publicitaires à vos ensembles de publicités. Pour créer une publicité, envoyez une requête POST au point de terminaison /act_<AD_ACCOUNT_ID>/ads où <AD_ACCOUNT_ID> est l’ID de votre compte publicitaire Meta. Votre requête doit inclure :

Paramètres

Requête

curl -X POST \
  -H "Content-Type: application/json" \
  -d '{
        "name": "Sample ad",
        "adset_id": "<AD_SET_ID>",
        "creative": {
          "creative_id": "<AD_CREATIVE_ID>"
        },
        "status": "PAUSED"
     }' \
  "https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/ads"

Réponse

{
  "id": "<AD_ID>"
}

Mise à jour

Vous pouvez mettre à jour une publicité en envoyant une requête POST à /<AD_ID>.

Lecture

Pour vérifier que vous avez bien créé une publicité clic vers WhatsApp, vous pouvez envoyer une requête GET à /<AD_ID>. Consultez la section Référence sur les publicités pour obtenir la liste complète des paramètres disponibles.

Requête

curl -X GET -G \
  -d 'fields=status,adset_id,campaign_id \
  -d 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/<AD_ID>

Réponse

{
  "status": "PAUSED",
  "adset_id": "<AD_SET_ID>",
  "campaign_id": "<AD_CAMPAIGN_ID>",
  "id": "<AD_ID>"
}

Étape 5 : publier votre publicité

Vérifiez que votre publicité existe bien dans le Gestionnaire de publicités. Lorsque vous êtes prêt à publier vos modifications, sélectionnez votre campagne, l’ensemble de publicités correspondant ainsi que la publicité, et cliquez sur le bouton Publier.

Vous pouvez également publier votre publicité en utilisant l’API. Envoyez simplement une requête POST à /<AD_ID> avec le paramètre status défini sur ACTIVE où <AD_ID> est la publicité que vous souhaitez publier.

En attendant la vérification par Meta, le statut passe à PENDING_REVIEW. Une fois la publicité approuvée, son statut passera automatiquement à ACTIVE et elle sera diffusée.