Skip to main content

POST /v1/whatsapp/contacts/bulk

Crea o aggiorna fino a 500 schede contatto in una sola chiamata. È pensata per il primo allineamento tra il gestionale e MyFlow, o per una sincronizzazione notturna: ogni elemento è trattato esattamente come un PUT /v1/whatsapp/contacts/{phone}, con le stesse regole e gli stessi limiti. Gli elementi sono indipendenti:
  • un elemento sbagliato viene scartato e finisce in invalid, con la sua posizione e il motivo;
  • tutti gli altri vengono salvati, prima e dopo quello sbagliato.
Non è quindi un «tutto o niente»: dopo la chiamata correggi solo gli elementi in invalid e rimandali.

Request Body

Il significato dei campi, la pulizia dei testi e la regola «assente = resta com’è, null = svuota» sono spiegati in Crea o aggiorna un contatto. I tag e le date dell’account si leggono con GET /v1/whatsapp/contacts/fields.
Per caricare più di 500 contatti, dividili in blocchi da 500 e mandali uno dopo l’altro, tenendo conto del limite di richieste al minuto. Il body di una richiesta può essere al massimo di 64 KB: con molti campi pieni, un blocco da 500 può superarlo, e in quel caso usa blocchi più piccoli.

Richiesta

Risposta

200 OK, anche quando alcuni elementi sono stati scartati: controlla sempre invalid.

Campi della risposta

Se lo stesso telefono compare due volte nel blocco, gli elementi vengono applicati in ordine: il primo crea (o aggiorna) la scheda, il secondo la aggiorna di nuovo e conta in updated. Una chiamata che salva almeno un contatto lascia una riga nel Log attività del pannello, con quante schede sono state create e quante aggiornate.

Errori

422 - invalid_contacts

contacts manca, non è un elenco, è vuoto o ha più di 500 elementi. In questo caso non viene salvato niente.

Elementi scartati

Gli errori di un singolo elemento non fanno fallire la richiesta: finiscono in invalid. Un elemento senza phone, o con phone che non è una stringa (per esempio un numero JSON), viene scartato con invalid_phone e il motivo manca "phone". Gli errori comuni a tutte le rotte sono nell’introduzione.