Intégrations & Topics
Connectez les fournisseurs que vous utilisez déjà — Slack, Telegram, e-mail, SMS, push mobile, push web ou un webhook —, regroupez-les dans un topic, et publiez un seul événement pour atteindre chaque canal du topic.
Comment ça marche
Configurez une fois dans le tableau de bord, puis publiez avec un seul appel API.
Connectez un fournisseur
Dans le tableau de bord, renseignez les identifiants d'un fournisseur — Slack, Telegram, Resend, Amazon SES, Mailgun, Mailchimp, Amazon SNS, Firebase, Pusher, une URL de webhook ou votre propre API —, ajoutez un préfixe de canal si besoin, puis activez-le.
Regroupez-le dans un topic
Un topic est une cible de livraison qui regroupe vos intégrations, par exemple commandes ou incidents. Attachez-y autant d'intégrations que nécessaire.
Publiez une seule fois
Appelez POST /v1/notify/send avec le nom du topic et au moins un bloc d'événement. Callisto met en file la livraison vers chaque intégration attachée à ce topic.
Tous les canaux que votre équipe utilise déjà
Utilisez vos propres identifiants pour les fournisseurs que vous employez. Rien à installer, aucune nouvelle relation fournisseur à signer.
Chat
Slack, Telegram
Resend, Amazon SES, Mailgun, Mailchimp
SMS
Amazon SNS
Push mobile
Firebase
Push web
Pusher
Webhooks
Votre propre endpoint HTTP, ou une API avec méthode, en-têtes et corps à votre choix
Une requête, tous les canaux
Authentifiez-vous comme pour l'API SMS — HTTP Basic avec votre clé d'accès et votre secret —, puis envoyez un topic et un ou plusieurs blocs d'événement.
curl -u 'ak_xxx:sk_xxx' \ -X POST https://api.callistosignal.com/v1/notify/send \ -H "Content-Type: application/json" \ -d '{ "topic": "orders", "email": { "to": "[email protected]", "subject": "Order #1042", "html": "<p>...</p>" }, "sms": { "phone_number": "+2250700000000", "message": "Order #1042" }, "messaging": { "message": "Order #1042 - 25 000 XOF" } }'
{ "topic": "orders", "queued_events": 3, "topic_messages": 1 }
La livraison est asynchrone : la requête met l'événement en file et le scheduler exécute la livraison vers chaque canal du topic.
topic — Obligatoire, 1 à 255 caractères : le topic auquel chaque intégration attachée est abonnée.
Au moins un bloc d'événement : email, sms, mobile_push, messaging, real_time, web_push, webhook. Les champs non présentés ici varient selon le canal — configurez-les depuis le tableau de bord.
Cas d'usage
Alertes de commande
Confirmez une commande en un seul appel : un reçu par e-mail au client, un SMS à la logistique, et un message Slack au canal ops.
Diffusion d'incident
Diffusez un incident sur tous les canaux d'astreinte en même temps — Slack, le téléphone d'astreinte par SMS, et un webhook de status page — au lieu de maintenir trois intégrations séparées.
Codes de vérification sur deux canaux
Envoyez le même code à usage unique par SMS et par e-mail en une seule requête, pour qu'un opérateur en retard ne bloque pas la connexion.
Questions fréquentes
Qu'est-ce qu'un topic ?
Un topic est une cible de livraison qui regroupe vos intégrations. Envoyer vers un topic diffuse l'événement à chaque intégration qui y est attachée, en une seule opération.
Quels canaux puis-je connecter ?
Chat (Slack, Telegram), e-mail (Resend, Amazon SES, Mailgun, Mailchimp), SMS (Amazon SNS), push mobile (Firebase), push web (Pusher), des webhooks vers votre endpoint et des appels vers votre propre API.
Avec quels identifiants j'appelle l'API ?
Les mêmes identifiants API que pour l'API SMS : authentification HTTP Basic avec votre clé d'accès et votre secret.
La livraison est-elle synchrone ?
Non. POST /v1/notify/send met l'événement en file et répond immédiatement ; le scheduler exécute la livraison vers chaque canal de façon asynchrone.
Prêt à connecter votre première intégration ?
Configurez un fournisseur, regroupez-le dans un topic, et publiez votre premier événement en quelques minutes.