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:
Richiesta
Python
Risposta
200 OK
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 questoid 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.