Skip to main content

GET /v1/whatsapp/conversations/{phone}/messages

Restituisce i messaggi WhatsApp scambiati tra un tuo numero e un cliente, dal più recente al più vecchio, 50 alla volta. Ci sono i messaggi del cliente e tutti quelli partiti verso di lui: dall’Inbox, dall’app WhatsApp Business sul telefono, dall’agente AI, dalle risposte automatiche, dalle Campagne, dal centralino e dal gestionale. Per ognuno author dice chi l’ha scritto. Serve a mostrare nel gestionale la conversazione di un cliente, anche quella passata, o a recuperare i messaggi persi se il tuo server non ha ricevuto qualche webhook. La risposta dice anche se la finestra delle 24 ore è aperta, cioè se adesso puoi rispondere con un testo libero.

Parametri

Richiesta

Risposta

200 OK
Se con quel cliente non c’è nessuna conversazione da questo numero, la risposta è 200 con data vuoto e conversation null:

Campi del messaggio

Il messaggio ha lo stesso formato dentro i webhook message.received e message.sent.

Chi ha scritto: author

Campi di conversation

Paginazione

  • Le pagine sono di 50 messaggi, dal più recente.
  • Se pagination.has_more è true, ci sono messaggi più vecchi. Per leggerli ripeti la chiamata con before uguale a pagination.next_before.
  • next_before è un cursore opaco: usalo così com’è, senza calcolarlo.
  • I messaggi tecnici (modifiche, revoche, avvisi di sistema) non compaiono.

Errori

400 - invalid_phone

Il numero del cliente nell’indirizzo non è valido.

400 - invalid_cursor

before non è un cursore valido oppure appartiene a un’altra conversazione. Usa il valore di pagination.next_before restituito per questo stesso cliente e numero.

400 - number_required / invalid_from · 404 - number_not_found

from manca con più numeri, non è valido o non è collegato all’account. Vedi l’elenco dei template. Gli errori comuni a tutte le rotte sono nell’introduzione.