Invia messaggi WhatsApp Business e gestisci template.
Ottieni lo stato del messaggio WhatsApp
Restituisce lo stato di consegna attuale di un messaggio WhatsApp Business identificato dal suo messageId. Usa questo endpoint per monitorare l'intero ciclo di vita di un messaggio WhatsApp dopo l'invio, inclusa la verifica che il destinatario lo abbia letto. Il messageId è l'identificatore restituito nella risposta quando hai inviato il messaggio tramite l'endpoint di invio WhatsApp. Memorizza questo identificatore dalla tua parte al momento dell'invio, così da poterne interrogare lo stato in seguito. Stati di consegna WhatsApp e relativi significati: DELIVERED - i server di WhatsApp hanno confermato che il messaggio è stato consegnato al dispositivo del destinatario. Corrisponde alla doppia spunta grigia nell'interfaccia di WhatsApp. Il destinatario potrebbe non aver ancora aperto la conversazione. La lettura non è uno stato a sé: quando il destinatario apre la conversazione — la doppia spunta blu nell'interfaccia di WhatsApp — viene valorizzato il campo readDate, mentre deliveryStatus resta DELIVERED. Tra i canali supportati, le conferme di lettura sono un'esclusiva di WhatsApp, e i destinatari possono disattivarle nelle impostazioni della privacy: in tal caso readDate resta null anche dopo che il messaggio è stato letto. ERROR - il messaggio non è stato consegnato. Le cause comuni includono: il numero di telefono del destinatario non è registrato su WhatsApp, l'account WhatsApp Business è stato limitato o bannato, il template del messaggio è stato rifiutato oppure il numero di destinazione non è valido. Controlla i dettagli della risposta per il motivo specifico dell'errore. CONVERSATION_CLOSED - la finestra di assistenza clienti di 24 ore si era chiusa, quindi non è stato possibile inviare un messaggio non basato su template. DISABLED - il destinatario ha disattivato la ricezione di messaggi WhatsApp dalle aziende. UNSUPPORTED - il numero del destinatario non supporta il messaggio inviato. EXPIRED - il messaggio non è stato consegnato entro la finestra temporale consentita ed è stato scartato. Può accadere quando il dispositivo del destinatario resta offline per un periodo prolungato. UNKNOWN - WhatsApp non fornisce alcuna informazione di stato, il che può indicare che il messaggio è ancora in fase di elaborazione o che la callback di stato non è stata ricevuta. WhatsApp non ha uno stato distinto per i messaggi in transito, quindi un messaggio ancora in attesa della prima ricevuta risulta UNKNOWN. La tabella Stati di Consegna nella panoramica dell'API elenca il codice numerico che il webhook di consegna invia per ciascuno di questi stati. Considerazioni specifiche per WhatsApp: WhatsApp impone una finestra di assistenza clienti di 24 ore. Al di fuori di questa finestra puoi inviare solo messaggi template pre-approvati. L'invio di un messaggio non basato su template al di fuori della finestra produrrà uno stato CONVERSATION_CLOSED. Inoltre, WhatsApp applica limiti di frequenza e valutazioni di qualità che possono influire sulla consegna. Questo endpoint è una scorciatoia per singolo canale sulla stessa fonte dello stato di consegna di GET /partner-gateway/v1/messages/status/{customerMessageId}?channel=WHATSAPP, che restituisce lo stesso identico payload e può cercare anche gli SMS — preferisci quest'ultimo quando monitori più di un canale. Risposte di errore: viene restituito 401 se la chiave API è mancante o non valida. Viene restituito 404 se il messageId non esiste o non appartiene all'azienda autenticata.
List WhatsApp phone numbers
Restituisce un elenco paginato dei numeri di telefono WhatsApp Business associati all'azienda autenticata.
Get a WhatsApp phone number
Retrieves a single WhatsApp Business phone number by its ID.