Connectez Tiny Ant à vos propres outils

API REST, serveur MCP et webhooks

Utilisez l'API REST pour manipuler vos opportunités, contacts, tâches, propositions et données de visiteurs du site. Le serveur MCP expose un ensemble de ces actions aux assistants compatibles. Une clé API pouvant lire et modifier les données de l'espace de travail, ne connectez que des outils de confiance.

Authentification

Chaque requête transmet une clé API de l'espace de travail dans l'en-tête Authorization :

Authorization: Bearer ta_live_...

Les administrateurs de l'espace de travail créent des clés depuis la page Paramètres de l'application (section API et MCP). Une clé n'est affichée qu'une seule fois à sa création et peut être révoquée à tout moment. Passer son créateur au rôle de membre révoque définitivement ses clés ; retirer le créateur invalide ses clés. Le promouvoir de nouveau ne restaure pas les anciennes clés. Les clés sont inutilisables tant que l'espace de travail est suspendu. Chaque clé agit au nom de l'administrateur qui l'a créée : les notes, tâches et événements lui sont attribués, et tout ce que la clé crée est visible dans tout l'espace de travail. L'API et le serveur MCP sont inclus dans Pro et Team. Créez et gérez vos clés dans Paramètres → API et MCP.

Les requêtes sans clé valide reçoivent un code 401. Un espace de travail avec l'offre Free reçoit un code 403.

URL de base

https://app.tinyant.io/api/v1

La plupart des corps de requête et des réponses utilisent le format JSON (UTF-8). L'import de propositions utilise des données de formulaire multipart, comme indiqué ci-dessous. Les identifiants se présentent sous la forme de_, co_, pe_, ta_ et no_ suivis de 12 caractères ; les identifiants de proposition comportent 12 caractères sans préfixe. Les horodatages sont exprimés en millisecondes Unix. Les points de terminaison ci-dessous décrivent l'interface d'intégration publiée. Utilisez les requêtes réseau de l'application comme exemples lorsqu'une charge utile complète n'est pas documentée ici.

Points de terminaison

Activités

Les points de terminaison de tâches enregistrent aussi les appels, réunions et relances pour les espaces de travail disposant de CRM Advanced avec Team, Enterprise ou un pilote actif. Envoyez activity_type (task, call, meeting ou follow_up), due_date (YYYY-MM-DD), due_time facultatif (HH:mm), timezone (nom IANA), duration_minutes (1 à 1440), assignee_id ainsi que deal_id, person_id ou company_id facultatifs. Les tâches définies uniquement à la journée conservent leur date calendaire. En l'absence de fuseau horaire, la préférence de l'utilisateur s'applique par défaut, puis celle de l'espace de travail, puis UTC. Une heure locale inexistante est rejetée ; une heure répétée exige occurrence: earlier ou later. Lisez une activité avant de la modifier et envoyez sa valeur revision ; les modifications obsolètes renvoient 409. Les clients existants peuvent omettre revision. La valeur null efface les champs facultatifs. Listez avec scope=mine, all ou unassigned, done=0, 1 ou all, les identifiants de fiches facultatifs, limit jusqu'à 500 et offset ; suivez next_offset lorsque has_more vaut true. Si l'accès à CRM Advanced prend fin, les activités typées existantes restent modifiables et réalisables, et la création de tâches simples reste disponible. Les activités ne passent pas d'appels, n'envoient pas de messages et n'invitent personne à des réunions. En terminer une ne marque ni une opportunité ni une proposition comme gagnée.

Consignez un contact par e-mail, SMS, LinkedIn ou autre sous la forme activity_type: follow_up avec contact_channel: email, sms, linkedin ou other (Advanced). Les notes d'activité acceptent jusqu'à 10 000 caractères. done: true enregistre la réalisation ; completed_date est au format YYYY-MM-DD, au plus tard aujourd'hui. Terminer un appel exige call_result: answered, no_answer ou busy. cancelled: true annule sans supprimer ; done et cancelled ne peuvent pas être tous deux à true. Listez avec status: open, done, cancelled ou all ; les activités annulées sont exclues des listes de travail ouvertes et des rapports d'activité.

