Configurazione dei webhook
Attiva l'iscrizione ai webhook per ricevere notifiche in caso di variazioni relative alle impostazioni del tuo account WhatsApp Business e ai segnali di qualità.
La configurazione dei webhook non influirà sul numero di telefono sull'app WhatsApp Business, ma dopo aver eseguito la migrazione del numero alla piattaforma WhatsApp Business non potrai più utilizzarlo sull'app WhatsApp Business.
Creazione di un endpoint
Per iniziare a ricevere le notifiche, dovrai creare un endpoint sul server.
L'endpoint deve essere in grado di elaborare due tipi di richieste HTTPS: richieste di verifica e notifiche per l'evento. Poiché entrambe le richieste utilizzano HTTPs, il server deve disporre di un certificato TLS o SSL valido configurato e installato in modo corretto. I certificati autofirmati non sono supportati.
Maggiori informazioni sulle richieste di verifica e sulle notifiche per l'evento 
Iscrizione per i webhook
Per attivare l'iscrizione per i webhook, dovrai ottenere un ID dell'app di Meta e le autorizzazioni. Per farlo, accedi alla Dashboard gestione app di Meta. A questo punto, esegui le operazioni seguenti:
- Crea un'app di Meta nella Dashboard gestione app di Meta .
- Aggiungi il prodotto Webhooks all'app di Meta nella Dashboard gestione app .
In ogni momento, qualsiasi app Meta può avere un solo endpoint configurato. Se devi inviare aggiornamenti dei webhook a più endpoint, hai bisogno di più app Meta.
Quando sei pronto per estendere la portata della messaggistica aziendale, potrebbe essere necessario:
- Aggiungere l'autorizzazione
whatsapp_business_management alla tua Dashboard gestione app.
- Completare correttamente l'analisi dell'app di Meta : questo passaggio richiederà tempo, ma puoi continuare a eseguire test durante l'intero processo di analisi.
Campi relativi all'iscrizione disponibili
Campi relativi all'iscrizione disponibili
| Nome del campo | Descrizione |
|---|---|
| Ricevi una notifica quando viene completato il controllo di un account WhatsApp Business. |
| Ricevi una notifica in caso di modifica al tuo account WhatsApp Business. Le modifiche possono includere aggiornamenti del numero di telefono, violazioni delle normative, ban dell'account WhatsApp Business e altro ancora. |
| Ricevi una notifica in caso di aggiornamento di una funzionalità. Questo può includere la modifica del numero massimo di numeri di telefono che un account WhatsApp Business può avere o di conversazioni per numero di telefono. |
| Ricevi una notifica in caso di approvazione, rifiuto o disabilitazione del modello di messaggio. |
| Ricevi una notifica quando la tua azienda riceve un messaggio da un cliente, quando invii un messaggio a un cliente, quando viene consegnato un messaggio a un cliente e quando il tuo messaggio viene letto dal cliente. |
| Ricevi una notifica in caso di approvazione o rifiuto del nome associato a un numero di telefono. |
| Ricevi una notifica in caso di aggiornamento dello stato associato alla qualità di un numero di telefono. |
| Ricevi una notifica nei seguenti casi: |
Consulta il riferimento per i webhook dell'account WhatsApp Business per maggiori informazioni su ciascun campo di payload e il riferimento per i webhook dell'API Cloud di WhatsApp per maggiori informazioni sui diversi tipi di notifiche messages che puoi ricevere.
Payload di notifica
Tutte le notifiche hanno il seguente formato generico:
[{
"object": "whatsapp_business_account",
"entry": [{
"id": "{whatsapp-business-account-id}",
"time": {unix-timestamp},
"changes": [{
"field": "{subscribed-field}",
"value": {
# Information that was update
}
}]
}]
}]L'array di primo livello contiene due oggetti principali:
| Parametro | Descrizione |
|---|---|
Questo è l'oggetto per cui è stata attivata l'iscrizione. | |
Questo oggetto contiene i dettagli della modifica che ha attivato la chiamata al webhook. |
Consulta Componenti per tutti gli oggetti webhook disponibili.