Metriche WhatsApp
La pagina Metrics, in WhatsApp > Metrics, mostra le analisi WhatsApp del tuo spazio di lavoro per tutti gli invii e le risposte in entrata. Per controllare un singolo messaggio, usa invece il log WhatsApp. Per accedere alla pagina, il tuo ruolo nello spazio di lavoro deve avere sia l'accesso in lettura a WhatsApp sia l'accesso in lettura alle analisi.
Leggere le metriche
Intervallo, ambito e schede
- Outbound / Inbound: la scheda Outbound copre i messaggi che hai inviato. La scheda Inbound conta i messaggi ricevuti dai tuoi numeri, in totale e per numero.
- Range: ultime 24 ore, 7, 30 (predefinito) o 90 giorni. Puoi anche trascinare su un grafico per ingrandire.
- Scope: solo nella scheda Outbound, restringi la pagina a un singolo numero, template, categoria di template o tag, uno alla volta. Due parti della pagina ignorano l'ambito e coprono sempre l'intero spazio di lavoro: l'elenco dei codici di errore e il pannello Breakdowns.
I messaggi vengono conteggiati nel periodo in cui Bird li ha accettati, quindi una conferma di consegna che arriva oggi aggiorna i numeri di ieri. Le ore più recenti possono mostrare meno consegne di quelle che risulteranno una volta arrivate tutte le conferme.
Schede riepilogative
| Scheda | Mostra | Sano quando |
|---|---|---|
| Delivery rate | Messaggi consegnati come quota dei messaggi accettati | Sopra il 90% |
| Failure rate | Messaggi non riusciti come quota dei messaggi accettati | Sotto il 5% |
| Accepted | Messaggi accettati da Bird e quanti hanno raggiunto WhatsApp | Non valutato |
Una scheda fuori dal suo intervallo ottimale mostra Needs attention. Controlla le cause di fallimento per capire perché.
Consegna nel tempo
Il grafico mostra i messaggi accettati, consegnati e non riusciti per ora (intervallo di 24 ore) o per giorno (intervalli più lunghi). Usalo per individuare un picco, ad esempio dopo l'invio di una campagna o quando un template inizia a essere rifiutato.
Cause di fallimento
Il grafico del tasso di fallimento mostra l'andamento del tasso di fallimento nell'intervallo. Sotto il grafico, i fallimenti sono raggruppati per codice di errore, a partire dal più frequente. L'elenco mostra fino a 50 codici che si sono verificati nell'intervallo, quindi in un elenco lungo un codice raro può non comparire. I codici di errore coprono sempre l'intero spazio di lavoro, anche quando restringi l'ambito della pagina. L'ultima riga, Rejected, conta i messaggi che Bird ha rifiutato prima di accettarli. Questi messaggi non rientrano nel tasso di fallimento, quindi la riga mostra un conteggio senza percentuale.
Latenza
La tabella della latenza mostra i tempi p50, p95 e p99 per tre fasi:
- Processing: dall'accettazione del messaggio da parte di Bird al suo passaggio a WhatsApp.
- Delivery: dal passaggio a WhatsApp fino a quando WhatsApp conferma il recapito al dispositivo del destinatario.
- Total: entrambe le fasi insieme.
Una fase Delivery lenta di solito significa che i telefoni dei destinatari erano offline, cosa che Bird non può controllare. Una fase Processing lenta va invece indagata. Se il p50 è nella norma ma il p99 è lento, la causa è spesso un singolo template o una singola destinazione.
Suddivisioni
Il pannello Breakdowns suddivide i messaggi accettati, consegnati e non riusciti per number, template, template category, tag o country. Ogni riga è contrassegnata come Healthy o Needs attention in base alle stesse soglie delle schede riepilogative. Ogni scheda elenca le prime 50 righe dell'intervallo.
I tag sono quelli che imposti al momento dell'invio. Un messaggio con più tag compare nella riga di ciascuno di essi. I destinatari il cui paese non può essere identificato compaiono sotto ZZ, e gli invii di gruppo sono esclusi dalla scheda per paese.
Accesso programmatico
Gli stessi numeri sono disponibili tramite la API, gli SDK (bird.whatsapp.stats), la CLI (bird whatsapp stats) e il server MCP. Inizia da questi endpoint:
- Statistiche di riepilogo, giornaliere e orarie
- Suddivisioni per numero, template, categoria di template, tag, paese e codice di errore
- Statistiche in entrata: riepilogo, giornaliere, orarie e per numero
Ogni pagina di riferimento elenca gli intervalli di tempo accettati, i filtri e i campi della risposta.
Passi successivi
- Log WhatsApp: cercare un singolo messaggio
- Eventi di stato dei messaggi: gli eventi da cui derivano queste metriche
- Webhook di stato dei messaggi: ricevere ogni cambio di stato in tempo reale
Risorse correlate
Continua con la documentazione, le guide e gli esempi per questo argomento.