Kanalen
Zeven kanaaltypen achter één endpoint
OmniMessage is een gateway waarop je je eigen kanalen aansluit. Je koppelt afzenders die al van jou zijn, en elk daarvan wordt op dezelfde manier aangesproken, gevolgd en gefactureerd.
Gebruik je eigen kanaal
Eén keer koppelen, in de console of via de API
Een gekoppelde afzender wordt een kanaal met een ID. Dat ID is de enige kanaalspecifieke waarde in een verzendverzoek.
De afzender is van jou
Het nummer, de bot of het account staat bij de aanbieder op jouw naam. Als je OmniMessage verlaat, neem je je afzender gewoon mee.
Twee aparte rekeningen
OmniMessage rekent een gatewaytarief per uitgaand bericht. Wat Meta, Twilio of een andere aanbieder voor het kanaal rekent, factureren zij rechtstreeks aan jou.
Log in of plak toegangsgegevens
WhatsApp, Messenger en Instagram autoriseer je door in de console in te loggen met Facebook, en TikTok door in te loggen met TikTok. Voor Telegram, SMS en SMS OTP voer je toegangsgegevens in, in de console of via de API. Dat kan ook voor een WhatsApp-nummer dat al op de Cloud API zit.
Toegangsgegevens zijn alleen-schrijven
Tokens, codes en toegangsgegevens worden bij het koppelen van een kanaal doorgegeven aan de afleverlaag. De gateway slaat ze niet op en de API geeft ze nooit terug.
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"
}Voor WhatsApp, Telegram, SMS en SMS OTP. Vereist de scope channels:write. Abonneer je op channel.connected en channel.disconnected om de verbindingsstatus te volgen.
WhatsApp Business
Verzend vanaf een telefoonnummer op het WhatsApp Business Platform (Cloud API) dat van jou is. OmniMessage stuurt je berichten door naar de Cloud API en meldt de statussen verzonden, afgeleverd, gelezen en mislukt aan je terug.
$ 0,001 per uitgaand bericht, of één pakketcredit
- Wat je nodig hebt
- Een Facebook-login met toegang tot je Meta-bedrijfsportfolio. Kies in de console ‘Doorgaan met Facebook’ en Meta Embedded Signup stelt het WhatsApp Business-account en het nummer in. Een nummer dat al op de Cloud API zit, kun je ook koppelen met de bijbehorende ID’s en een toegangstoken van een systeemgebruiker, in de console of via de API.
- API-toegangsgegevens
wab_account_idphone_number_idaccess_token- Kanaaltype
whatsapp- Afzender-ID
- Telefoonnummer van de afzender in E.164-indeling, bijvoorbeeld
+971800123456. - Ontvanger (
to) - Telefoonnummer in E.164-indeling.
- Goed om te weten
- Buiten het klantenservicevenster van 24 uur accepteert WhatsApp alleen goedgekeurde sjabloonberichten.
- Vraag de goedgekeurde sjablonen van een kanaal op met
GET /v1/channels/:id/templates. - Gesprekskosten van Meta worden door Meta in rekening gebracht op je WhatsApp Business-account. Ze staan los van het gatewaytarief.
SMS
Verzend SMS vanaf een Twilio-telefoonnummer in je eigen Twilio-account. Gebruik het voor meldingen, herinneringen en tweerichtingsgesprekken; inkomende berichten worden afgeleverd op je webhook.
$ 0,0005 per uitgaand bericht, of één pakketcredit
- Wat je nodig hebt
- Een Twilio-account en een telefoonnummer waarop berichtenverkeer is ingeschakeld.
- API-toegangsgegevens
account_sidphone_number_sidauth_token- Kanaaltype
sms- Afzender-ID
- Telefoonnummer van de afzender in E.164-indeling.
- Ontvanger (
to) - Telefoonnummer in E.164-indeling.
- Goed om te weten
- Mediabijlagen hangen af van wat je nummer en het netwerk van de ontvanger ondersteunen.
- Kosten van providers en van Twilio worden door Twilio in rekening gebracht op je Twilio-account. Ze staan los van het gatewaytarief.
SMS OTP
Een apart kanaaltype voor verificatiecodes. Het accepteert alleen platte tekst, zodat een inlogflow er niet per ongeluk iets anders doorheen kan sturen.
$ 0,0005 per uitgaand bericht, of één pakketcredit
- Wat je nodig hebt
- Een account bij je aanbieder van OTP-SMS en de bijbehorende API-sleutel.
- API-toegangsgegevens
api_key- Kanaaltype
sms_otp- Afzender-ID
- De afzender-ID of het nummer dat bij je aanbieder is geregistreerd.
- Ontvanger (
to) - Telefoonnummer in E.164-indeling.
- Berichttypen
- Tekst
- Goed om te weten
- Alleen tekst. Bijlagen en interactieve typen worden geweigerd met
unsupported_message_type. - Kosten van de aanbieder worden door je aanbieder in rekening gebracht. Ze staan los van het gatewaytarief.
- Alleen tekst. Bijlagen en interactieve typen worden geweigerd met
Telegram
Verzend via een Telegram-bot die je zelf hebt gemaakt. Het bottoken is het enige toegangsgegeven, en mensen die de bot een bericht sturen, komen binnen als message.received-events.
$ 0,0003 per uitgaand bericht, of één pakketcredit
- Wat je nodig hebt
- Een Telegram-bot en het bijbehorende token van
@BotFather. De gebruikersnaam van de bot wordt bij het koppelen uit Telegram opgehaald. - API-toegangsgegevens
access_token- Kanaaltype
telegram- Afzender-ID
- De gebruikersnaam van de bot, met het token opgehaald uit Telegram.
- Ontvanger (
to) - Chat-ID van Telegram.
- Goed om te weten
- Een bot kan alleen berichten sturen naar iemand die er zelf een gesprek mee is begonnen.
- De chat-ID van elke persoon staat in de
message.received-events die diegene veroorzaakt.
Messenger
Beantwoord mensen die contact opnemen met je Facebook-pagina, met tekst, media en antwoordknoppen. Inkomende berichten bereiken je webhook met de afzender-ID die je nodig hebt om te antwoorden.
$ 0,0005 per uitgaand bericht, of één pakketcredit
- Wat je nodig hebt
- Een Facebook-pagina en een Facebook-login met volledig beheer over die pagina.
- Zo koppel je
- Kies in de console ‘Doorgaan met Facebook’ en selecteer de pagina waarvandaan je wilt verzenden.Voor dit kanaaltype zijn er geen toegangsgegevens om te kopiëren, en het kan niet met een API-sleutel worden aangemaakt.
- Kanaaltype
messenger- Afzender-ID
- De pagina waarvandaan het kanaal verzendt.
- Ontvanger (
to) - Paginagebonden gebruikers-ID.
- Berichttypen
- TekstBijlagenAntwoordknoppen
- Goed om te weten
- Paginagebonden ID’s worden per pagina uitgegeven. Je ontvangt ze in
message.received-events. - De berichtenbeleidsregels van Meta bepalen wat je mag verzenden en wanneer.
- Paginagebonden ID’s worden per pagina uitgegeven. Je ontvangt ze in
Beantwoord directe berichten aan je professionele Instagram-account met tekst, media en antwoordknoppen, via hetzelfde endpoint als elk ander kanaal.
$ 0,0005 per uitgaand bericht, of één pakketcredit
- Wat je nodig hebt
- Een professioneel Instagram-account dat is gekoppeld aan een Facebook-pagina die je beheert.
- Zo koppel je
- Kies in de console ‘Doorgaan met Facebook’ en selecteer de pagina waaraan je Instagram-account is gekoppeld. Pagina’s zonder gekoppeld professioneel account kunnen niet worden gekoppeld.Voor dit kanaaltype zijn er geen toegangsgegevens om te kopiëren, en het kan niet met een API-sleutel worden aangemaakt.
- Kanaaltype
instagram- Afzender-ID
- Het Instagram-account waarvandaan het kanaal verzendt.
- Ontvanger (
to) - Paginagebonden gebruikers-ID.
- Berichttypen
- TekstBijlagenAntwoordknoppen
- Goed om te weten
- Gebonden ID’s worden per account uitgegeven. Je ontvangt ze in
message.received-events. - De berichtenbeleidsregels van Meta bepalen wat je mag verzenden en wanneer.
- Gebonden ID’s worden per account uitgegeven. Je ontvangt ze in
TikTok
Beantwoord mensen die je zakelijke TikTok-account een bericht sturen met tekst, media en antwoordknoppen, en volg elk bericht met dezelfde statussen en webhooks.
$ 0,0005 per uitgaand bericht, of één pakketcredit
- Wat je nodig hebt
- Een TikTok Business-account waarop je kunt inloggen.
- Zo koppel je
- Kies in de console ‘Doorgaan met TikTok’ en geef toegang tot de berichten van je zakelijke account.Voor dit kanaaltype zijn er geen toegangsgegevens om te kopiëren, en het kan niet met een API-sleutel worden aangemaakt.
- Kanaaltype
tiktok- Afzender-ID
- Het TikTok-account waarvandaan het kanaal verzendt.
- Ontvanger (
to) - De afzender-ID uit een
message.received-event. - Berichttypen
- TekstBijlagenAntwoordknoppen
- Goed om te weten
- De berichtenbeleidsregels van TikTok bepalen wat je mag verzenden en wanneer.
Koppel je eerste kanaal
Maak een account aan, voeg een afzender toe die al van jou is en verzend erdoor met hetzelfde verzoek dat je in de sandbox hebt getest.