- Accueil
- API de chatbot IA
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
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 :
- Créez le compte et ajoutez votre site pour que l'IA lise vos pages.
- Générez une clé d'API dans Paramètres, API (offres Starter, Standard et Pro).
- 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.
- 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.
- 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.
- 03
Envoyez la question
Un POST JSON avec
message. Ajoutez unsession_idstable par utilisateur pour garder le fil. - 04
Affichez la réponse
Lisez
response. Au premier message d'une session, affichez aussiai_disclosure, la mention qui signale une réponse d'IA.
<?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 ProVos 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.
Réponse tirée d'un article d'aide, affichée dans l'espace apprenant.
La liste vient d'un PDF remis par l'agence. Le session_id est l'identifiant du compte client.
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.
- 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. - 02
Attendre qu'il soit prêt
GET /websites/{id}/indique l'état de l'exploration et des instructions. Le champreadypasse à true quand tout est terminé. - 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. - 04
Ajuster les instructions
PUT /websites/{id}/instructions/remplace le texte. Envoyez laversionlue : 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.