Zum Inhalt springen

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.

POST /v1/channels
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": "..."
    }
  }'
201 Created
{
  "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.
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/templates auf.
  • 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.
Nachrichtentypen
TextAnhänge
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_type abgelehnt.
  • Anbietergebühren werden von Ihrem Anbieter berechnet. Sie fallen getrennt von der Gateway-Gebühr an.

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.
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.

Instagram

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.
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.

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.
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.