Skip to main content

POST /v1/whatsapp/campaigns/{id}/recipients

Aggiunge destinatari a una campagna in bozza. Si chiama più volte, a blocchi di fino a 1000 destinatari, fino a un massimo di 10.000 per campagna. Dopo il lancio l’elenco non si modifica più. La chiamata si può ripetere senza problemi: un numero già presente nella campagna non si duplica, vale la prima volta che l’hai mandato. Se un blocco va in errore di rete, rimandalo intero.

Parametri

Request Body

Ogni destinatario:
Il body di una richiesta non può superare 64 KB. Mille destinatari con il solo telefono ci stanno; con nome e variabili un blocco da 1000 può superare il limite e ricevere 413 body_too_large. In quel caso usa blocchi da 500.

Richiesta

Con molti contatti, manda blocchi uno dopo l’altro:
Python

Risposta

200 OK
In questo esempio Mario e Giulia sono stati aggiunti, il terzo numero aveva chiesto di non ricevere promozioni ed è entrato come escluso, il quarto è stato scartato.

Campi della risposta

Motivi di scarto (invalid[].reason)

Un destinatario scartato non blocca gli altri: correggilo e rimandalo in un’altra chiamata.
Chi ha chiesto di non ricevere più promozioni viene escluso anche se l’hai mandato: non serve filtrarlo prima. Al momento dell’invio la campagna ricontrolla gli STOP e la regola Limite per contatto (in MyFlow → Impostazioni → Regole di invio): chi ha già ricevuto una promozione nei giorni indicati viene saltato.

Errori

404 - campaign_not_found

Non c’è una campagna con questo id su questo account.

409 - campaign_not_draft

La campagna è già stata lanciata, o annullata: i destinatari si aggiungono solo a una bozza.

422 - invalid_recipients

recipients manca, è vuoto, non è una lista o ha più di 1000 elementi. Gli errori comuni a tutte le rotte sono nell’introduzione.