DocumentazioneExperience PlatformGuida ai connettori di origini

[Beta]{class="badge informative"}

WhatsApp

Ultimo aggiornamento: 29 ottobre 2026

Creato per:

  • Sviluppatore
NOTE
L'origine WhatsApp è in versione beta. Per ulteriori informazioni sull'utilizzo dei connettori con etichetta beta, leggere la Panoramica origini.
IMPORTANT
Questa origine è in versione beta privata e disponibile per un numero limitato di clienti. Contatta il tuo rappresentante Adobe per richiedere l’accesso.

Adobe Experience Platform consente di acquisire dati da origini esterne e allo stesso tempo di strutturare, etichettare e migliorare i dati in arrivo tramite i servizi Platform. Puoi acquisire dati da diverse origini, ad esempio applicazioni Adobe, archiviazione basata su cloud, database e molte altre.

Experience Platform fornisce supporto per l’acquisizione di dati da applicazioni di streaming. Il supporto per i provider di messaggi include WhatsApp.

WhatsApp Business è una piattaforma di messaggistica utilizzata dalle aziende per comunicare con i clienti oltre WhatsApp. L’origine WhatsApp trasmette in tempo reale i messaggi in entrata inviati dai clienti al numero di telefono WhatsApp Business ad Experience Platform.

Meta consegna ogni messaggio a un endpoint di streaming di Platform (un webhook), dove viene acquisito come record di evento esperienza non elaborato e aggiunto a un set di dati nel data lake per l’utilizzo a valle. Il connettore acquisisce il payload del webhook non elaborato così com’è, quindi ogni tipo di messaggio WhatsApp viene mantenuto.

Funzionamento del connettore how-it-works

L’origine WhatsApp segue questa sequenza per portare un messaggio in Experience Platform:

  1. Un cliente invia un messaggio al tuo numero di telefono WhatsApp Business.
  2. Meta firma il payload del webhook con il segreto dell’app (X-Hub-Signature-256) e lo invia all’URL di callback configurato sull’endpoint di streaming di Platform.
  3. Platform convalida la firma, acquisisce il payload non elaborato come evento esperienza e lo aggiunge al set di dati WhatsApp.

Prerequisiti prerequisites

Prima di creare una connessione di origine WhatsApp, completa quanto segue in Meta all’indirizzo developers.facebook.com:

  • Crea un’app Meta di tipo Business e aggiungi il prodotto WhatsApp.
  • Creare un account aziendale WhatsApp (WABA) con un numero di telefono registrato.
  • Assicurarsi che l’app disponga delle autorizzazioni whatsapp_business_management e whatsapp_business_messaging.
  • Da Impostazioni app > Base, copia il segreto app. Meta utilizza il segreto app per firmare i payload del webhook.
  • Scegli un token di verifica. Può essere qualsiasi stringa ed è un segreto condiviso che immetti sia su Platform che su Meta.

Nella tabella seguente viene descritto dove trovare ogni credenziale e a cosa serve.

Credenziali
Dove prenderlo
Utilizzato per
Segreto app
Meta > Impostazioni app > Base
Convalida della firma X-Hub-Signature-256 in ogni webhook in entrata.
Verifica token
Scegli tu
Handshake di verifica una tantum tra Meta e Platform.

Iscrizione dell’app a WABA subscribe-app

Iscriviti alla tua app Meta per l’account WhatsApp Business in modo che Meta distribuisca gli eventi WABA alla tua app. Questo passaggio è obbligatorio e viene eseguito interamente su Meta, ma la consegna inizia solo dopo la configurazione dell’URL di callback. Consulta Connettere WhatsApp Business ad Experience Platform.

IMPORTANT
Se salti questo passaggio, i messaggi non vengono mai consegnati e in Platform non viene visualizzato alcun errore. Una sottoscrizione WABA mancante è la causa più comune di problemi di "nessun dato acquisito". Consulta Risoluzione dei problemi.

Iscriviti all’app utilizzando l’API Graph:

POST https://graph.facebook.com/{VERSION}/{WHATSAPP_BUSINESS_ACCOUNT_ID}/subscribed_apps

Verifica l’abbonamento con:

GET https://graph.facebook.com/{VERSION}/{WHATSAPP_BUSINESS_ACCOUNT_ID}/subscribed_apps

Entrambe le chiamate richiedono un token con l’autorizzazione whatsapp_business_management e l’accesso a WABA. Sostituisci {VERSION} con una versione corrente dell’API grafica, ad esempio v21.0 o successiva.

Funzionamento automatico del connettore automatic-provisioning

Al termine della creazione di un flusso di dati WhatsApp, il connettore crea e genera le seguenti entità. Non selezionare un set di dati di destinazione o mappare i campi manualmente.

Entità
Nome o identificatore
Creato o riutilizzato
Note
Schema
Eventi non elaborati del webhook WhatsApp (classe XDM ExperienceEvent)
Riutilizzato se presente, altrimenti creato una volta per sandbox
Il primo flusso di dati WhatsApp in una sandbox lo crea. Ogni flusso di dati successivo riutilizza lo stesso schema.
Gruppo di campi
Payload webhook WhatsApp V2
Riutilizzato (standard)
Il connettore fa riferimento al gruppo di campi standard esistente. Non ne crea mai uno.
Set di dati
Eventi non elaborati del webhook WhatsApp
Creato per flusso di dati
Set di dati evento di esperienza di destinazione non elaborato per i messaggi in entrata.
Mappatura campi
Generato dal sistema
Creato per flusso di dati
Mappa il payload del webhook non elaborato nello schema e viene collegato al flusso di dati come trasformazione.
Endpoint di streaming (ingresso)
Emerso come URL di callback
Creato per flusso di dati
Applica la convalida della firma X-Hub-Signature-256 e l’handshake del token di verifica.
Connessione a Target (data lake)
Generato dal sistema
Creato per flusso di dati
Indirizza i dati mappati nel set di dati.

Ruota segreti rotate-secrets

Puoi ruotare il Segreto app o Verifica token in qualsiasi momento aggiornando la connessione. Platform supporta un segreto principale e secondario, in modo da poter eseguire il roll-out del segreto dell’app senza tempi di inattività. Aggiungi il nuovo valore come segreto primario mantenendo il valore precedente come segreto secondario durante la transizione. L’aggiornamento della connessione applica la modifica a tutti i flussi di dati che la utilizzano.

Risoluzione dei problemi troubleshooting

La tabella seguente descrive i problemi comuni e come risolverli.

Sintomo
Probabile causa e risoluzione del problema
Tutto in Platform sembra in salute, ma non vengono acquisiti dati.
L’app non è abbonata a WABA. Completa l’abbonamento WABA descritto in Iscriviti all’app WABA. Questa è la causa più comune e fallisce in silenzio. Se l’app è abbonata, verificare che il segreto app in Platform corrisponda al segreto app corrente in Meta in Impostazioni app > Base.
“Verifica e salva” non riesce in Meta.
Il token di verifica in Meta deve corrispondere esattamente al token di verifica immesso in Platform.

Connetti WhatsApp ad Experience Platform connect-to-platform

La documentazione seguente fornisce informazioni su come creare un connettore di streaming WhatsApp per connettersi ad Experience Platform utilizzando l’interfaccia utente:

Connetti WhatsApp ad Experience Platform tramite l’interfaccia utente connect-to-platform-using-ui

Risorse aggiuntive additional-resources

recommendation-more-help
experience-platform-help-sources