Connectez Slack à votre agent IA

Méthodes d’authentification

• OAuth 2.0

Ouvrez la console locale, sélectionnez un fournisseur et configurez ses identifiants. Les fournisseurs OAuth nécessitent une application OAuth que vous enregistrez auprès du service.

Points à vérifier pour ce connecteur

Cet exemple liste les canaux accessibles à la connexion. Vérifiez les scopes requis et les droits du compte ; un canal absent ne prouve pas à lui seul un défaut du connecteur.

Vérifier l’Action avant de l’appeler

Objectif de l’exemple

Lister les canaux Slack accessibles à la connexion.

Autorisations requises par l’Action

• channels:read

Lisez le schéma de votre instance en cours d’exécution. Vérifiez les paramètres requis, les autorisations et le compte connecté avant l’appel.

curl -s http://localhost:3000/v1/actions/slack.list_channels

Une fois le compte connecté, adaptez les paramètres à vos ressources. Ajoutez un Bearer Token du runtime si son authentification est activée.

curl -s -X POST \
  http://localhost:3000/v1/actions/slack.list_channels \
  -H 'content-type: application/json' \
  -d '{"input":{"limit":5}}'

Lire le résultat

Les réponses HTTP du runtime contiennent success, message, data et meta. Vérifiez success et le schéma de sortie de l’Action, pas seulement le statut HTTP. Si les métadonnées contiennent executionId, utilisez-le pour retrouver le journal expurgé correspondant. L’exemple ci-dessous illustre le format ; ce n’est pas un résultat d’appel réel.

{
  "success": true,
  "message": "OK",
  "data": {},
  "meta": {}
}

En cas d’échec

• Pour une erreur d’authentification, vérifiez l’endpoint et le type d’identifiant : l’accès administrateur protège /api, le jeton Bearer runtime autorise /v1 et /mcp. Une clé API fournisseur ne remplace pas le jeton runtime.
• Pour un refus d’accès, vérifiez les scopes requis, les règles d’Actions et les autorisations de connexion. Un jeton valide peut ne pas être autorisé à utiliser le compte choisi.
• Si le résultat est vide ou incomplet, vérifiez le compte connecté et ses droits sur la ressource. Une autorisation réussie ne donne pas accès à tous les espaces, canaux ou documents.
• Consultez l’erreur et le journal avant de réessayer. Si l’Action modifie les données du fournisseur, vérifiez d’abord si elle a déjà abouti ; ne répétez pas la requête aveuglément.

Étapes suivantes

Pour les fournisseurs compatibles, OOMOL gère la configuration des applications OAuth et l’hébergement. Vous choisissez toujours le compte et approuvez ses autorisations.