Une écriture d'activité peut inclure next_activity: {title, due_date, activity_type, contact_channel, notes, assignee_id} ; la nouvelle fiche hérite de l'opportunité et sa date doit être aujourd'hui ou une date ultérieure. Les écritures combinées sur une fiche existante exigent revision. Les deux modifications sont validées de façon atomique. Un administrateur Advanced peut activer require_next_activity sur un pipeline. Une opportunité ouverte doit alors conserver une activité ouverte lorsque sa dernière activité est terminée, annulée, supprimée ou dissociée, ainsi qu'à la réouverture de l'opportunité. Créer ou déplacer une opportunité sans activité reste autorisé. L'exigence cesse de s'appliquer lorsque l'accès Advanced prend fin.

Les mises à jour d'opportunités Advanced peuvent inclure close_details avec status won ou lost et revision : close_date (au plus tard aujourd'hui), open_activities (keep ou cancel), notes facultatif, ainsi que won_reason pour les opportunités gagnées ou loss_category pour les opportunités perdues. Les catégories de perte sont price, timing, no_need, competitor, no_response, no_authority_or_budget, in_house, poor_fit et other. Le champ facultatif competitor s'applique à la catégorie competitor ; revisit_date doit être une date future et ne crée pas de rappel. Le statut won exige un montant d'opportunité positif. La clôture et toute annulation sont validées ensemble selon les droits d'accès actuels de la fiche. Pour rouvrir, envoyez status: open et, si nécessaire, next_activity. La réouverture efface les détails de clôture mais ne restaure pas les activités annulées. Les mises à jour historiques portant uniquement sur le statut restent prises en charge.

Exemples

Lister les opportunités ouvertes :

curl https://app.tinyant.io/api/v1/deals?status=open \
  -H "Authorization: Bearer ta_live_..."

Créer une opportunité et laisser Tiny Ant créer ou associer l'entreprise par son nom :

curl -X POST https://app.tinyant.io/api/v1/deals \
  -H "Authorization: Bearer ta_live_..." \
  -H "Content-Type: application/json" \
  -d '{"name": "Website redesign", "company_name": "Acme Ltd", "value": 12500}'

Tout ce qui s'est passé depuis un horodatage, par exemple pour synchroniser votre propre système :

curl "https://app.tinyant.io/api/v1/activity?since=1760000000000&limit=100" \
  -H "Authorization: Bearer ta_live_..."

Serveur MCP

Le serveur MCP (Model Context Protocol) est disponible à l'adresse :

https://app.tinyant.io/mcp

Le transport utilise Streamable HTTP, sans état, en JSON-RPC via POST. L'authentification utilise la même clé Bearer. Il n'y a pas de flux initiés par le serveur ; un simple client HTTP suffit.

Claude Code. Une ligne dans votre terminal, puis interrogez Claude sur vos opportunités :

claude mcp add --transport http tiny-ant https://app.tinyant.io/mcp --header "Authorization: Bearer ta_live_..."

Autres clients MCP. Utilisez un client prenant en charge Streamable HTTP et un en-tête Authorization personnalisé. Définissez l'URL du serveur sur l'adresse ci-dessus et la valeur de l'en-tête sur Bearer suivi de votre clé API. Vérifiez les options de connexion actuelles du client. Lorsqu'une prise en charge MCP directe n'est pas disponible, une intégration sur mesure peut appeler l'API REST. Tiny Ant ne fournit pas d'intégration prête à l'emploi pour chaque client.

OAuth. La connexion MCP publiée par Tiny Ant utilise actuellement une clé Bearer statique. Un client qui exige OAuth ne peut pas utiliser cette connexion directement. Vérifiez la compatibilité avant de choisir un client.

Outils MCP

Chaque outil appelle la même API que ci-dessus et renvoie la réponse JSON sous forme de texte.

Limites de débit et usage raisonnable

MCP accepte un message JSON-RPC par requête POST, jusqu'à 512 Kio. Les tableaux JSON sont rejetés sans exécuter aucun outil. Envoyez des requêtes distinctes. Les requêtes CRM autres que GET, y compris les imports, opérations groupées et aperçus de requêtes, partagent un quota supplémentaire de 120 requêtes par minute et par espace de travail entre l'application, l'API REST et MCP ; un refus renvoie 429 et Retry-After. Ces quotas périphériques sont locaux à un point de présence Cloudflare.

