Skip to main content

GET /v1/whatsapp/contacts

Restituisce i contatti di MyFlow: le stesse persone della pagina MyFlow → Contatti del pannello. Serve al gestionale per allineare la propria anagrafica con chi scrive su WhatsApp, per esempio per un primo confronto tra i clienti del CRM e quelli di MyFlow, o per trovare chi ha un certo tag. Nell’elenco ci sono:
  • chi ha scritto almeno una volta a uno dei numeri WhatsApp collegati a MyFlow;
  • chi ha una scheda contatto, creata dal pannello o con PUT /v1/whatsapp/contacts/{phone}, anche se non ha mai scritto.
Chi ha solo ricevuto messaggi (una campagna, una notifica) e non ha mai risposto non compare, a meno che non abbia una scheda. La rubrica del telefono su cui gira l’app WhatsApp Business non viene esposta: contiene anche contatti personali che non sono mai diventati clienti. Ogni persona compare una volta sola, anche se ha scritto a più numeri dell’azienda: i numeri sono elencati in numbers.

Parametri

Il valore di ogni parametro può essere lungo al massimo 64 caratteri: uno più lungo viene ignorato come se non ci fosse.

Paginazione

I contatti sono ordinati per numero di telefono, in ordine crescente delle cifre. L’ordine è stabile, così le pagine non si sovrappongono anche se nel frattempo arrivano messaggi.
  1. Chiama senza before.
  2. Se pagination.has_more è true, richiama con before uguale a pagination.next_before, mantenendo gli stessi search, tag e view.
  3. Ti fermi quando has_more è false (in quel caso next_before è null).

Richiesta

Risposta

200 OK

Campi del contatto

Compleanno e date personalizzate non sono nell’elenco: si leggono con GET /v1/whatsapp/contacts/{phone}.

Campi della paginazione

Errori

400 - invalid_view

view non è all, named o unnamed.

400 - invalid_tag

Il tag non esiste su questo account. I tag esistenti sono in GET /v1/whatsapp/contacts/fields; quelli nuovi si creano dal pannello.

400 - invalid_cursor

before non è un valore di pagination.next_before (deve essere fatto di sole cifre, da 8 a 15). Riparti dalla prima pagina. Gli errori comuni a tutte le rotte sono nell’introduzione.