Aller au contenu
OmniMessage

Canaux

Sept types de canaux derrière un seul point de terminaison

OmniMessage est une passerelle à laquelle vous apportez vos propres canaux. Vous connectez les expéditeurs que vous possédez déjà, et chacun d’eux est adressé, suivi et facturé de la même manière.

Obtenir une clé APILire la documentation

Apportez vos propres canaux

Connectez une seule fois, dans la console ou par API

Un expéditeur connecté devient un canal doté d’un ID. Cet ID est la seule valeur propre au canal dans une requête d’envoi.

  • L’expéditeur vous appartient

    Le numéro, le bot ou le compte est enregistré à votre nom auprès du fournisseur. Quitter OmniMessage ne vous oblige pas à abandonner votre expéditeur.

  • Deux factures distinctes

    OmniMessage facture des frais de passerelle par message sortant. Ce que Meta, Twilio ou un autre fournisseur facture pour le canal vous est facturé directement par eux.

  • Connectez-vous ou collez vos identifiants

    WhatsApp, Messenger et Instagram sont autorisés en vous connectant avec Facebook dans la console, et TikTok en vous connectant avec TikTok. Telegram, SMS et SMS OTP utilisent des identifiants, saisis dans la console ou transmis par l’API ; c’est aussi possible pour un numéro WhatsApp déjà relié à la Cloud API.

  • Les identifiants sont en écriture seule

    Les jetons, codes et identifiants sont transmis à la couche de distribution lorsque vous connectez un canal. Ils ne sont pas stockés par la passerelle et l’API ne les renvoie jamais.

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"
}

Pour WhatsApp, Telegram, SMS et SMS OTP. Nécessite la portée channels:write. Abonnez-vous à channel.connected et à channel.disconnected pour suivre l’état de la connexion.

WhatsApp Business

Envoyez depuis un numéro de téléphone WhatsApp Business Platform (Cloud API) qui vous appartient. OmniMessage transmet vos messages à la Cloud API et vous renvoie les statuts envoyé, distribué, lu et échec.

0,001 $ par message sortant, ou un crédit de forfait

Ce qu’il vous faut
Un compte Facebook ayant accès à votre portefeuille business Meta. Choisissez « Continuer avec Facebook » dans la console : Meta Embedded Signup configure le compte WhatsApp Business et le numéro. Un numéro déjà relié à la Cloud API peut aussi être connecté avec ses ID et un jeton d’accès d’utilisateur système, dans la console ou par l’API.
Identifiants API
wab_account_idphone_number_idaccess_token
Type de canal
whatsapp
Identifiant de l’expéditeur
Numéro de téléphone de l’expéditeur au format E.164, par exemple +971800123456.
Destinataire (to)
Numéro de téléphone au format E.164.
Types de messages
TextePièces jointesModèleBoutons de réponseListeBouton URLPositionContacts
Bon à savoir
  • En dehors de la fenêtre de service client de 24 heures, WhatsApp n’accepte que les messages modèles approuvés.
  • Listez les modèles approuvés d’un canal avec GET /v1/channels/:id/templates.
  • Les frais de conversation Meta sont facturés par Meta à votre compte WhatsApp Business. Ils sont distincts des frais de passerelle.

SMS

Envoyez des SMS depuis un numéro de téléphone Twilio de votre propre compte Twilio. Utilisez-le pour les notifications, les rappels et les conversations bidirectionnelles ; les messages entrants sont remis à votre webhook.

0,0005 $ par message sortant, ou un crédit de forfait

Ce qu’il vous faut
Un compte Twilio et un numéro de téléphone activé pour la messagerie.
Identifiants API
account_sidphone_number_sidauth_token
Type de canal
sms
Identifiant de l’expéditeur
Numéro de téléphone de l’expéditeur au format E.164.
Destinataire (to)
Numéro de téléphone au format E.164.
Types de messages
TextePièces jointes
Bon à savoir
  • Les pièces jointes multimédias dépendent de ce que prennent en charge votre numéro et le réseau de destination.
  • Les frais d’opérateur et les frais Twilio sont facturés par Twilio à votre compte Twilio. Ils sont distincts des frais de passerelle.

SMS OTP

Un type de canal dédié aux codes de vérification. Il n’accepte que du texte brut : un parcours de connexion ne peut donc pas y faire passer autre chose par erreur.

0,0005 $ par message sortant, ou un crédit de forfait