Des limites de stockage CRM d'usage raisonnable s'appliquent par table (opportunités, tâches et notes) : 500 avec Free, 20 000 avec Pro, 50 000 avec Team et Enterprise. Free comporte aussi une limite distincte de 10 opportunités ouvertes. Les tâches terminées et les opportunités clôturées comptent toujours dans les limites de stockage ; les fiches existantes sont conservées lors du passage à une offre inférieure.

Le volume accepté par Visitors est limité par espace de travail et par jour UTC : 5 000 pages vues avec Pro, 20 000 avec Team et 50 000 avec Enterprise. Le trafic excédentaire est ignoré ; la collecte reprend le lendemain. Le plafond quotidien s'appuie sur un compteur partagé en base de données ; la protection périphérique limite également une adresse source à 60 balises et une clé publique Visitors à 600 balises par minute et par point de présence Cloudflare. Une recherche ou une écriture échouée après réservation peut consommer un emplacement quotidien. Le quota ipapi.is du client est géré séparément.

Chaque clé peut effectuer 120 requêtes par minute sur l'ensemble de l'API REST et du serveur MCP, et chaque adresse 300 par minute. Les requêtes sans clé valide sont limitées à 30 par minute et par adresse. En cas de dépassement, vous recevez un code 429 accompagné d'un en-tête Retry-After ; patientez avant de réessayer. Interrogez /activity avec le paramètre since plutôt que de relire des listes entières, utilisez une clé distincte par intégration afin de pouvoir la révoquer séparément et ne partagez jamais de clé en dehors de votre espace de travail. Un espace de travail peut compter jusqu'à 10 clés actives.

Les règles d'automatisation CRM Advanced commencent par une simulation. Les limites sont fixées à 50 règles actives et 1 000 exécutions par période glissante de 24 heures et par espace de travail. La création d'opportunités et les changements d'étape sont mis en file d'attente de façon atomique. Les ouvertures externes confirmées de propositions sont limitées à une par proposition et par jour UTC. Les échéances d'opportunités au point mort disposent d'une fenêtre de rattrapage de sept jours. Les exécutions et notifications internes sont conservées 90 jours. Aucune donnée client n'est envoyée à un modèle d'IA ni à un service de messagerie externe.

Les administrateurs Advanced peuvent exécuter des rapports sur le pipeline ouvert, les opportunités gagnées/perdues et le taux de réussite, l'historique des étapes, les activités et les prévisions pondérées. Les dates sont exprimées en jours UTC inclusifs (jusqu'à 366) ; les activités planifiées utilisent leur propre date d'échéance. Les prévisions reposent sur les opportunités ouvertes actuelles et les probabilités des étapes, en séparant les opportunités sans date et les différentes devises. Les observations de référence ne constituent pas des entrées d'étapes historiques ni des durées connues. Les rapports personnels enregistrés conservent les paramètres choisis, et non des instantanés de résultats. Chaque exécution et chaque exploration détaillée applique les droits d'accès actuels aux fiches.

Avec CRM Advanced, l'accès aux fiches est contrôlé dans l'application, l'API REST, MCP et les exports. Les clés API et les webhooks n'accèdent par défaut qu'aux fiches partagées avec l'espace de travail, y compris les fiches parentes partagées. Un administrateur peut créer explicitement une intégration couvrant toutes les fiches de l'espace de travail, fiches privées comprises. Le périmètre est affiché dans les Paramètres. Les restrictions existantes restent en vigueur si l'accès Advanced prend fin. Les liens publics de propositions destinés aux destinataires demeurent un canal de partage distinct.

Webhooks

Si vous préférez que Tiny Ant appelle votre système, des webhooks sortants se configurent sur cette même page Paramètres. Ils envoient une requête POST JSON signée lorsqu'une proposition est ouverte, qu'une consultation se termine, qu'un statut change ou qu'une opportunité est créée ou change d'étape.

Questions

Écrivez à hello@tinyant.io. Les évolutions de l'API sont annoncées sur cette page.