Inserzioni che rimandano a WhatsApp

Questa guida spiega come creare e pubblicare inserzioni che rimandano a WhatsApp utilizzando l'API Marketing.

Quando cliccano sulle inserzioni che rimandano a WhatsApp, le persone possono avviare direttamente una conversazione con la tua azienda su WhatsApp. Utilizza queste inserzioni per raggiungere le persone su vasta scala e offrire un'assistenza personalizzata di alto livello.

Le inserzioni che rimandano a WhatsApp supportano le inserzioni con un'immagine, un video, un carosello o uno slideshow. Puoi anche includere suggerimenti di chiamata nell'inserzione.

Se ti interessa creare inserzioni che rimandano le persone alle chat di Messenger o Instagram, consulta Inserzioni che rimandano a Messenger o Inserzioni che rimandano a Instagram per indicazioni. Puoi anche creare inserzioni in grado di selezionare la destinazione da cui è più probabile che l'utente risponda; per saperne di più, consulta Inserzioni che rimandano a più destinazioni.

Panoramica della creazione delle inserzioni

Questo documento illustra i passaggi da seguire per configurare la tua integrazione per le inserzioni che rimandano a WhatsApp.

Ecco cosa dovrai fare:

1. Creare una campagna pubblicitaria
2. Creare un gruppo di inserzioni collegato alla campagna pubblicitaria
3. Creare una creatività dell'inserzione per il tipo di inserzione che rimanda a WhatsApp che desideri mostrare
4. Creare un'inserzione attraverso il collegamento della creatività dell'inserzione al gruppo di inserzioni
5. Pubblicare la tua inserzione su Facebook, Instagram e Messenger

Prima di iniziare

Questa guida presuppone che tu abbia:

• un account pubblicitario con Meta;
• caricato qualsiasi risorsa, come immagini o video, da utilizzare nelle inserzioni sui server di Meta;
• una pagina Facebook con numero WhatsApp collegato manualmente o tramite API.

Per effettuare chiamate che vadano a buon fine a tutti gli endpoint indicati in questa guida, avrai bisogno:

• di un token d'accesso della Pagina richiesto da una persona che possa eseguire l'attività ADVERTISE sulla Pagina;
• delle seguenti autorizzazioni che devono essere concesse a una persona che utilizza la tua app:

  • ads_management
  • pages_manage_ads
  • pages_read_engagement
  • pages_show_list

Passaggio 1: creazione di una campagna pubblicitaria

Inizia creando la tua campagna pubblicitaria. Per farlo, effettua una richiesta POST all'endpoint /act_<AD_ACCOUNT_ID>/campaigns in cui <AD_ACCOUNT_ID> è l'ID del tuo account pubblicitario di Meta. La richiesta deve includere:

Parametri

Richiesta 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

Richiesta campagna di chiamate

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

Risposta

In caso di azione eseguita correttamente, l'app riceve una risposta JSON con l'ID della campagna appena creata.

{
  "id": "<AD_CAMPAIGN_ID>"
}

Aggiornamento

Puoi aggiornare una campagna effettuando una richiesta POST a /<AD_CAMPAIGN_ID>.

Lettura

Per verificare di aver creato correttamente una campagna che rimanda a WhatsApp, puoi effettuare una richiesta GET a /<AD_CAMPAIGN_ID>. Per una lista completa di tutti i parametri disponibili, consulta il riferimento per le campagne pubblicitarie.

Richiesta

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

Risposta

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

Passaggio 2: creazione di un gruppo di inserzioni

Una volta creata la campagna pubblicitaria, puoi creare un gruppo di inserzioni. Per creare un gruppo di inserzioni, effettua una richiesta POST all'endpoint /act_<AD_ACCOUNT_ID>/adsets in cui <AD_ACCOUNT_ID> corrisponda all'ID per l'account pubblicitario di Meta. La richiesta deve includere:

Parametri

Per la lista completa dei parametri disponibili, consulta il riferimento per i gruppi di inserzioni dell'account pubblicitario.

Richiesta

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"

Risposta

{
  "id": "<AD_SET_ID>"
}

Aggiornamento

Puoi aggiornare un gruppo di inserzioni effettuando una richiesta POST a /<AD_SET_ID>.

Lettura

