Canali
Sette tipi di canale dietro un unico endpoint
OmniMessage è un gateway a cui porti i tuoi canali. Colleghi i mittenti che possiedi già, e ognuno viene indirizzato, tracciato e addebitato allo stesso modo.
Porta il tuo canale
Collega una sola volta, dalla console o tramite API
Un mittente collegato diventa un canale con un ID. Quell’ID è l’unico valore specifico del canale in una richiesta di invio.
Il mittente è tuo
Il numero, il bot o l’account è registrato a tuo nome presso il fornitore. Lasciare OmniMessage non significa lasciare il tuo mittente.
Due fatture separate
OmniMessage addebita una tariffa del gateway per ogni messaggio in uscita. Tutto ciò che Meta, Twilio o un altro fornitore applica per il canale ti viene fatturato direttamente da loro.
Accedi o incolla le credenziali
WhatsApp, Messenger e Instagram si autorizzano accedendo con Facebook dalla console, TikTok accedendo con TikTok. Telegram, SMS e SMS OTP richiedono delle credenziali, dalla console o tramite l’API, e lo stesso vale per un numero WhatsApp già attivo sulla Cloud API.
Le credenziali sono di sola scrittura
Token, codici e credenziali vengono passati al livello di consegna quando colleghi un canale. Il gateway non li memorizza e l’API non li restituisce mai.
curl https://api.omnimessage.co/v1/channels \
-H "Authorization: Bearer om_live_..." \
-H "Content-Type: application/json" \
-d '{
"type": "whatsapp",
"name": "Support line",
"identifier": "+971800123456",
"credentials": {
"wab_account_id": "...",
"phone_number_id": "...",
"access_token": "..."
}
}'{
"id": "ch_7Hq2mN5vB8cX1zL0pK3j",
"object": "channel",
"mode": "live",
"type": "whatsapp",
"name": "Support line",
"identifier": "+971800123456",
"status": "active",
"connection_status": "pending",
"capabilities": ["text", "attachments", "template", "button", "list", "location", "contacts", "cta_url"],
"created_at": "2026-10-01T08:00:00.000Z"
}Per WhatsApp, Telegram, SMS e SMS OTP. Richiede l’ambito channels:write. Iscriviti a channel.connected e channel.disconnected per seguire lo stato della connessione.
WhatsApp Business
Invia da un numero di telefono della WhatsApp Business Platform (Cloud API) di tua proprietà. OmniMessage inoltra i tuoi messaggi alla Cloud API e ti restituisce gli stati inviato, consegnato, letto e non riuscito.
0,001 $ per messaggio in uscita, oppure un credito di un pacchetto
- Che cosa ti serve
- Un accesso Facebook con accesso al tuo portfolio business di Meta. Continua con Facebook dalla console e Meta Embedded Signup configura l’account WhatsApp Business e il numero. Un numero già attivo sulla Cloud API può anche essere collegato con i suoi ID e un token di accesso di un utente di sistema, dalla console o tramite l’API.
- Credenziali API
wab_account_idphone_number_idaccess_token- Tipo di canale
whatsapp- Identificativo del mittente
- Numero di telefono del mittente in formato E.164, ad esempio
+971800123456. - Destinatario (
to) - Numero di telefono in formato E.164.
- Buono a sapersi
- Al di fuori della finestra di assistenza clienti di 24 ore, WhatsApp accetta solo messaggi basati su modelli approvati.
- Elenca i modelli approvati di un canale con
GET /v1/channels/:id/templates. - Le tariffe per conversazione di Meta vengono addebitate da Meta al tuo account WhatsApp Business. Sono separate dalla tariffa del gateway.
SMS
Invia SMS da un numero di telefono Twilio del tuo account Twilio. Usalo per notifiche, promemoria e conversazioni bidirezionali, con i messaggi in entrata consegnati al tuo webhook.
0,0005 $ per messaggio in uscita, oppure un credito di un pacchetto
- Che cosa ti serve
- Un account Twilio e un numero di telefono abilitato alla messaggistica.
- Credenziali API
account_sidphone_number_sidauth_token- Tipo di canale
sms- Identificativo del mittente
- Numero di telefono del mittente in formato E.164.
- Destinatario (
to) - Numero di telefono in formato E.164.
- Buono a sapersi
- Gli allegati multimediali dipendono da ciò che supportano il tuo numero e la rete di destinazione.
- Le tariffe degli operatori e di Twilio vengono addebitate da Twilio al tuo account Twilio. Sono separate dalla tariffa del gateway.
SMS OTP
Un tipo di canale dedicato ai codici di verifica. Accetta solo testo semplice, così un flusso di accesso non può inviare per errore nient’altro.
0,0005 $ per messaggio in uscita, oppure un credito di un pacchetto
- Che cosa ti serve
- Un account presso il tuo fornitore di SMS OTP e la relativa chiave API.
- Credenziali API
api_key- Tipo di canale
sms_otp- Identificativo del mittente
- L’ID mittente o il numero registrato presso il tuo fornitore.
- Destinatario (
to) - Numero di telefono in formato E.164.
- Tipi di messaggio
- Testo
- Buono a sapersi
- Solo testo. Gli allegati e i tipi interattivi vengono rifiutati con
unsupported_message_type. - Le tariffe del fornitore vengono addebitate dal tuo fornitore. Sono separate dalla tariffa del gateway.
- Solo testo. Gli allegati e i tipi interattivi vengono rifiutati con
Telegram
Invia tramite un bot Telegram creato da te. Il token del bot è l’unica credenziale, e le persone che scrivono al bot arrivano come eventi message.received.
0,0003 $ per messaggio in uscita, oppure un credito di un pacchetto
- Che cosa ti serve
- Un bot Telegram e il relativo token ottenuto da
@BotFather. Il nome utente del bot viene letto da Telegram al momento del collegamento. - Credenziali API
access_token- Tipo di canale
telegram- Identificativo del mittente
- Il nome utente del bot, letto da Telegram tramite il token.
- Destinatario (
to) - ID della chat Telegram.
- Buono a sapersi
- Un bot può scrivere solo a una persona che ha avviato una conversazione con lui.
- L’ID della chat di ogni persona è incluso negli eventi
message.receivedche questa genera.
Messenger
Rispondi alle persone che contattano la tua Pagina Facebook con testo, contenuti multimediali e pulsanti di risposta. I messaggi in entrata arrivano al tuo webhook con l’ID del mittente che ti serve per rispondere.
0,0005 $ per messaggio in uscita, oppure un credito di un pacchetto
- Che cosa ti serve
- Una Pagina Facebook e un accesso Facebook che ne abbia il controllo completo.
- Come collegarlo
- Nella console, continua con Facebook e scegli la Pagina da cui inviare.Per questo tipo di canale non ci sono credenziali da copiare, e non può essere creato con una chiave API.
- Tipo di canale
messenger- Identificativo del mittente
- La Pagina da cui il canale invia.
- Destinatario (
to) - ID utente con ambito limitato alla Pagina.
- Tipi di messaggio
- TestoAllegatiPulsanti di risposta
- Buono a sapersi
- Gli ID con ambito limitato alla Pagina vengono emessi per ogni Pagina. Li ricevi negli eventi
message.received. - Ciò che puoi inviare, e quando, è soggetto alle politiche di messaggistica di Meta.
- Gli ID con ambito limitato alla Pagina vengono emessi per ogni Pagina. Li ricevi negli eventi
Rispondi ai messaggi diretti inviati al tuo account professionale Instagram con testo, contenuti multimediali e pulsanti di risposta, dallo stesso endpoint di tutti gli altri canali.
0,0005 $ per messaggio in uscita, oppure un credito di un pacchetto
- Che cosa ti serve
- Un account professionale Instagram collegato a una Pagina Facebook che gestisci.
- Come collegarlo
- Nella console, continua con Facebook e scegli la Pagina a cui è collegato il tuo account Instagram. Le Pagine senza un account professionale collegato non possono essere collegate.Per questo tipo di canale non ci sono credenziali da copiare, e non può essere creato con una chiave API.
- Tipo di canale
instagram- Identificativo del mittente
- L’account Instagram da cui il canale invia.
- Destinatario (
to) - ID utente con ambito limitato alla Pagina.
- Tipi di messaggio
- TestoAllegatiPulsanti di risposta
- Buono a sapersi
- Gli ID con ambito limitato vengono emessi per ogni account. Li ricevi negli eventi
message.received. - Ciò che puoi inviare, e quando, è soggetto alle politiche di messaggistica di Meta.
- Gli ID con ambito limitato vengono emessi per ogni account. Li ricevi negli eventi
TikTok
Rispondi alle persone che scrivono al tuo account aziendale TikTok con testo, contenuti multimediali e pulsanti di risposta, e traccia ogni messaggio con gli stessi stati e webhook.
0,0005 $ per messaggio in uscita, oppure un credito di un pacchetto
- Che cosa ti serve
- Un account TikTok Business a cui puoi accedere.
- Come collegarlo
- Nella console, continua con TikTok e approva l’accesso ai messaggi del tuo account aziendale.Per questo tipo di canale non ci sono credenziali da copiare, e non può essere creato con una chiave API.
- Tipo di canale
tiktok- Identificativo del mittente
- L’account TikTok da cui il canale invia.
- Destinatario (
to) - L’ID del mittente ricavato da un evento
message.received. - Tipi di messaggio
- TestoAllegatiPulsanti di risposta
- Buono a sapersi
- Ciò che puoi inviare, e quando, è soggetto alle politiche di messaggistica di TikTok.
Collega il tuo primo canale
Crea un account, aggiungi un mittente che possiedi già e invia con la stessa richiesta che hai provato nella sandbox.