Passa al contenuto principale

Invia messaggio WhatsApp

POST 

/message-server/whatsapp/send

Invia un messaggio WhatsApp. Il contenuto può essere:

  • Un template approvato da Meta (template)
  • Un messaggio libero (body) — solo nella finestra 24h dall'ultimo messaggio dell'utente

I campi template e body sono mutuamente esclusivi: uno dei due è obbligatorio.

Fallback: Se il messaggio non può essere consegnato via WhatsApp, si può configurare il fallback su RCS (fallbackRcs) e/o SMS (fallbackSms). I fallback si applicano solo se il tuo account supporta l'invio multicanale; altrimenti vengono ignorati.

Link tracciati: Per i template con {shortLinkT1} nel body, inserisci il placeholder shortLinkT1 nella mappa placeholders con l'URL di destinazione. I bottoni URL dei template creati con trackButtonLinks: true sono tracciati automaticamente: non serve passare nulla.

Richiesta​

Risposte​

Richiesta accettata. Controlla results.whatsapp.accepted per verificare se il messaggio è stato accettato.

Nota: accepted: true significa che il messaggio è stato accettato per l'invio, non che è stato consegnato. La conferma di consegna arriva tramite webhook.

Con i fallback, results contiene anche rcs e/o sms: quei messaggi vengono preparati subito e inviati solo se il canale precedente fallisce. In questo caso results.whatsapp.accepted e results.rcs.accepted sono sempre true e solo l'SMS può essere rifiutato in questa fase. I risultati dei canali non coinvolti sono omessi, così come reasons quando il messaggio è accettato.