Ton premier jour d’connector avec Tale

Ce parcours s’adresse à la personne qui câble Tale dans d’autres systèmes. En dix minutes, tu crées une clé API, tu envoies ta première requête authentifiée et tu sais à quelle porte frapper pour le chat, les workflows et les documents.

Il te faut le rôle Développeur ou plus (les paramètres d’API sont masqués en dessous) sur une instance qui tourne — démarrage rapide si tu n’en as pas. Remplace your-host.example.com ci-dessous par l’hôte de ton instance.

1. 1

   Crée une clé API

   Pour obtenir un identifiant que tes scripts peuvent porter, ouvre Paramètres > API > REST et clique sur Créer une clé API. Nomme-la d’après le système qui l’utilisera — les clés sont listées par nom, et dans un an « zapier-bridge » bat « test ». La valeur de la clé ne s’affiche qu’une fois, à la création ; range-la dans ton gestionnaire de secrets, pas dans le code.

   

2. 2

   Envoie la première requête

   L’appel utile le plus court liste les agents que ta clé peut voir. La clé voyage comme un token bearer ; le contexte de l’espace de travail se déduit de la clé elle-même :

   bash

   curl -sS https://your-host.example.com/api/v1/agents \
     -H "Authorization: Bearer $TALE_API_KEY"

Le reste de la surface

Tout le reste est une variation de cette requête. Les automatisations se lancent par nom via POST /api/v1/automations/<name>/runs avec la même clé Bearer — répondu 202, suivi via /api/v1/runs/<runId> — ou se déclenchent depuis l’extérieur via des URL de webhook de la forme /api/automations/webhook/<token>, où le jeton dans l’URL est l’identifiant. Le chat, c’est un thread, un message posté et un suivi ; les documents se téléversent via /api/v1/documents ; et la même clé ouvre l’endpoint MCP pour les clients pilotés par modèle. La référence API est l’inventaire complet avec l’authentification, les formes et les limites.

Où tu en es

Tu tiens un identifiant qui fonctionne et tu as vu la forme de requête que chaque endpoint partage. À partir d’ici, appeler Tale depuis un script transforme le curl en vraie connector, déclencher une automatisation par webhook couvre le sens entrant — tes systèmes qui déclenchent Tale — et l’endpoint MCP est la même plateforme pour les clients MCP.