1. Accueil
  2. API de chatbot IA
Guide Mis à jour en novembre 2026

API de chatbot IA : les réponses, sans l'infrastructure

Construire soi-même un assistant qui répond à partir de ses propres documents demande un index, une recherche, un historique et beaucoup de maintenance. Avec l'API REST d'Asyntai, votre logiciel envoie une question et reçoit une réponse en JSON. Le reste est déjà fait.

  • 50 réponses IA par mois offertes
  • Une seule requête HTTPS
  • Sans carte bancaire
La réponse courte

Comment fonctionne l'API de chatbot IA d'Asyntai ?

Votre serveur envoie la question de l'utilisateur à POST https://asyntai.com/api/v1/chat/, avec votre clé dans l'en-tête Authorization. Asyntai cherche la réponse dans le contenu de votre compte et la renvoie en JSON. Trois étapes suffisent :

  1. Créez le compte et ajoutez votre site pour que l'IA lise vos pages.
  2. Générez une clé d'API dans Paramètres, API (offres Starter, Standard et Pro).
  3. Envoyez la première question depuis votre serveur et affichez le champ response.

Chatbot à scénarios, RAG maison ou API : que choisir ?

Pour ajouter un assistant à un logiciel, une équipe technique hésite souvent entre trois approches. Elles se distinguent surtout par ce qu'il faut construire et entretenir dans la durée.

Chatbot à scénariosarbre de décision RAG maisonindex + modèle de langage API REST d'Asyntaila réponse prête à afficher
Questions comprises Celles prévues dans le scénario, via des boutons ou des mots-clés. Les questions libres, selon la qualité de votre recherche. Les questions libres, en langage courant.
À construire Chaque branche du dialogue, à la main. Découpage, index, recherche, prompts, historique. Une requête HTTPS et votre interface.
Mise à jour du contenu Réécrire les scénarios concernés. Réindexer les documents modifiés. Nouvelle exploration du site, ou endpoints /knowledge/.
Suivi des échanges Selon l'outil. À développer vous-même. Historique dans le tableau de bord et via l'API.
Coût Licence de l'outil et temps de rédaction. Hébergement, facturation au token, temps de développement. Prix mensuel fixe, dès l'offre Starter.

Chatbot à scénarios

Questions comprises
Celles prévues dans le scénario, via des boutons ou des mots-clés.
À construire
Chaque branche du dialogue, à la main.
Mise à jour du contenu
Réécrire les scénarios concernés.
Suivi des échanges
Selon l'outil.
Coût
Licence de l'outil et temps de rédaction.

RAG maison

Questions comprises
Les questions libres, selon la qualité de votre recherche.
À construire
Découpage, index, recherche, prompts, historique.
Mise à jour du contenu
Réindexer les documents modifiés.
Suivi des échanges
À développer vous-même.
Coût
Hébergement, facturation au token, temps de développement.

API REST d'Asyntai

Questions comprises
Les questions libres, en langage courant.
À construire
Une requête HTTPS et votre interface.
Mise à jour du contenu
Nouvelle exploration du site, ou endpoints /knowledge/.
Suivi des échanges
Historique dans le tableau de bord et via l'API.
Coût
Prix mensuel fixe, dès l'offre Starter.

Un RAG maison reste pertinent si vous devez maîtriser chaque brique. Si votre objectif est un assistant fiable dans votre produit, l'API vous évite de maintenir toute la chaîne.

Comment faire un premier appel en PHP

L'URL de base est https://asyntai.com/api/v1/. L'endpoint de chat attend un JSON avec un champ obligatoire, message, et deux champs facultatifs : session_id et website_id.

  1. 01

    Vérifiez les réponses

    Créez le compte gratuit, ajoutez votre site et posez dans le tableau de bord les questions de vos utilisateurs. Complétez le contenu si besoin.

  2. 02

    Créez la clé

    Avec une offre payante, ouvrez Paramètres, API. Stockez la clé dans une variable d'environnement du serveur, jamais dans le code client.

  3. 03

    Envoyez la question

    Un POST JSON avec message. Ajoutez un session_id stable par utilisateur pour garder le fil.

  4. 04

    Affichez la réponse

    Lisez response. Au premier message d'une session, affichez aussi ai_disclosure, la mention qui signale une réponse d'IA.

