Passa al contenuto principale

Canali di Messaggistica

Il Qlara Partner Gateway supporta tre canali, ciascuno con diverse capacità e raggiungimento. Comprendi i punti di forza di ciascuno per scegliere il canale giusto per il tuo caso d'uso.

SMS​

Il canale più affidabile e universale.

Invia messaggi di testo a qualsiasi telefono mobile nel mondo. SMS non richiede approvazione o template — semplicemente invia.

Quando Utilizzare SMS​

  • Raggiungimento massimo (funziona su ogni telefono)
  • Messaggi semplici, solo testo
  • Avvisi e conferme transazionali
  • Canale di backup per altre piattaforme

Caratteristiche​

  • Solo testo semplice (nessun rich media)
  • Nessuna approvazione di template richiesta
  • Consegna istantanea (tipicamente entro pochi secondi)
  • Capace di bidirezionalità (ricevi risposte)
  • Funziona su ogni telefono a livello globale
  • Costo per messaggio più basso

Endpoint: POST /message-server/sms/send

RCS (Rich Communication Services)​

Rich media su dispositivi Android.

RCS fornisce messaggi migliorati con immagini, pulsanti e elementi interattivi su Android. Richiede approvazione di template. Fallback a SMS su dispositivi non supportati.

Quando Utilizzare RCS​

  • Raggiungi utenti Android con contenuti rich
  • Pulsanti interattivi e risposte rapide
  • Immagini e media nei messaggi
  • Engagement più alto di SMS

Caratteristiche​

  • Rich media (immagini, video, pulsanti)
  • Approvazione di template richiesta
  • Consegna solo su dispositivi Android (fallback SMS su altri)
  • Capace di bidirezionalità
  • Costo moderato (tra SMS e WhatsApp)
  • Engagement più alto di SMS

Endpoint: POST /message-server/rcs/send

Requisiti di Template​

I messaggi RCS devono utilizzare template pre-approvati. I template includono:

  • Corpo del messaggio con placeholder per variabili
  • Media opzionale (immagini, video)
  • Pulsanti d'azione opzionali
  • Opzioni di risposta rapida

Contatta il supporto per inviare template per l'approvazione.

WhatsApp​

Raggiungimento premium con engagement massimo.

Invia messaggi via WhatsApp utilizzando template approvati da Meta. I messaggi liberi sono consentiti entro 24 ore dall'interazione con il cliente. Engagement più alto e capacità di conversazione bidirezionale.

Quando Utilizzare WhatsApp​

  • Comunicazioni cliente premium
  • Richiedi tassi di engagement alti
  • Supporto e servizio clienti
  • Conversazioni bidirezionali
  • Messaggi rich media a utenti che si impegnano attivamente

Caratteristiche​

  • Rich media (immagini, video, documenti)
  • Approvazione di template richiesta (da Meta)
  • Messaggi liberi entro finestra di 24 ore dopo contatto cliente
  • Tassi di engagement più alti
  • Messaggistica bidirezionale con cliente
  • Costo per messaggio più alto
  • Richiede consenso cliente

Endpoint: POST /message-server/whatsapp/send

Finestra di 24 Ore​

Dopo che un cliente ti invia un messaggio su WhatsApp, hai 24 ore per rispondere con messaggi liberi (non-template). Dopo 24 ore, devi utilizzare un template approvato.

Confronto delle Funzionalità​

FunzionalitàSMSRCSWhatsApp
Rich MediaNoSìSì
TemplateNon richiestoRichiestoRichiesto
Processo di ApprovazioneNessunoRevisione operatoreRevisione Meta
Supporto DispositiviTutti i telefoniSolo AndroidTutte le piattaforme
BidirezionaleSìSìSì
Raggiungimento~100%~70% (Android)~60% (opt-in)
CostoBassoMedioAlto
Tasso di EngagementBassoMedioAlto
Finestra Libera 24hN/ANoSì

Scegliere il Canale Giusto​

Inviare a Tutti?​

Usa SMS. Raggiunge ogni telefono senza approvazioni.

Rich Content per Android?​

Usa RCS. Ha fallback a SMS automatico su dispositivi non supportati.

Engagement Premium?​

Usa WhatsApp. Engagement più alto, conversazioni bidirezionali, rich media.

Massimizzare Raggiungimento?​

Usa la Catena di Fallback: WhatsApp → RCS → SMS. Prova WhatsApp per primo; se fallisce, tenta automaticamente RCS; se anche quello fallisce, usa SMS. Vedi la configurazione del fallback sotto.

Catena di Fallback Automatica​

L'API Qlara può automaticamente fare fallback tra canali se la consegna fallisce:

  1. Prova WhatsApp (se approvato)
  2. Se la consegna WhatsApp fallisce → Prova RCS
  3. Se la consegna RCS fallisce → Usa SMS

Per abilitare il fallback, includi fallback: true nella tua richiesta (dove supportato). Il sistema tenterà ogni canale in ordine fino a che uno non avrà successo.

Richiesta di esempio con fallback:

{
  "phoneNumber": "+393901234567",
  "message": "Important update",
  "fallback": true,
  "templateId": "template_123"
}

Questa singola richiesta tenterà WhatsApp, poi RCS, poi SMS automaticamente.

Tracciamento della Consegna​

Ogni canale supporta il tracciamento della consegna in tempo reale.

Metodo Webhook (Consigliato) Ricevi notifiche istantanee quando lo stato cambia. Vedi Guida Webhook.

Metodo Polling Verifica manualmente lo stato in qualsiasi momento. Vedi Guida Webhook per l'endpoint di polling.

Passaggi Successivi​

  • Quick Start — Invia il tuo primo messaggio
  • Webhook — Configura il tracciamento della consegna
  • Campagne — Invia a più destinatari

Hai domande sulla selezione del canale? Contatta support@agiletelecom.com.