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.
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.- Chiama senza
before. - Se
pagination.has_moreètrue, richiama conbeforeuguale apagination.next_before, mantenendo gli stessisearch,tageview. - Ti fermi quando
has_moreèfalse(in quel casonext_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.