Il webhook phone_number_quality_update
phone_number_quality_update segnala le variazioni della capacità di invio e dei limiti di messaggistica per un numero. Nel 2026 non trasporta il rating di qualità verde, giallo o rosso, nonostante il nome: va letto direttamente dal numero.
L'anno in cui il contenuto di questo campo è cambiato e ha smesso di indicare il rating a colori.
I rating di qualità possibili per un numero: verde, giallo e rosso, nessuno dei quali arriva qui.
L'errore che un numero restituisce quando entra in vigore la limitazione dovuta alla qualità.
Cosa contiene davvero questo webhook?
Informazioni sulla capacità di invio e sui limiti di messaggistica, fornite come valore dell'evento insieme ai campi che contengono il limite attuale.
In pratica, il contenuto indica che la capacità di un numero è cambiata: è passato a un altro livello di messaggistica oppure il suo livello di invio è stato modificato. È utile registrare questi dati perché cambiano ciò che un'integrazione può fare e perché un livello che diminuisce è un segnale iniziale.
Non contiene invece, nonostante il nome del campo, il rating di qualità. Un gestore basato sulla documentazione precedente cercherà GREEN, YELLOW o RED qui senza trovare nulla, concludendo poi che la qualità non cambia mai.
Da dove arriva allora il rating a colori?
Dalla lettura diretta del numero, secondo una pianificazione.
Il campo quality_rating si trova sull'oggetto numero di telefono nella Graph API e deve essere verificato tramite polling, invece di aspettare un evento. Per questo il monitoraggio corretto di una connessione richiede sia un processo di polling sia un ricevitore di webhook: trasportano dati diversi e nessuno dei due è sufficiente da solo.
È anche il motivo per cui un calo della qualità rimane invisibile alla maggior parte delle integrazioni. Nulla lo invia, l'app WhatsApp Business non ne mostra alcun segnale e, quando restituisce l'errore 131048, gli invii interessati sono già falliti.
Errori comuni
- Cercare GREEN, YELLOW o RED in questo payload. Nel 2026 non sono presenti.
- Creare il monitoraggio basandosi solo sui webhook. Il rating di qualità deve essere verificato tramite polling.
- Ignorare una diminuzione del livello. Di solito è il primo segnale visibile di un problema.
EasyCoexistence verifica tramite polling il rating di qualità, il livello di messaggistica e la capacità di invio di ogni numero connesso, registrando ogni controllo: così un calo è visibile prima che faccia fallire un invio.
Domande frequenti
Perché il campo prende il nome dalla qualità?
Il nome risale a prima del cambiamento. È rimasto invariato mentre il contenuto è cambiato, ed è per questo che trae in inganno.
Con quale frequenza va verificato il rating?
Con una frequenza sufficiente a rilevare un calo prima che diventi una limitazione. Eseguiamo il polling secondo una pianificazione, non su richiesta.
L'app mostra il rating?
No. Nell'app WhatsApp Business sul telefono non è visibile alcuna informazione al riguardo.
131048 è collegato?
Sì. È l'errore che un numero inizia a restituire quando un rating basso porta a una limitazione.
Continua a leggere
Pronto per iniziare?
Configura WhatsApp Coexistence in pochi minuti, non in mesi. L'app continua a funzionare sul telefono.
Inizia la prova gratuitaVerificato il