Passa al contenuto principale

Gestione Campagne

Le campagne ti permettono di inviare un messaggio a un'intera lista di contatti in un'unica operazione. L'API supporta campagne SMS, RCS e WhatsApp con programmazione, stima costi e statistiche di consegna.

Ciclo di vita della campagna​

Ogni campagna attraversa queste fasi:

Bozza  →  Configurata  →  Costo calcolato  →  Confermata / Programmata  →  In invio  →  Completata

1. Crea una campagna (Bozza)​

POST /campaigns

Fornisci il canale (SMS, RCS o WhatsApp), il contenuto del messaggio e la lista di contatti target. La campagna inizia nello stato Bozza.

2. Configura il messaggio​

Aggiorna la campagna con PUT /campaigns/{id} per perfezionare il contenuto del messaggio, selezionare un template diverso o cambiare il pubblico target.

3. Stima il costo​

POST /campaigns/{id}/calculateGoal

Prima di confermare, calcola il consumo di crediti previsto. L'API restituisce il prezzo totale basato sul numero di destinatari e le tariffe del canale.

Puoi anche controllare il prezzo in qualsiasi momento con:

GET /campaigns/{id}/price

4. Conferma o programma​

PUT /campaigns/{id}/confirm
  • Invio immediato: La campagna inizia l'invio subito.
  • Programmazione: Fornisci una data/ora futura per inviare la campagna più tardi.

5. Monitora la consegna​

Traccia l'avanzamento della campagna:

  • GET /campaigns/{id} -- Dettagli della campagna inclusi i conteggi di consegna.
  • GET /campaigns/stats -- Statistiche aggregate tra le campagne (filtra per intervallo di date e canale).

Gestione delle campagne​

AzioneEndpoint
Elenco campagneGET /campaigns
Dettagli campagnaGET /campaigns/{id}
Crea campagnaPOST /campaigns
Aggiorna campagnaPUT /campaigns/{id}
Calcola costoPOST /campaigns/{id}/calculateGoal
Ottieni prezzoGET /campaigns/{id}/price
Conferma / programmaPUT /campaigns/{id}/confirm
Elimina campagnaDELETE /campaigns/{id}
StatisticheGET /campaigns/stats

Suggerimenti​

  • Stima sempre il costo prima di confermare. Questo aiuta a evitare deduzioni di crediti inaspettate.
  • Usa le liste di contatti per segmentare il tuo pubblico. Puoi creare e gestire le liste tramite la guida Contatti e Liste.
  • Controlla le statistiche di consegna dopo l'invio per capire l'engagement e risolvere eventuali consegne fallite.

Consulta il Riferimento API Campagne per la documentazione completa degli endpoint.