PHP avec cURL
<?php
$ch = curl_init("https://asyntai.com/api/v1/chat/");
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        "Authorization: Bearer " . getenv("ASYNTAI_API_KEY"),
        "Content-Type: application/json",
    ],
    CURLOPT_POSTFIELDS => json_encode([
        "message"    => "Livrez-vous en Corse ?",
        "session_id" => "revendeur_" . $revendeurId,
    ]),
]);
$data = json_decode(curl_exec($ch), true);
echo $data["success"] ? $data["response"] : $data["error"];

L'en-tête X-API-Key fonctionne aussi. La liste complète des champs et des codes d'erreur se trouve dans la référence de l'API.

Codes à prévoir : 401 si la clé manque ou n'est pas valide, 403 si le compte est sur l'offre gratuite, 429 quand les réponses IA du mois sont épuisées, 503 si l'IA ne peut pas répondre à ce moment-là. Dans ce dernier cas, renvoyez la requête un peu plus tard.

Synchroniser la base de connaissances depuis votre logiciel

Vos tarifs, vos conditions ou vos fiches changent dans votre propre système ? L'API permet de pousser ces changements vers l'assistant, sans passer par le tableau de bord.

Lister

GET /knowledge/

Renvoie les entrées de la base de connaissances avec leur identifiant, leur type et leur titre. Pratique pour savoir ce que l'assistant connaît déjà.

Ajouter du texte

POST /knowledge/text/

Un titre et un contenu, par exemple une nouvelle procédure de retour. Le texte est disponible pour les réponses suivantes.

Ajouter une page

POST /knowledge/url/

Envoyez l'adresse d'une page publiée : Asyntai récupère et extrait le contenu. Idéal juste après la mise en ligne d'un article d'aide.

Ajouter un tableau

POST /knowledge/spreadsheet/

Un fichier CSV ou Excel dont chaque ligne devient une entrée : grille tarifaire, liste de références, horaires par agence.

Supprimer

DELETE /knowledge/{id}/

Retire une entrée devenue fausse, par exemple une ancienne grille de prix, pour que l'assistant ne la cite plus.

Les ajouts par l'API sont soumis à un plafond quotidien de caractères qui dépend de l'offre. Si vous avez plusieurs sites, précisez website_id, sinon le site principal est utilisé.

D'où viennent les réponses renvoyées par l'API

Inutile d'envoyer vos documents à chaque requête. Pour chaque question, Asyntai cherche les passages pertinents dans la base de connaissances du compte et rédige la réponse à partir d'eux.

Exploration du site

Le robot suit vos liens et lit le texte de chaque page.

URL isolées

Une page précise, ajoutée à la main ou par l'API.

Fichiers PDF

CGV, notices, catalogues, y compris les PDF scannés.

Tableurs

CSV ou Excel, une ligne par entrée.

Texte libre

Les informations absentes du site, saisies ou envoyées par l'API.

Fichiers HTML

Pages enregistrées et documents HTML.

Vidéos

L'IA répond à partir de la transcription.

Real-Time Data Feed

Des données qui changent souvent, comme les stocks.

Standard et Pro

Vos instructions fixent le ton, les sujets autorisés et la conduite à tenir quand l'information manque. Elles s'appliquent au widget comme à l'API. Chaque source est décrite dans le guide de la base de connaissances.

Exemples d'intégration de l'API

Trois projets concrets. Votre application gère l'écran et l'identité de l'utilisateur ; Asyntai fournit la réponse.

Plateforme de formation
Mon attestation de fin de formation, je la trouve où ?
Elle apparaît dans Mon espace, onglet Documents, dès que tous les modules sont validés. Vous pouvez la télécharger en PDF.

Réponse tirée d'un article d'aide, affichée dans l'espace apprenant.

Application d'agence immobilière
Quels documents faut-il pour déposer un dossier de location ?
Une pièce d'identité, vos trois derniers bulletins de salaire, votre dernier avis d'imposition et un justificatif de domicile.

La liste vient d'un PDF remis par l'agence. Le session_id est l'identifiant du compte client.

Logiciel de SAV
Le lave-linge affiche E21, que dire au client ?
E21 signale un problème de vidange. Faites vérifier le filtre de la pompe en bas à droite, puis lancer un essorage seul.

Les techniciens interrogent un tableau Excel des codes erreur, envoyé par /knowledge/spreadsheet/.