Ce qu’il vous faut
Un compte auprès de votre fournisseur de SMS OTP et sa clé API.
Identifiants API
api_key
Type de canal
sms_otp
Identifiant de l’expéditeur
L’ID d’expéditeur ou le numéro enregistré auprès de votre fournisseur.
Destinataire (to)
Numéro de téléphone au format E.164.
Types de messages
Texte
Bon à savoir
  • Texte uniquement. Les pièces jointes et les types interactifs sont rejetés avec unsupported_message_type.
  • Les frais du fournisseur sont facturés par votre fournisseur. Ils sont distincts des frais de passerelle.

Telegram

Envoyez par l’intermédiaire d’un bot Telegram que vous avez créé. Le jeton du bot est le seul identifiant requis, et les personnes qui écrivent au bot arrivent sous forme d’événements message.received.

0,0003 $ par message sortant, ou un crédit de forfait

Ce qu’il vous faut
Un bot Telegram et son jeton obtenu auprès de @BotFather. Le nom d’utilisateur du bot est lu depuis Telegram lors de la connexion.
Identifiants API
access_token
Type de canal
telegram
Identifiant de l’expéditeur
Le nom d’utilisateur du bot, lu depuis Telegram à l’aide du jeton.
Destinataire (to)
ID de chat Telegram.
Types de messages
TextePièces jointesBoutons de réponsePositionContactsSondage
Bon à savoir
  • Un bot ne peut écrire qu’à une personne qui a déjà engagé une conversation avec lui.
  • L’ID de chat de chaque personne figure dans les événements message.received qu’elle déclenche.

Messenger

Répondez aux personnes qui contactent votre Page Facebook, avec du texte, des médias et des boutons de réponse. Les messages entrants parviennent à votre webhook avec l’ID d’expéditeur dont vous avez besoin pour répondre.

0,0005 $ par message sortant, ou un crédit de forfait

Ce qu’il vous faut
Une Page Facebook et un compte Facebook qui en a le contrôle total.
Mode de connexion
Dans la console, continuez avec Facebook et choisissez la Page depuis laquelle envoyer.Ce type de canal n’a aucun identifiant à copier et ne peut pas être créé avec une clé API.
Type de canal
messenger
Identifiant de l’expéditeur
La Page depuis laquelle le canal envoie.
Destinataire (to)
ID utilisateur spécifique à la Page.
Types de messages
TextePièces jointesBoutons de réponse
Bon à savoir
  • Les ID spécifiques à la Page sont attribués pour chaque Page. Vous les recevez dans les événements message.received.
  • Les règles de messagerie de Meta déterminent ce que vous pouvez envoyer et à quel moment.

Instagram

Répondez aux messages privés envoyés à votre compte professionnel Instagram avec du texte, des médias et des boutons de réponse, par le même point de terminaison que pour tous les autres canaux.

0,0005 $ par message sortant, ou un crédit de forfait

Ce qu’il vous faut
Un compte professionnel Instagram associé à une Page Facebook que vous gérez.
Mode de connexion
Dans la console, continuez avec Facebook et choisissez la Page à laquelle votre compte Instagram est associé. Les Pages sans compte professionnel associé ne peuvent pas être connectées.Ce type de canal n’a aucun identifiant à copier et ne peut pas être créé avec une clé API.
Type de canal
instagram
Identifiant de l’expéditeur
Le compte Instagram depuis lequel le canal envoie.
Destinataire (to)
ID utilisateur spécifique à la Page.
Types de messages
TextePièces jointesBoutons de réponse
Bon à savoir
  • Les ID spécifiques sont attribués pour chaque compte. Vous les recevez dans les événements message.received.
  • Les règles de messagerie de Meta déterminent ce que vous pouvez envoyer et à quel moment.

TikTok

Répondez aux personnes qui écrivent à votre compte professionnel TikTok avec du texte, des médias et des boutons de réponse, et suivez chaque message avec les mêmes statuts et les mêmes webhooks.

0,0005 $ par message sortant, ou un crédit de forfait

Ce qu’il vous faut
Un compte TikTok Business auquel vous pouvez vous connecter.
Mode de connexion
Dans la console, continuez avec TikTok et autorisez l’accès aux messages de votre compte professionnel.Ce type de canal n’a aucun identifiant à copier et ne peut pas être créé avec une clé API.
Type de canal
tiktok
Identifiant de l’expéditeur
Le compte TikTok depuis lequel le canal envoie.
Destinataire (to)
L’ID d’expéditeur issu d’un événement message.received.
Types de messages
TextePièces jointesBoutons de réponse
Bon à savoir
  • Les règles de messagerie de TikTok déterminent ce que vous pouvez envoyer et à quel moment.

Connectez votre premier canal

Créez un compte, ajoutez un expéditeur que vous possédez déjà et envoyez par ce canal avec la même requête que celle testée dans le bac à sable.

Obtenir une clé APILire la documentation