Passa al contenuto principale

Ottieni lo stato di consegna di più messaggi

GET 
/api/partner-gateway/v1/messages/status

Restituisce lo stato di consegna di più messaggi in una singola chiamata, il che è molto più efficiente che chiamare in un ciclo l'endpoint di stato singolo. Tutti gli ID forniti in una singola richiesta devono appartenere allo stesso canale (SMS, RCS o WHATSAPP). Se devi controllare messaggi su canali diversi, effettua una richiesta batch per canale. Fornisci i valori customerMessageId come stringa separata da virgole nel parametro query ids (ad esempio: ids=msg-001,msg-002,msg-003). Non includere spazi tra gli ID. Anche se non esiste un limite rigido al numero di ID, si consiglia di mantenere ogni batch sotto qualche centinaio di ID, per evitare query string eccessivamente lunghe e possibili errori HTTP 414 URI Too Long da parte di proxy o load balancer intermedi. Per ricerche molto grandi, suddividi gli ID in più richieste. La risposta è una lista non ordinata di oggetti DeliveryStatusResponse. Importante: gli ID che non corrispondono ad alcun messaggio noto per l'azienda autenticata e il canale specificato vengono omessi silenziosamente dai risultati. Ciò significa che l'array di risposta può contenere meno elementi del numero di ID che hai fornito. Se nessuno degli ID corrisponde, riceverai un array vuoto (HTTP 200 con una lista JSON vuota), non un 404. Per individuare i messaggi mancanti, confronta i valori customerMessageId restituiti con la tua lista originale. Ogni voce della risposta contiene gli stessi campi dell'endpoint di stato singolo, inclusi deliveryStatus (ACCEPTED, REJECTED, DELIVERED, EXPIRED, DELETED, UNDELIVERABLE, ERROR, DISABLED, UNSUPPORTED, CONVERSATION_CLOSED, UNKNOWN — vedi la tabella Stati di Consegna nella panoramica dell'API) e deliveryStatusDescription per i dettagli in forma leggibile. Risposte di errore: viene restituito 400 quando channel o ids mancano, o quando channel non è uno tra RCS, WHATSAPP, SMS. 500 indica un errore imprevisto lato server; riprova la richiesta dopo una breve attesa. Per la ricerca di un singolo messaggio, usa invece GET /partner-gateway/v1/messages/status/{customerMessageId}. Per una vista storica completa con paginazione e filtro per data, consulta GET /partner-gateway/v1/messages/history.

Richiesta​

Risposte​

Lista delle voci sullo stato di consegna (può essere vuota se nessuna trovata)

Ultimo aggiornamento il