Créer un assistant pour chacun de vos clients

Agences web et éditeurs de logiciels peuvent préparer un assistant par client sans ouvrir le tableau de bord. Quatre appels couvrent tout le parcours.

  1. 01

    Créer l'agent

    POST /websites/ avec le domaine du client. Asyntai lit le site et rédige un premier jet des instructions. La réponse contient l'identifiant du widget et le code à intégrer.

  2. 02

    Attendre qu'il soit prêt

    GET /websites/{id}/ indique l'état de l'exploration et des instructions. Le champ ready passe à true quand tout est terminé.

  3. 03

    Régler le widget

    PATCH /websites/{id}/settings/ change le nom de l'assistant, la couleur ou le message d'accueil. Seuls les réglages envoyés sont modifiés.

  4. 04

    Ajuster les instructions

    PUT /websites/{id}/instructions/ remplace le texte. Envoyez la version lue : si quelqu'un a modifié entre-temps, l'écriture est refusée au lieu d'écraser son travail.

Le nombre de sites dépend de l'offre : 2 en Starter, 3 en Standard et 20 en Pro. Chaque site garde sa propre base de connaissances et son propre historique.

Offres et tarifs avec accès à l'API

L'API est incluse dans toutes les offres payantes, pour un prix mensuel fixe. Chaque réponse obtenue par l'API compte comme une réponse IA de l'offre.

Free

0 USD /mois
  • 50 réponses IA par mois
  • 1 site
  • Tests dans le tableau de bord

Starter

39 USD /mois
  • 800 réponses IA par mois
  • 2 sites
  • API REST et webhooks

Standard

139 USD /mois
  • 15 000 réponses IA par mois
  • 3 sites
  • Real-Time Data Feed

Pro

449 USD /mois
  • 50 000 réponses IA par mois
  • 20 sites
  • Sans la marque Asyntai

Le détail des fonctions par offre se trouve sur la page des tarifs.

Questions fréquentes sur l'API de chatbot IA

Quelle offre faut-il pour utiliser l'API ?

L'API REST est incluse dans les offres Starter, Standard et Pro. L'offre gratuite permet de créer le compte, d'ajouter votre site et de tester les réponses dans le tableau de bord, mais un appel à l'API renvoie le code 403.

Faut-il une base vectorielle ou un modèle de langage de mon côté ?

Non. Asyntai lit votre site, découpe et indexe le contenu, cherche les bons passages et rédige la réponse. Votre code envoie seulement la question et affiche le texte reçu.

Comment authentifier les requêtes ?

Avec votre clé d'API, dans l'en-tête Authorization au format Bearer suivi de la clé, ou dans l'en-tête X-API-Key. La clé se crée dans le tableau de bord, dans Paramètres puis API.

Comment garder le fil d'une conversation ?

Envoyez le même session_id pour tous les messages d'un même utilisateur. L'IA tient alors compte des messages précédents de cette session pour comprendre la question suivante.

Puis-je mettre à jour la base de connaissances depuis mon logiciel ?

Oui. Les endpoints /knowledge/text/, /knowledge/url/ et /knowledge/spreadsheet/ ajoutent du texte, une page web ou un fichier CSV ou Excel, et DELETE /knowledge/{id}/ supprime une entrée. Un plafond quotidien de caractères s'applique selon l'offre.

Puis-je créer un assistant pour chacun de mes clients ?

Oui. POST /websites/ crée un nouvel agent à partir d'un domaine, lit le site et rédige un premier jet des instructions. La réponse contient l'identifiant du widget et le code à intégrer. Le nombre de sites dépend de l'offre : 2 en Starter, 3 en Standard, 20 en Pro.

Dans quelle langue l'API répond-elle ?

Dans la langue de la question. Un utilisateur qui écrit en français reçoit une réponse en français, un utilisateur qui écrit en anglais ou en allemand reçoit une réponse dans sa langue.

Que se passe-t-il quand le quota mensuel est atteint ?

L'API renvoie le code 429 avec limit_reached à true. Chaque réponse obtenue par l'API compte comme une réponse IA de votre offre, exactement comme dans le widget.

Un assistant dans votre logiciel, sans pipeline à maintenir

Créez le compte gratuitement, vérifiez les réponses dans le tableau de bord, puis branchez l'API.