POST /v1/whatsapp/campaigns/{id}/launch
Lancia una campagna in bozza, subito o a un’ora stabilita. Da questo momento la campagna non si modifica più: si può solo seguire e, se serve, annullare. Una campagna manda messaggi promozionali a molte persone, e Meta li fa pagare. Per questo il lancio chiede due dichiarazioni esplicite, le stesse che il pannello fa spuntare prima dell’invio: il consenso dei destinatari e la presa visione dei costi. Il gestionale deve mostrarle a chi lancia la campagna e mandarle solo se quella persona le ha accettate.Parametri
Request Body
Valgono solo i valori booleani
true: "true" tra virgolette o 1 non bastano.
Le due dichiarazioni
Questi sono i testi esatti che vengono registrati sulla campagna al momento del lancio. Consenso dei destinatari (consent):
Dichiaro che tutti i destinatari di questa campagna hanno dato il consenso a ricevere messaggi su WhatsApp da Studio Rossi Srl, come richiesto dal Regolamento UE 2016/679 (GDPR, artt. 6 e 7), dall’art. 130 del Codice Privacy (D.Lgs. 196/2003) e dalle regole di WhatsApp Business, e di poterlo dimostrare su richiesta.Al posto di «Studio Rossi Srl» c’è la ragione sociale dei dati di fatturazione dell’account. Se manca, c’è il nome del numero WhatsApp che invia; se manca anche quello, «la mia azienda». Costi di Meta (
costs):
So che ogni messaggio inviato ha un costo stabilito da Meta, addebitato da Meta sul metodo di pagamento collegato al mio account WhatsApp Business, e che MyCentralino non lo stabilisce né lo fattura.
Richiesta
Risposta
200 OK. La campagna passa allo stato scheduled, anche quando parte subito.
declarations riporta i testi registrati.
Cosa succede dopo il lancio
- Partenza. Senza
scheduled_atla campagna parte entro un paio di minuti, all’ora indicata se è programmata. A quel punto lo stato diventasending. - Fascia di invio. I messaggi partono solo nei giorni e negli orari della Fascia di invio dell’account (MyFlow → Impostazioni → Regole di invio, ora italiana). Fuori fascia la campagna resta
sending, aspetta, ereasonlo dice. Una campagna programmata alle 22:00 con la fascia 09:00-20:00 parte quindi il primo giorno utile alle 09:00. - Ritmo e limiti. L’invio procede a ritmo prudente e rispetta il limite giornaliero che Meta assegna al numero: con molti destinatari può durare più di un giorno.
- Esclusioni al momento dell’invio. Prima di ogni messaggio si ricontrolla chi ha chiesto di non ricevere promozioni (STOP) e la regola Limite per contatto. Gli esclusi finiscono in
skipped. - Fermate automatiche. Se Meta disattiva il template, il numero si scollega o troppi invii non riescono, la campagna passa a
stoppedcon il motivo inreason. I casi sono elencati in Dettaglio campagna. - Avviso al titolare. Il titolare dell’account riceve un’email con il nome della campagna, il numero di destinatari, quando parte e il nome della chiave API usata. La campagna compare in MyFlow → Campagne, dove si può mettere in pausa o annullare, e una riga va nel Log attività.
- STOP dei clienti. Chi risponde con STOP (o con parole come BASTA, CANCELLAMI, UNSUBSCRIBE) o tocca il pulsante di opt-out non riceve più promozioni da nessuno dei tuoi numeri, in nessuna campagna.
Cosa resta registrato
Sulla campagna resta la prova del lancio:- i due testi esatti delle dichiarazioni, con il nome dell’azienda;
- chi le ha fatte:
api:seguito dal nome della chiave API usata; - data e ora;
- l’indirizzo IP da cui il gestionale ha chiamato;
- una copia del template così com’era al lancio.
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. Si lancia solo una bozza: una seconda chiamata di lancio non fa niente e risponde così.503 - campaigns_disabled
L’invio delle campagne è momentaneamente sospeso. La bozza resta com’è: riprova più tardi.409 - number_not_found
Il numero che doveva inviare non è più collegato a MyFlow. Annulla la bozza e creane una nuova con un numero collegato.422 - declarations_required
Manca"consent": true o "costs": true. L’errore porta i due testi da mostrare all’utente:
422 - invalid_scheduled_at
scheduled_at non è nel formato YYYY-MM-DD HH:MM (niente secondi, niente T, niente fuso), è nel passato o oltre 60 giorni da adesso.
422 - no_recipients
La campagna non ha destinatari a cui inviare: nessuno, oppure sono tutti esclusi. Aggiungili conPOST /v1/whatsapp/campaigns/{id}/recipients.
