Passa al contenuto principale

Ottieni lo stato del messaggio RCS

GET 
/api/partner-gateway/v1/rcs/messages/:messageId

Restituisce lo stato di consegna attuale di un messaggio RCS (Rich Communication Services) identificato dal suo messageId. Usa questo endpoint per monitorare il ciclo di vita di uno specifico messaggio RCS dopo l'invio. Il messageId è l'identificatore restituito nella risposta quando hai inviato il messaggio tramite l'endpoint di invio RCS. Memorizza questo identificatore dalla tua parte al momento dell'invio, così da poterne interrogare lo stato in seguito. Stati di consegna RCS e relativi significati: DELIVERED - la piattaforma RCS ha confermato che il messaggio è stato consegnato correttamente al dispositivo del destinatario. Si tratta di una ricevuta di consegna affidabile fornita dall'infrastruttura RCS, che conferma che il messaggio è arrivato sul telefono. Nota che, a differenza di WhatsApp, l'RCS standard non riporta le conferme di lettura tramite questa API, quindi readDate resta null. ERROR - il messaggio non è stato consegnato. Le cause comuni includono: il carrier ha rifiutato il messaggio, l'agent ID non è registrato correttamente oppure il numero di destinazione non è valido. Valuta di implementare una strategia di fallback via SMS quando la consegna RCS non va a buon fine. DISABLED - il destinatario ha RCS disattivato. UNSUPPORTED - il dispositivo o il numero del destinatario non supporta RCS. EXPIRED - il messaggio ha superato la sua finestra time-to-live senza essere consegnato ed è stato scartato dal carrier. Può accadere quando il dispositivo del destinatario resta offline per un periodo prolungato. UNKNOWN - non è disponibile alcuna informazione di stato, perché il carrier non ha restituito una ricevuta di consegna oppure perché il messaggio è ancora in fase di elaborazione. RCS 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. La disponibilità di RCS dipende dal supporto del carrier e dal fatto che il destinatario abbia un dispositivo compatibile con RCS e con RCS attivato. Se ti serve una consegna garantita, valuta di abbinare agli invii RCS un fallback via SMS, controllando lo stato dopo un timeout ragionevole e reinviando via SMS se lo stato è ERROR o EXPIRED. Questo endpoint è una scorciatoia per singolo canale sulla stessa fonte dello stato di consegna di GET /partner-gateway/v1/messages/status/{customerMessageId}?channel=RCS, 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.

Richiesta​

Risposte​

Stato del messaggio recuperato con successo

Ultimo aggiornamento il