In questa pagina: configura le credenziali API WhatsApp, i webhook e una configurazione di canale per connettere l’account WhatsApp Business, in modo che l’ambiente sia pronto per inviare messaggi WhatsApp con Journey Optimizer.
Prima di inviare il messaggio WhatsApp, devi configurare l’ambiente Adobe Journey Optimizer e associarti all’account WhatsApp. Per eseguire questa operazione:
Questi passaggi devono essere eseguiti da un amministratore di sistema di Adobe Journey Optimizer.
Creare le credenziali API WhatsApp whatsapp-credentials
-
Nella barra a sinistra, passa a Amministrazione
>Canali e seleziona il menu Credenziali API. Fare clic sul pulsante Crea nuove credenziali API. -
Configura le credenziali API come descritto di seguito:
- Token API: immetti il token API. Ulteriori informazioni nella documentazione di Meta
- ID account aziendale: immetti il numero univoco relativo al tuo portfolio aziendale. Ulteriori informazioni nella documentazione di Meta.
-
Fai clic su Continua.
-
Scegli l’account aziendale WhatsApp che desideri connettere alle credenziali API WhatsApp.
-
Seleziona il Nome mittente utilizzato per inviare i messaggi WhatsApp.
-
Le impostazioni del numero di telefono vengono compilate automaticamente:
-
Valutazione qualità: riflette il feedback del cliente sui messaggi inviati nelle ultime 24 ore.
- Verde: alta qualità
- Giallo: qualità Medium
- Rosso: bassa qualità
Ulteriori informazioni sulla valutazione qualità
-
Velocità effettiva: indica la velocità con cui il numero di telefono può inviare messaggi.
-
-
Fai clic su Invia al termine della configurazione delle credenziali API.
Dopo aver creato e configurato le credenziali API, ora è necessario creare il webhook per i messaggi WhatsApp. Ulteriori informazioni
Creare webhook WhatsApp-webhook
Una volta create correttamente le credenziali API WhatsApp, ora puoi configurare i webhook per:
- Acquisisci le risposte in entrata per la gestione del consenso di consenso e rinuncia
- Ricevi i report di consegna, ad esempio le conferme di lettura (se disponibili) e lo stato di consegna dei messaggi
- Abilita eventi di tracciamento per analisi e reporting nei set di dati di Adobe Experience Platform
I webhook fungono da ponte di comunicazione tra WhatsApp Business Platform e Adobe Journey Optimizer di Meta e consentono di ricevere notifiche in tempo reale sugli eventi dei messaggi e sulle interazioni degli utenti.
Meta consente un solo webhook, URL di callback e token di verifica, per account aziendale WhatsApp, anche tra più sandbox o credenziali WhatsApp. Gli eventi di feedback (inviati, recapitati, letti, errori, clic sul pulsante) vengono comunque acquisiti correttamente in ogni sandbox. Gli eventi in entrata (risposte, parole chiave opt-in/opt-out/help) vengono ricevuti solo nella singola sandbox in cui è registrato il webhook. Registralo nella sandbox di produzione per ricevere gli eventi in entrata.
-
Nella barra a sinistra, passa a Amministrazione
>Canali, seleziona il menu Webhook WhatsApp in Impostazioni WhatsApp e fai clic sul pulsante Crea webhook.
-
Immetti un Nome per il tuo webhook.
-
Dall’elenco a discesa Seleziona configurazione, seleziona le credenziali API create in precedenza.
-
Scegli la categoria di parole chiave in entrata, ad esempio:
- Parole chiave di consenso
- Parole chiave per la rinuncia
- Parole chiave della Guida
- Predefinito - Categoria di fallback per tutti i messaggi in entrata che non corrispondono ad altre parole chiave. Utilizza questa categoria per abilitare il tracciamento degli eventi (aperture, rapporti di consegna) nei set di dati di Adobe Experience Platform.
-
Immetti Parole chiave e fai clic su
-
Dal campo Messaggio di risposta, immettere il messaggio inviato quando viene ricevuta una parola chiave configurata oppure selezionare un’opzione predefinita dal menu a discesa.
-
Fai clic su
-
Fai clic su Invia al termine della configurazione del webhook WhatsApp.
-
Nel menu Webhook, fai clic sull’icona
-
Per modificare la configurazione esistente e accedere all’URL webhook o al token di verifica webhook, individuare il webhook desiderato e fare clic sull’opzione Modifica per apportare le modifiche necessarie.
-
Copia il token di verifica del webhook generato qui, quindi incollalo nell’interfaccia di Meta come parte della configurazione del webhook.
Per istruzioni dettagliate su come e dove aggiungere questo token di verifica, consulta la documentazione di Meta.
-
Accedi e copia il nuovo URL webhook dal webhook WhatsApp inviato in precedenza.
Una volta configurato il webhook, puoi creare la configurazione WhatsApp.
Crea configurazione WhatsApp whatsapp-configuration
-
Nella barra a sinistra, passa a Amministrazione > Canali e seleziona Impostazioni generali > Configurazioni canale. Fare clic sul pulsante Crea configurazione canale.
-
Inserisci un nome e una descrizione (facoltativa) per la configurazione, quindi seleziona il canale WhatsApp.
note NOTE I nomi devono iniziare con una lettera (A-Z). Può contenere solo caratteri alfanumerici. È inoltre possibile utilizzare i caratteri trattino basso _, punto.e trattino-. -
Seleziona WhatsApp come tuo canale.
-
Seleziona Azioni di marketing per associare i criteri di consenso ai messaggi utilizzando questa configurazione. Tutti i criteri di consenso associati all’azione di marketing vengono utilizzati per rispettare le preferenze dei clienti. Ulteriori informazioni
-
Nella sezione Impostazioni WhatsApp, seleziona la configurazione WhatsApp creata in precedenza.
-
Immettere il numero di telefono del mittente che si desidera utilizzare per le comunicazioni. Non includere un segno “+” prima del numero, in quanto ciò può impedire il corretto funzionamento del flusso di rinuncia.
-
Utilizza il Campo di esecuzione WhatsApp per selezionare tra gli attributi del profilo il numero di telefono da utilizzare in priorità se nel database sono disponibili più numeri. Ulteriori informazioni
note NOTE Per impostazione predefinita, Journey Optimizer utilizza il numero di telefono specificato nelle impostazioni generali a livello di sandbox. L’aggiornamento di questo campo sovrascrive il valore predefinito per i percorsi e le campagne che utilizzano questa configurazione. -
Una volta configurati tutti i parametri, fai clic su Invia per confermare. Puoi anche salvare la configurazione del canale come bozza e riprenderla in un secondo momento.
-
Una volta creata, la configurazione del canale viene visualizzata nell’elenco con lo stato Elaborazione.
note NOTE Se i controlli non hanno esito positivo, ulteriori informazioni sui possibili motivi di errore in questa sezione. -
Una volta completati i controlli, la configurazione del canale ottiene lo stato Attivo. È pronto per essere utilizzato per inviare messaggi.
Una volta configurata, puoi sfruttare tutte le funzionalità di canale predefinite, come l’authoring dei messaggi, la personalizzazione, il tracciamento dei collegamenti e il reporting.
Ora puoi inviare messaggi WhatsApp con Journey Optimizer.
Risoluzione dei problemi relativi alla configurazione del canale WhatsApp troubleshooting
Errori HTTP 500 durante la configurazione delle credenziali API
Se riscontri un errore HTTP 500 durante la configurazione delle credenziali API WhatsApp, segui questi passaggi per la risoluzione dei problemi:
-
Verifica diritti: verifica che sia stato eseguito il provisioning di
cjm_whatsappdiritti per la tua organizzazione. Senza questo diritto, il canale WhatsApp non può essere configurato. -
Convalida campi account aziendale: verificare che tutti i campi obbligatori siano compilati correttamente:
- Token API: deve essere un token di accesso Meta valido con le autorizzazioni appropriate. Ulteriori informazioni
- ID account aziendale: deve corrispondere esattamente all’ID account aziendale Meta. Ulteriori informazioni
-
Verifica le credenziali esternamente: verifica le credenziali direttamente con l’API Meta per verificare se il problema riguarda le credenziali o la gestione delle credenziali Journey Optimizer.
-
Abilita registrazione avanzata: per identificare errori di configurazione interni del server o di autenticazione, abilita i registri avanzati nell’ambiente Journey Optimizer per fornire informazioni dettagliate sugli errori di chiamata API.
-
Contatta il supporto: se l’ambiente e le adesioni sono confermate valide, ma l’errore HTTP 500 persiste, contatta il rappresentante Adobe.
Video introduttivo video
Il video seguente mostra come impostare il canale WhatsApp in Adobe Journey Optimizer.
This section contains structured knowledge intended to support interpretation, retrieval, and question answering related to this topic.
For complete understanding, this information should be combined with the documentation on this page. Neither source is intended to stand alone; the page describes the feature, while this section provides additional context that helps disambiguate terminology, intent, applicability, and constraints.
- TL;DR: This page explains how a System Administrator configures the WhatsApp channel in Journey Optimizer by creating WhatsApp API credentials, a Webhook, and a channel configuration to connect a WhatsApp Business account.
Intents:
- Create WhatsApp API credentials and connect a WhatsApp Business Account
- Create a WhatsApp Webhook to capture inbound responses, receive delivery reports, and enable tracking events
- Create a WhatsApp channel configuration and associate marketing actions and consent policies
- Set the sender phone number and WhatsApp Execution Field for a configuration
- Troubleshoot HTTP 500 errors during API credential setup
Glossary:
- API Credentials: The credential set (API Token and Business Account ID) used to connect Journey Optimizer to a WhatsApp Business Account (product-specific)
- API Token: A Meta access token from a System User in the same Business Manager as your WhatsApp assets, used to authenticate (product-specific)
- Business Account ID: Your Meta Business portfolio ID (Business Manager ID), not the WhatsApp Business Account ID (product-specific)
- Webhook: The communication bridge between Meta’s WhatsApp Business Platform and Journey Optimizer that receives real-time notifications about message events and user interactions (product-specific)
- Inbound keyword category: The classification (Opt-in, Opt-out, Help, Default) that determines which auto-response is sent based on user text (product-specific)
- WhatsApp Execution Field: The field used to select, among profile attributes, the phone number to use in priority when several numbers are available (product-specific)
- Quality Rating: A rating (Green/High, Yellow/Medium, Red/Low) reflecting customer feedback on messages sent in the past 24 hours (product-specific)
- Throughput: The rate at which your phone number can send messages (product-specific)
Guardrails:
- These steps must be performed by a Journey Optimizer System Administrator.
- Meta tokens expire after about 60 days; renew the token before it lapses.
- The API Token’s System User needs whatsapp_business_management, whatsapp_business_messaging, and business_management permissions, plus asset-level access to your WhatsApp Business Account.
- Meta allows only one webhook, callback URL, and Verify Token per WhatsApp Business Account, even across multiple sandboxes or WhatsApp credentials.
- Feedback events (Sent, Delivered, Read, Error, button click) are captured correctly in every sandbox, but inbound events (replies, opt-in/opt-out/help keywords) are only received in the single sandbox where the webhook is registered; register it against your production sandbox to receive inbound events there.
- Without specified opt-in or opt-out keywords, standard consent messages are not enabled.
- A profile must have at least one message sent from Journey Optimizer before incoming messages are captured in the dataset.
- Keywords are not case-sensitive (e.g., stop and STOP are treated the same).
- Configuration names must begin with a letter (A-Z), can only contain alpha-numeric characters, and may also use underscore, dot, and hyphen.
- Do not include a ‘+’ sign before the sender phone number, as this can prevent the opt-out flow from working correctly.
- HTTP 500 troubleshooting: the organization must have the
cjm_whatsappentitlement provisioned; without it, the WhatsApp channel cannot be configured.
Terminology:
- Canonical name: WhatsApp channel configuration — Acronym: n/a — variants: channel configuration, WhatsApp configuration
- Synonyms: “Business Account ID” = “Meta Business portfolio ID” = “Business Manager ID”
- Do not confuse: “Business Account ID” (Meta Business portfolio / Business Manager ID) ≠ “WhatsApp Business Account ID” (not entered in this field)
- Do not confuse: “API Credentials” ≠ “Webhook” ≠ “channel configuration” (three distinct setup steps)
- Do not confuse: “Processing” (status while checks run) ≠ “Active” (status once checks are successful and the configuration is ready to deliver)
FAQ:
- Q: What are the steps to configure the WhatsApp channel? — Create WhatsApp API credentials, create a WhatsApp Webhook, then create a WhatsApp channel configuration.
- Q: Who can configure the WhatsApp channel? — A Journey Optimizer System Administrator.
- Q: How often do Meta tokens expire? — About every 60 days; renew the token before it lapses.
- Q: Why are my inbound events missing in some sandboxes? — Meta allows only one webhook per WhatsApp Business Account, so inbound events are only received in the sandbox where the webhook is registered; register it against your production sandbox.
- Q: What does the channel configuration status mean? — It shows Processing while checks run and becomes Active once checks are successful, meaning it is ready to deliver messages.
- Q: What causes an HTTP 500 error during API credential setup? — Possible causes include a missing
cjm_whatsappentitlement, invalid or mismatched API Token or Business Account ID, or credential handling issues; verify entitlements and fields, test credentials with Meta, enable advanced logging, and contact support if it persists. - Q: Why should I not add a ‘+’ before the sender phone number? — It can prevent the opt-out flow from working correctly.