Kanäle
Sieben Kanaltypen hinter einem Endpunkt
OmniMessage ist ein Gateway, zu dem Sie Ihre eigenen Kanäle mitbringen. Sie verbinden Absender, die Sie bereits besitzen, und jeder von ihnen wird auf dieselbe Weise adressiert, nachverfolgt und abgerechnet.
Ihre eigenen Kanäle
Einmal verbinden, in der Konsole oder per API
Ein verbundener Absender wird zu einem Kanal mit einer ID. Diese ID ist der einzige kanalspezifische Wert in einer Sendeanfrage.
Der Absender gehört Ihnen
Die Nummer, der Bot oder das Konto ist beim Anbieter auf Sie registriert. Wenn Sie OmniMessage verlassen, lassen Sie Ihren Absender nicht zurück.
Zwei getrennte Rechnungen
OmniMessage berechnet eine Gateway-Gebühr pro ausgehender Nachricht. Was Meta, Twilio oder ein anderer Anbieter für den Kanal berechnet, stellt dieser Ihnen direkt in Rechnung.
Anmelden oder Zugangsdaten einfügen
WhatsApp, Messenger und Instagram werden durch die Anmeldung mit Facebook in der Konsole autorisiert, TikTok durch die Anmeldung mit TikTok. Telegram, SMS und SMS OTP benötigen Zugangsdaten, in der Konsole oder über die API; dasselbe ist für eine WhatsApp-Nummer möglich, die bereits in der Cloud API eingerichtet ist.
Zugangsdaten sind nur schreibbar
Token, Codes und Zugangsdaten werden an die Zustellschicht übergeben, wenn Sie einen Kanal verbinden. Das Gateway speichert sie nicht, und die API gibt sie niemals zurück.
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"
}Für WhatsApp, Telegram, SMS und SMS OTP. Erfordert den Scope channels:write. Abonnieren Sie channel.connected und channel.disconnected, um den Verbindungsstatus zu verfolgen.
WhatsApp Business
Senden Sie von einer Telefonnummer der WhatsApp Business Platform (Cloud API), die Ihnen gehört. OmniMessage leitet Ihre Nachrichten an die Cloud API weiter und meldet Ihnen die Status gesendet, zugestellt, gelesen und fehlgeschlagen zurück.
0,001 $ pro ausgehender Nachricht oder ein Paket-Credit
- Was Sie brauchen
- Ein Facebook-Login mit Zugriff auf Ihr Meta-Unternehmensportfolio. Wählen Sie in der Konsole „Weiter mit Facebook“, und Meta Embedded Signup richtet das WhatsApp-Business-Konto und die Nummer ein. Eine Nummer, die bereits in der Cloud API eingerichtet ist, lässt sich auch mit ihren IDs und einem Systemnutzer-Zugriffstoken verbinden, in der Konsole oder über die API.
- API-Zugangsdaten
wab_account_idphone_number_idaccess_token- Kanaltyp
whatsapp- Absenderkennung
- Telefonnummer des Absenders im E.164-Format, zum Beispiel
+971800123456. - Empfänger (
to) - Telefonnummer im E.164-Format.
- Nachrichtentypen
- TextAnhängeVorlageAntwort-ButtonsListeURL-ButtonStandortKontakte
- Gut zu wissen
- Außerhalb des 24-Stunden-Kundenservicefensters akzeptiert WhatsApp nur freigegebene Vorlagennachrichten.
- Die freigegebenen Vorlagen eines Kanals listen Sie mit
GET /v1/channels/:id/templatesauf. - Die Konversationsgebühren von Meta werden Ihrem WhatsApp-Business-Konto von Meta berechnet. Sie fallen getrennt von der Gateway-Gebühr an.
SMS
Senden Sie SMS von einer Twilio-Telefonnummer in Ihrem eigenen Twilio-Konto. Nutzen Sie sie für Benachrichtigungen, Erinnerungen und Dialoge in beide Richtungen; eingehende Nachrichten werden an Ihren Webhook zugestellt.
0,0005 $ pro ausgehender Nachricht oder ein Paket-Credit
- Was Sie brauchen
- Ein Twilio-Konto und eine Telefonnummer, die für Messaging aktiviert ist.
- API-Zugangsdaten
account_sidphone_number_sidauth_token- Kanaltyp
sms- Absenderkennung
- Telefonnummer des Absenders im E.164-Format.
- Empfänger (
to) - Telefonnummer im E.164-Format.
- Gut zu wissen
- Medienanhänge hängen davon ab, was Ihre Nummer und das Zielnetz unterstützen.
- Netzbetreiber- und Twilio-Gebühren werden Ihrem Twilio-Konto von Twilio berechnet. Sie fallen getrennt von der Gateway-Gebühr an.
SMS OTP
Ein eigener Kanaltyp für Bestätigungscodes. Er akzeptiert ausschließlich reinen Text, sodass ein Login-Ablauf nicht versehentlich etwas anderes darüber senden kann.
0,0005 $ pro ausgehender Nachricht oder ein Paket-Credit
- Was Sie brauchen
- Ein Konto bei Ihrem OTP-SMS-Anbieter und dessen API-Schlüssel.
- API-Zugangsdaten
api_key- Kanaltyp
sms_otp- Absenderkennung
- Die bei Ihrem Anbieter registrierte Absenderkennung oder Nummer.
- Empfänger (
to) - Telefonnummer im E.164-Format.
- Nachrichtentypen
- Text
- Gut zu wissen
- Nur Text. Anhänge und interaktive Typen werden mit
unsupported_message_typeabgelehnt. - Anbietergebühren werden von Ihrem Anbieter berechnet. Sie fallen getrennt von der Gateway-Gebühr an.
- Nur Text. Anhänge und interaktive Typen werden mit
Telegram
Senden Sie über einen Telegram-Bot, den Sie selbst erstellt haben. Das Bot-Token ist die einzige Zugangsinformation, und Personen, die dem Bot schreiben, kommen als message.received-Ereignisse an.
0,0003 $ pro ausgehender Nachricht oder ein Paket-Credit
- Was Sie brauchen
- Ein Telegram-Bot und sein Token von
@BotFather. Der Benutzername des Bots wird beim Verbinden aus Telegram ausgelesen. - API-Zugangsdaten
access_token- Kanaltyp
telegram- Absenderkennung
- Der Benutzername des Bots, mit dem Token aus Telegram ausgelesen.
- Empfänger (
to) - Telegram-Chat-ID.
- Gut zu wissen
- Ein Bot kann nur Personen schreiben, die eine Unterhaltung mit ihm begonnen haben.
- Die Chat-ID jeder Person ist in den
message.received-Ereignissen enthalten, die sie auslöst.
Messenger
Antworten Sie Personen, die Ihre Facebook-Seite kontaktieren, mit Text, Medien und Antwort-Buttons. Eingehende Nachrichten erreichen Ihren Webhook mit der Absender-ID, die Sie zum Antworten brauchen.
0,0005 $ pro ausgehender Nachricht oder ein Paket-Credit
- Was Sie brauchen
- Eine Facebook-Seite und ein Facebook-Login mit vollständiger Kontrolle darüber.
- So verbinden Sie
- Wählen Sie in der Konsole „Weiter mit Facebook“ und dann die Seite, von der gesendet werden soll.Für diesen Kanaltyp gibt es keine Zugangsdaten zum Kopieren, und er kann nicht mit einem API-Schlüssel erstellt werden.
- Kanaltyp
messenger- Absenderkennung
- Die Seite, von der der Kanal sendet.
- Empfänger (
to) - Seitenspezifische Nutzer-ID.
- Nachrichtentypen
- TextAnhängeAntwort-Buttons
- Gut zu wissen
- Seitenspezifische IDs werden je Seite vergeben. Sie erhalten sie in
message.received-Ereignissen. - Was Sie wann senden dürfen, richtet sich nach den Messaging-Richtlinien von Meta.
- Seitenspezifische IDs werden je Seite vergeben. Sie erhalten sie in
Beantworten Sie Direktnachrichten an Ihr professionelles Instagram-Konto mit Text, Medien und Antwort-Buttons, über denselben Endpunkt wie bei jedem anderen Kanal.
0,0005 $ pro ausgehender Nachricht oder ein Paket-Credit
- Was Sie brauchen
- Ein professionelles Instagram-Konto, das mit einer von Ihnen verwalteten Facebook-Seite verknüpft ist.
- So verbinden Sie
- Wählen Sie in der Konsole „Weiter mit Facebook“ und dann die Seite, mit der Ihr Instagram-Konto verknüpft ist. Seiten ohne verknüpftes professionelles Konto können nicht verbunden werden.Für diesen Kanaltyp gibt es keine Zugangsdaten zum Kopieren, und er kann nicht mit einem API-Schlüssel erstellt werden.
- Kanaltyp
instagram- Absenderkennung
- Das Instagram-Konto, von dem der Kanal sendet.
- Empfänger (
to) - Seitenspezifische Nutzer-ID.
- Nachrichtentypen
- TextAnhängeAntwort-Buttons
- Gut zu wissen
- Kontospezifische IDs werden je Konto vergeben. Sie erhalten sie in
message.received-Ereignissen. - Was Sie wann senden dürfen, richtet sich nach den Messaging-Richtlinien von Meta.
- Kontospezifische IDs werden je Konto vergeben. Sie erhalten sie in
TikTok
Antworten Sie Personen, die Ihrem TikTok-Business-Konto schreiben, mit Text, Medien und Antwort-Buttons, und verfolgen Sie jede Nachricht mit denselben Status und Webhooks.
0,0005 $ pro ausgehender Nachricht oder ein Paket-Credit
- Was Sie brauchen
- Ein TikTok-Business-Konto, bei dem Sie sich anmelden können.
- So verbinden Sie
- Wählen Sie in der Konsole „Weiter mit TikTok“ und genehmigen Sie den Zugriff auf die Nachrichten Ihres Business-Kontos.Für diesen Kanaltyp gibt es keine Zugangsdaten zum Kopieren, und er kann nicht mit einem API-Schlüssel erstellt werden.
- Kanaltyp
tiktok- Absenderkennung
- Das TikTok-Konto, von dem der Kanal sendet.
- Empfänger (
to) - Die Absender-ID aus einem
message.received-Ereignis. - Nachrichtentypen
- TextAnhängeAntwort-Buttons
- Gut zu wissen
- Was Sie wann senden dürfen, richtet sich nach den Messaging-Richtlinien von TikTok.
Verbinden Sie Ihren ersten Kanal
Erstellen Sie ein Konto, fügen Sie einen Absender hinzu, den Sie bereits besitzen, und senden Sie darüber mit demselben Request, den Sie in der Sandbox getestet haben.