Passa al contenuto principale

Invio messaggio RCS

POST 

/message-server/rcs/send

Invia un messaggio RCS. Il contenuto può essere:

  • Un body inline (body) con tipo TEXT, CARD o CAROUSEL
  • Un template (templateId)

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

Fallback: Se il messaggio non può essere consegnato via RCS, il sistema può effettuare il fallback su WhatsApp e/o SMS. I fallback fanno parte del contenuto RCS: con un body inline imposta fallbackSms (RCS → SMS) ed eventualmente fallbackWhatsApp (RCS → WhatsApp → SMS) dentro body.body; con templateId valgono i fallback salvati nel template. Se fallbackWhatsApp è presente, fallbackSms è obbligatorio. Il fallback WhatsApp si applica solo se il tuo account supporta l'invio multicanale; altrimenti viene ignorato.

Un campo maxSmsParts, se inviato, viene ignorato: l'SMS di fallback viene diviso in tutte le parti che il suo testo richiede.

Richiesta​

Risposte​

Richiesta accettata. Controlla results.rcs.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.

Se il contenuto ha dei fallback, results contiene anche whatsapp e/o sms: quei messaggi vengono preparati subito e inviati solo se il canale precedente fallisce. In questo caso results.rcs.accepted è 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.