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
- 202
- 400
- 401
- 500
- 511
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.
Richiesta non valida. I campi che non superano la validazione sono elencati in data, una lista di messaggi per ogni oggetto non valido; un body illeggibile dà data: "Invalid request body". Un numero, template o agente RCS che il tuo account non può usare dà invece message e code.
Credenziali mancanti o non valide. Il corpo della risposta è vuoto.
Errore imprevisto durante la gestione del messaggio
L'indirizzo IP chiamante è fuori dagli intervalli IP configurati per il tuo account