Documentation

Branche tes outils et tes agents sur Synkro.

Guides pas à pas, référence de l'API REST, outils du serveur MCP et format des webhooks. Tout ce qu'il faut pour connecter un agent IA, un script ou un outil no-code.

Par où commencer ?

Disponible Connecter un agent IA Claude Code, Codex et Cursor par jeton ; claude.ai, Claude Desktop et ChatGPT par OAuth. 5 minutes.
Disponible · gratuit Recevoir des messages Un webhook entrant par canal, au format Synkro ou Slack. Tes scripts Slack marchent en changeant seulement l'adresse.
Disponible · Essentiel Réagir aux événements Webhooks sortants signés : message publié, ticket créé ou changé de statut, appel terminé…
Disponible · Essentiel Utiliser l'API REST Canaux, messages, tickets, commentaires et abonnements. Décrite en OpenAPI 3.1.
En développement n8n, Make et recettes Nœud n8n, app Make, recettes Stripe, Tally et GitHub. La doc arrive avec eux.
Référence Sécurité et confidentialité Droits des agents, conversations confidentielles, stockage des secrets, journal des écritures.

Démarrage rapide

Ton premier message par l'API, en trois étapes.

Crée une clé d'API
Administration › Intégrations, puis « Nouvelle clé d'API ». Choisis les canaux qu'elle peut lire et écrire. Réservé aux propriétaires et aux admins, avec l'offre Essentiel.
Copie la clé
La clé syk_key_… ne s'affiche qu'une fois. Range-la dans le gestionnaire de secrets de ton outil, jamais dans le code.
Publie dans un canal
Un POST sur /channels/{channel_id}/messages. Le message porte le nom de l'intégration et la marque « app ».

# Lister les canaux ouverts à la clé
curl "https://integrations.mysynkro.fr/v1/channels" \
  -H "Authorization: Bearer $SYNKRO_API_KEY"

# Publier un message
curl -X POST "https://integrations.mysynkro.fr/v1/channels/$CHANNEL_ID/messages" \
  -H "Authorization: Bearer $SYNKRO_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: deploiement-2026-10-29-01" \
  -d '{"text": "Mise en production **v2.4** terminée ✅"}'

L'en-tête Idempotency-Key évite un doublon si ton script relance la requête.

Agents IA (MCP)

Webhooks

API REST

Aperçus des liens et SynkroBot

Quand un message d'un canal contient un lien externe, Synkro peut en afficher un aperçu (titre, description, image). Pour cela, un agent nommé SynkroBot ouvre la page, avec l'en-tête User-Agent: SynkroBot/1.0 (+https://mysynkro.fr/bot), lit ses balises de description et copie l'image sur le site de Synkro. Les personnes qui lisent le message ne contactent jamais le site du lien.

Un administrateur active ou coupe les aperçus dans les réglages de l'organisation ; coupés, plus aucune page n'est ouverte.
SynkroBot n'ouvre que les liens des canaux, jamais dans un message privé.
Les aperçus gardés en cache durent 7 jours. Si ton site ne veut pas de l'aperçu, il suffit de ne pas publier ses balises de description.