Passa al contenuto principale

Iniziare con Qlara Partner Gateway

Benvenuto nel Qlara Partner Gateway — la tua piattaforma unificata per la messaggistica multi-canale. Invia messaggi SMS, RCS e WhatsApp attraverso una singola REST API, gestisci contatti e campagne, e monitora le consegne in tempo reale.

Cosa puoi fare

Il Qlara Partner Gateway ti consente di:

  • Messaggistica multi-canale: Raggiungi i clienti via SMS, RCS o WhatsApp da un singolo endpoint API
  • Gestione campagne: Crea, pianifica e monitora campagne su larga scala
  • Gestione contatti: Archivia e organizza liste di clienti
  • Monitoraggio della consegna in tempo reale: Monitora lo stato dei messaggi istantaneamente tramite webhook o polling
  • Conversazioni bidirezionali: Ricevi risposte e costruisci flussi di lavoro interattivi
  • Template: Template di messaggistica pre-approvati per conformità e velocità

URL Base

Tutte le richieste API vanno a:

https://lora-api.agiletelecom.com/api

Autenticazione

Sono disponibili due metodi di autenticazione. API Key è consigliata per la maggior parte dei casi d'uso.

API Key (Consigliato)

  • Includi la API key nell'header X-Api-Key
  • Nessuna scadenza; rigenerare se compromessa
  • Vedi Guida Autenticazione per esempi

Autenticazione di Base

  • Codifica le credenziali in base64
  • Alternativa se le API key non sono adatte
  • Vedi Guida Autenticazione per la configurazione

Entrambi i metodi supportano il Whitelist IP opzionale come livello di sicurezza aggiuntivo.

Canali di Messaggistica

SMS

Raggiungimento universale, nessuna approvazione di template richiesta. Ogni telefono mobile riceve SMS.

RCS (Rich Communication Services)

Consegna di rich media su dispositivi Android. Richiede approvazione di template. Fallback a SMS su dispositivi non supportati.

WhatsApp

Template approvati da Meta e finestra di messaggistica di 24 ore. Raggiungimento premium con funzionalità avanzate.

Catena di Fallback di Sistema I messaggi tentano la consegna in questo ordine: WhatsApp → RCS → SMS. Se la consegna WhatsApp fallisce, il sistema tenta automaticamente RCS, poi SMS.

Vedi Canali di Messaggistica per il confronto delle funzionalità e la guida alla selezione.

Concetti Essenziali

Canali
SMS, RCS e WhatsApp sono i canali disponibili. Ciascuno ha diverse capacità e requisiti di approvazione.

Contatti e Liste
Archivia numeri di telefono e attributi dei clienti. Organizza in liste per campagne di massa.

Campagne
Invia messaggi a più contatti secondo una pianificazione. Monitora i costi e le analitiche di consegna durante il ciclo di vita della campagna.

Webhook
Notifiche in tempo reale quando lo stato del messaggio cambia. Gli webhook inviano gli eventi di consegna al tuo server mentre si verificano.

Template
Contenuto di messaggistica pre-formattato approvato da operatori o piattaforme. Richiesto per RCS; opzionale ma consigliato per SMS e WhatsApp.

Passaggi Successivi

  1. Quick Start — Invia il tuo primo messaggio in 3 minuti
  2. Autenticazione — Autentica in modo sicuro le richieste API
  3. Canali di Messaggistica — Comprendi le capacità e la portata
  4. Webhook — Configura il monitoraggio della consegna in tempo reale
  5. Campagne — Gestisci la messaggistica su larga scala

Pronto a inviare il tuo primo messaggio? Vai a Quick Start.