Per verificare che il gruppo di inserzioni che rimandano a WhatsApp sia stato creato correttamente, puoi effettuare una richiesta GET a /<AD_SET_ID>. Per la lista completa dei parametri disponibili, consulta il riferimento per i gruppi di inserzioni.

Richiesta

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>

Risposta

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

Passaggio 3: creazione di una creatività dell'inserzione

La creatività dell'inserzione ti consente di aggiungere le risorse alle inserzioni. Per creare una creatività dell'inserzione, effettua una richiesta POST all'endpoint /act_<AD_ACCOUNT_ID>/adcreatives in cui <AD_ACCOUNT_ID> corrisponda all'ID per l'account pubblicitario di Meta. La richiesta deve includere:

Parametri

Per la lista completa dei parametri disponibili, consulta il riferimento per le creatività dell'inserzione.

Compilazione di un messaggio di benvenuto della Pagina

Il messaggio predefinito che un cliente vede è "Ciao! Posso ricevere più informazioni in merito?". Puoi creare esperienze utente più adatte ai destinatari delle tue inserzioni che rimandano a WhatsApp personalizzando il messaggio di saluto delle inserzioni nel campo page_welcome_message in object_story_spec.

Nota: se stai usando il messaggio WhatsApp per attivare eventuali flussi di bot, assicurati di collaborare con BSP e agenzie per aggiornarlo in modo da assicurarti che i flussi non vengano interrotti.

Esempio

Aggiunta di messaggio con inserimento automatico contenente un messaggio di benvenuto

"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>"
    }
  }
}

Aggiunta di messaggi per rompere il ghiaccio con un messaggio di benvenuto

"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>"
          }
        ]
      }
    }
  }
}

Aggiunta di un messaggio con un suggerimento di chiamata

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

Risposta

{
  "id": "<AD_CREATIVE_ID>"
}

Esempi di creazione di creatività dell'inserzione

Richiesta

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"

Risposta

In caso di azione eseguita correttamente, l'app riceve la seguente risposta JSON con l'ID della creatività dell'inserzione appena creata.

{
  "id": "<AD_CREATIVE_ID>"
}

Creazione di creatività dell'inserzione usando i contenuti di Instagram

Puoi anche usare i tuoi contenuti di Instagram esistenti per le creatività dell'inserzione.

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

Aggiornamento

Puoi aggiornare una creatività dell'inserzione effettuando una richiesta POST a /<AD_CREATIVE_ID>.

Lettura

Per verificare di aver creato correttamente una creatività dell'inserzione che rimanda a WhatsApp, puoi effettuare una richiesta GET a /<AD_CREATIVE_ID>. Per la lista completa dei parametri disponibili, consulta Creatività dell'inserzione.

Richiesta

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>

Risposta

{
  "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>"
}

Passaggio 4: creazione di un'inserzione

Le inserzioni ti consentono di associare le informazioni sulle creatività dell'inserzione ai tuoi gruppi di inserzioni. Per creare un'inserzione, effettua una richiesta POST all'endpoint /act_<AD_ACCOUNT_ID>/ads in cui <AD_ACCOUNT_ID> è l'ID del tuo account pubblicitario di Meta. La richiesta deve includere:

Parametri

Richiesta

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"

Risposta

{
  "id": "<AD_ID>"
}

Aggiornamento

Puoi aggiornare un'inserzione effettuando una richiesta POST a /<AD_ID>.

Lettura

Per verificare di aver creato correttamente un'inserzione che rimanda a WhatsApp, puoi effettuare una richiesta GET a /<AD_ID>. Per la lista completa dei parametri disponibili, consulta il riferimento per le inserzioni.

Richiesta

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

Risposta

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

Passaggio 5: pubblicazione dell'inserzione

Verifica che la tua inserzione esista in Gestione inserzioni. Quando vuoi pubblicare delle modifiche, seleziona la tua campagna, il gruppo di inserzioni per la campagna e l'inserzione, quindi clicca sul pulsante Pubblica.

Puoi anche pubblicare la tua inserzione usando l'API. Basta inviare una richiesta POST a /<AD_ID> con il parametro status impostato a ACTIVE in cui <AD_ID> è l'inserzione che vuoi pubblicare.

L'inserzione verrà controllata da Meta e lo stato sarà PENDING_REVIEW. Dopo l'approvazione, lo stato verrà automaticamente aggiornato ad ACTIVE e l'inserzione verrà pubblicata.