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.
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.
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 ininvalid. 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.