accueil / serveurs / Recherche & Web / com.asyntai/support-agent
com.asyntai/support-agent
serveur MCP (Model Context Protocol) · asyntai 1.0.0
Référencé dans l'annuaire. Seul le pentest comportemental fait foi, et il n'a pas encore été exécuté sur ce serveur.
Est-ce que com.asyntai/support-agent est sûr ?
Au dernier audit MCP Hub, le serveur MCP « com.asyntai/support-agent » est classé « Non encore testé ». Référencé dans l'annuaire. Seul le pentest comportemental fait foi, et il n'a pas encore été exécuté sur ce serveur. Le verdict est réévalué en continu ; consultez la fiche pour l'état à jour.
Méthode : MCP Hub analyse la description de chaque outil (couche 1) et, pour le verdict fort, exécute le serveur dans une micro-VM isolée avec leurres et réseau bloqué (couche 2). On publie des noms et des compteurs, jamais le contenu brut renvoyé par un outil.
Les 55 outils
- add_image≈ 215 tokens
Add an image the chatbot may show. The description is what the AI reads to decide when the image answers the question, so describe what it shows and when it helps.
Paramètres, retour & exemple (3)
Paramètresimage_url· string · requis
Address of the image.website_id· integer · optionnel
Numeric id of the website, from list_websites. Omit to use the account's primary website.description· string · requis
What the image shows and when the chatbot should send it.
Exemple d'appel{"name": "add_image", "arguments": {"image_url": "texte", "description": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - add_knowledge_text≈ 217 tokens
Add a titled block of text to one website's knowledge base. The chatbot can use it in answers as soon as this returns. Adds a new entry; it never replaces an existing one.
Paramètres, retour & exemple (3)
Paramètrestitle· string · requis
Short name for this entry, shown in the dashboard.content· string · requis
The text itself. At least 10 characters.website_id· integer · optionnel
Numeric id of the website, from list_websites. Omit to use the account's primary website.
Exemple d'appel{"name": "add_knowledge_text", "arguments": {"title": "texte", "content": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - add_knowledge_url≈ 181 tokens
Fetch one web page and add its text to the knowledge base. Use this for a single page. To take in a whole site, use start_crawl instead.
Paramètres, retour & exemple (2)
Paramètresurl· string · requis
Full address of the page, including https://.website_id· integer · optionnel
Numeric id of the website, from list_websites. Omit to use the account's primary website.
Exemple d'appel{"name": "add_knowledge_url", "arguments": {"url": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - add_product≈ 235 tokens
Add a product the chatbot can show as a card. Needs the Standard plan or higher.
Paramètres, retour & exemple (6)
Paramètresname· string · requis
Product name.price· string · optionnel
Price as text, for example 29 EUR.image_url· string · optionnel
Address of the product image.website_id· integer · optionnel
Numeric id of the website, from list_websites. Omit to use the account's primary website.description· string · optionnel
Short description shown on the card.product_link· string · optionnel
Address of the product page.
Exemple d'appel{"name": "add_product", "arguments": {"name": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - add_webhook≈ 204 tokens
Register a URL to receive events, for example every new message. Returns a signing secret once; store it, because it is never shown again. Needs a paid plan.
Paramètres, retour & exemple (3)
Paramètresurl· string · requis
HTTPS address that will receive the events.events· array · requis
Event names to subscribe to.website_id· integer · optionnel
Numeric id of the website, from list_websites. Omit to use the account's primary website.
Exemple d'appel{"name": "add_webhook", "arguments": {"url": "texte", "events": []}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - ask_ai≈ 234 tokens
Ask one website's chatbot a question and get the answer a real visitor would receive. Use this to test the bot. It spends one message from the account's monthly allowance, and it calls an external model provider.
Paramètres, retour & exemple (3)
Paramètresmessage· string · requis
The question to ask, as a visitor would type it.session_id· string · optionnel
Reuse the same value across calls to continue one test conversation. Omit to start a fresh one.website_id· integer · optionnel
Numeric id of the website, from list_websites. Omit to use the account's primary website.
Exemple d'appel{"name": "ask_ai", "arguments": {"message": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - create_website≈ 210 tokens
Add a new website (a new AI agent) to the account and return its embed code. Each plan allows a limited number of websites, and this refuses once that limit is reached. By default it also starts a crawl of the site to build the knowledge base.
Paramètres, retour & exemple (3)
Paramètresname· string · optionnel
Display name for this agent. Optional.crawl· boolean · optionnel
Crawl the site after adding it. True by default.domain· string · requis
The website address, for example shop.example.com.
Exemple d'appel{"name": "create_website", "arguments": {"domain": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - delete_image≈ 112 tokens
Remove one image so the chatbot stops showing it.
Paramètres, retour & exemple (1)
Paramètresimage_id· integer · requis
Image id from list_images.
Exemple d'appel{"name": "delete_image", "arguments": {"image_id": 1}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - delete_knowledge_entry≈ 148 tokens
Permanently delete one knowledge base entry and every passage built from it. The chatbot stops using that content immediately. This cannot be undone.
Paramètres, retour & exemple (1)
Paramètresentry_id· string · requis
The entry id from list_knowledge.
Exemple d'appel{"name": "delete_knowledge_entry", "arguments": {"entry_id": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - delete_product≈ 118 tokens
Remove one product so the chatbot stops offering it.
Paramètres, retour & exemple (1)
Paramètresproduct_id· integer · requis
Product id from list_products.
Exemple d'appel{"name": "delete_product", "arguments": {"product_id": 1}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - delete_webhook≈ 118 tokens
Delete one webhook. Events stop reaching that address at once.
Paramètres, retour & exemple (1)
Paramètreswebhook_id· string · requis
The webhook id from list_webhooks.
Exemple d'appel{"name": "delete_webhook", "arguments": {"webhook_id": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - get_account≈ 104 tokens
Get the signed-in account's email, plan, and how many chat messages it has used against its monthly allowance.
Paramètres, retour & exemple (0)
Exemple d'appel{"name": "get_account", "arguments": {}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - get_ai_instructions≈ 138 tokens
Get the instructions that shape how one website's chatbot answers: its role, tone and rules.
Paramètres, retour & exemple (1)
Paramètreswebsite_id· integer · optionnel
Numeric id of the website, from list_websites. Omit to use the account's primary website.
Exemple d'appel{"name": "get_ai_instructions", "arguments": {"website_id": 1}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - get_analytics≈ 178 tokens
Summarise one website's chat activity over a period: conversations, messages, leads captured, escalations, and the countries visitors came from.
Paramètres, retour & exemple (2)
Paramètresdays· integer · optionnel
How many days back to measure (1-90, default 30).website_id· integer · optionnel
Numeric id of the website, from list_websites. Omit to use the account's primary website.
Exemple d'appel{"name": "get_analytics", "arguments": {"days": 1, "website_id": 1}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - get_asyntai_doc≈ 142 tokens
Read one page of Asyntai's documentation in full, given the url or slug from search_asyntai_docs, for example /documentation/mcp/ or just mcp.
Paramètres, retour & exemple (1)
Paramètrespage· string · requis
The url or slug of the page to read.
Exemple d'appel{"name": "get_asyntai_doc", "arguments": {"page": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - get_conversation≈ 159 tokens
Read the full message history of one conversation, in order, from its session id.
Paramètres, retour & exemple (2)
Paramètreslimit· integer · optionnel
How many messages to return (1-200, default 100).session_id· string · requis
Session id from list_conversations.
Exemple d'appel{"name": "get_conversation", "arguments": {"session_id": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - get_daily_report≈ 139 tokens
Say whether the daily email summary is on for one website, and when the last one went out.
Paramètres, retour & exemple (1)
Paramètreswebsite_id· integer · optionnel
Numeric id of the website, from list_websites. Omit to use the account's primary website.
Exemple d'appel{"name": "get_daily_report", "arguments": {"website_id": 1}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - get_knowledge_entry≈ 167 tokens
Read the stored text of one knowledge base entry. Works for the content you supplied: text, documents, spreadsheets, single pages and videos. A website crawl is listed but not exported, because the source is your own public site.
Paramètres, retour & exemple (1)
Paramètresentry_id· string · requis
The entry id from list_knowledge.
Exemple d'appel{"name": "get_knowledge_entry", "arguments": {"entry_id": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - get_website≈ 138 tokens
Get the full record for one website: its name, domain, platform, widget id and the embed code to paste into the site.
Paramètres, retour & exemple (1)
Paramètreswebsite_id· integer · optionnel
Numeric id of the website, from list_websites. Omit to use the account's primary website.
Exemple d'appel{"name": "get_website", "arguments": {"website_id": 1}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - get_website_features≈ 205 tokens
Read the plan-gated features for one website: Real-Time Data Feed and its Max tier, Product Cards, Dynamic Images, User Context, Link Parameters, Chat Retention, Chat Categories, Access Tags, Widget Pinning, Zero Retention, PII Redaction and the Output Classifier. Shows current values, which features the plan allows, and the plan each locked feature needs.
Paramètres, retour & exemple (1)
Paramètreswebsite_id· integer · optionnel
Numeric id of the website, from list_websites. Omit to use the account's primary website.
Exemple d'appel{"name": "get_website_features", "arguments": {"website_id": 1}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - get_widget_settings≈ 181 tokens
Read all appearance and behaviour settings for one website's chat widget: colours, greeting, position, auto-trigger, data collection, bookings and the rest. Also returns which settings this account's plan cannot change, and the plan each of those needs.
Paramètres, retour & exemple (1)
Paramètreswebsite_id· integer · optionnel
Numeric id of the website, from list_websites. Omit to use the account's primary website.
Exemple d'appel{"name": "get_widget_settings", "arguments": {"website_id": 1}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - list_active_sessions≈ 200 tokens
List the visitors currently in a chat: which page they are on, their country, how long they have been there, and whether a human has taken the conversation over. Needs the Standard plan or higher.
Paramètres, retour & exemple (2)
Paramètreslimit· integer · optionnel
How many sessions to return (1-100, default 25).website_id· integer · optionnel
Numeric id of the website, from list_websites. Omit to use the account's primary website.
Exemple d'appel{"name": "list_active_sessions", "arguments": {"limit": 1, "website_id": 1}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - list_audit_log≈ 190 tokens
Read the record of what changed on this account: who did it, when, and from where. Recorded on the Enterprise plan only.
Paramètres, retour & exemple (3)
Paramètresdays· integer · optionnel
How many days back to read (1-90, default 30).limit· integer · optionnel
How many entries to return (1-100, default 50).category· string · optionnel
Only entries in this category. Optional.
Exemple d'appel{"name": "list_audit_log", "arguments": {"days": 1, "limit": 1, "category": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - list_booking_types≈ 148 tokens
List the appointment types visitors can book, with length, price and how many spots each has. Bookings needs the Standard plan or higher.
Paramètres, retour & exemple (1)
Paramètreswebsite_id· integer · optionnel
Numeric id of the website, from list_websites. Omit to use the account's primary website.
Exemple d'appel{"name": "list_booking_types", "arguments": {"website_id": 1}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - list_conversations≈ 246 tokens
List recent visitor conversations for one website, newest first, with the session id, message count and any email or phone the visitor gave.
Paramètres, retour & exemple (4)
Paramètresdays· integer · optionnel
How many days back to look (1-90, default 7).limit· integer · optionnel
How many conversations to return (1-100, default 20).website_id· integer · optionnel
Numeric id of the website, from list_websites. Omit to use the account's primary website.with_leads_only· boolean · optionnel
Only return conversations where the visitor left an email or phone.
Exemple d'appel{"name": "list_conversations", "arguments": {"days": 1, "limit": 1, "website_id": 1, "with_leads_only": true}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - list_crawls≈ 166 tokens
List recent crawl jobs for one website with their status, how many pages they took, and why each one stopped.
Paramètres, retour & exemple (2)
Paramètreslimit· integer · optionnel
How many jobs to return (1-50, default 10).website_id· integer · optionnel
Numeric id of the website, from list_websites. Omit to use the account's primary website.
Exemple d'appel{"name": "list_crawls", "arguments": {"limit": 1, "website_id": 1}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - list_embeds≈ 141 tokens
List the third-party tools embedded in the chat, such as a booking calendar or a form. Embeds needs the Standard plan or higher.
Paramètres, retour & exemple (1)
Paramètreswebsite_id· integer · optionnel
Numeric id of the website, from list_websites. Omit to use the account's primary website.
Exemple d'appel{"name": "list_embeds", "arguments": {"website_id": 1}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - list_images≈ 147 tokens
List the images the chatbot may show a visitor, with the description that tells it when each one is relevant.
Paramètres, retour & exemple (1)
Paramètreswebsite_id· integer · optionnel
Numeric id of the website, from list_websites. Omit to use the account's primary website.
Exemple d'appel{"name": "list_images", "arguments": {"website_id": 1}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - list_knowledge≈ 172 tokens
List the sources in one website's knowledge base: uploaded text, documents, added pages and crawls.
Paramètres, retour & exemple (2)
Paramètreslimit· integer · optionnel
How many entries to return (1-100, default 50).website_id· integer · optionnel
Numeric id of the website, from list_websites. Omit to use the account's primary website.
Exemple d'appel{"name": "list_knowledge", "arguments": {"limit": 1, "website_id": 1}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - list_knowledge_gaps≈ 250 tokens
List the Knowledge Gaps Asyntai recorded: real visitor questions the chatbot could not answer. Use this to find what to fill in with add_knowledge_text. Needs the Standard plan or higher.
Paramètres, retour & exemple (4)
Paramètresdays· integer · optionnel
How many days back to look (1-90, default 30).limit· integer · optionnel
How many gaps to return (1-100, default 25).website_id· integer · optionnel
Numeric id of the website, from list_websites. Omit to use the account's primary website.include_resolved· boolean · optionnel
Include gaps already marked as resolved. Off by default.
Exemple d'appel{"name": "list_knowledge_gaps", "arguments": {"days": 1, "limit": 1, "website_id": 1, "include_resolved": true}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - list_leads≈ 168 tokens
List the email addresses and phone numbers visitors left in chat, newest first, with the page they were on.
Paramètres, retour & exemple (2)
Paramètreslimit· integer · optionnel
How many leads to return (1-100, default 50).website_id· integer · optionnel
Numeric id of the website, from list_websites. Omit to use the account's primary website.
Exemple d'appel{"name": "list_leads", "arguments": {"limit": 1, "website_id": 1}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - list_plans≈ 124 tokens
List every Asyntai plan with its price, monthly message allowance and the features it includes, alongside the plan this account is on. Use it to explain which plan includes a feature the account asks about.
Paramètres, retour & exemple (0)
Exemple d'appel{"name": "list_plans", "arguments": {}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - list_products≈ 143 tokens
List the products the chatbot can show as cards, with price and links. Product Cards needs the Standard plan or higher.
Paramètres, retour & exemple (1)
Paramètreswebsite_id· integer · optionnel
Numeric id of the website, from list_websites. Omit to use the account's primary website.
Exemple d'appel{"name": "list_products", "arguments": {"website_id": 1}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - list_team_members≈ 100 tokens
List the people who share this account, what each may reach, and how many seats the plan allows.
Paramètres, retour & exemple (0)
Exemple d'appel{"name": "list_team_members", "arguments": {}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - list_tickets≈ 201 tokens
List support tickets raised from chat, with status, priority and the visitor's details. Needs the Standard plan or higher.
Paramètres, retour & exemple (3)
Paramètreslimit· integer · optionnel
How many tickets to return (1-100, default 25).status· string · optionnel
Only tickets with this status, for example open or resolved.website_id· integer · optionnel
Numeric id of the website, from list_websites. Omit to use the account's primary website.
Exemple d'appel{"name": "list_tickets", "arguments": {"limit": 1, "status": "texte", "website_id": 1}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - list_visitor_questions≈ 314 tokens
List what visitors asked the chatbot in a period: the first questions of each conversation, without the chatbot's answers. Use this to find what customers ask about most: group the questions by meaning and give examples. Counts you make by grouping are estimates; say so. When Chat Categories is on, the result also carries exact chat counts per category. To read one conversation in full, use get_conversation.
Paramètres, retour & exemple (4)
Paramètresdays· integer · optionnel
How many days back to look (1-90, default 30).limit· integer · optionnel
Most questions to return (1-500, default 300).per_chat· integer · optionnel
Questions taken from each conversation (1-5, default 2).website_id· integer · optionnel
Numeric id of the website, from list_websites. Omit to use the account's primary website.
Exemple d'appel{"name": "list_visitor_questions", "arguments": {"days": 1, "limit": 1, "per_chat": 1, "website_id": 1}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - list_webhooks≈ 106 tokens
List the webhooks registered on this account. The signing secret is never returned; it is shown once, when the webhook is created.
Paramètres, retour & exemple (0)
Exemple d'appel{"name": "list_webhooks", "arguments": {}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - list_websites≈ 109 tokens
List the websites (AI agents) on this Asyntai account, with the id every other tool takes. Start here when the account may have more than one.
Paramètres, retour & exemple (0)
Exemple d'appel{"name": "list_websites", "arguments": {}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - list_widget_translations≈ 145 tokens
List the languages the chat widget has its own wording for, with the greeting and agent name used in each.
Paramètres, retour & exemple (1)
Paramètreswebsite_id· integer · optionnel
Numeric id of the website, from list_websites. Omit to use the account's primary website.
Exemple d'appel{"name": "list_widget_translations", "arguments": {"website_id": 1}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - release_conversation≈ 138 tokens
Hand a taken-over conversation back to the AI, which answers the visitor again from the next message.
Paramètres, retour & exemple (1)
Paramètressession_id· string · requis
Session id of the conversation.
Exemple d'appel{"name": "release_conversation", "arguments": {"session_id": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - search_asyntai_docs≈ 248 tokens
Search Asyntai's own product documentation and get back the pages that match, with a short excerpt from each. Use this to find out how a feature works before changing anything, rather than guessing. This searches Asyntai's documentation, NOT the customer's own content: for that, use search_knowledge_base. Matching is by keyword, so if the results look wrong, search again using Asyntai's own feature names, for example data feed, widget pinning, access tags, AI instructions.
Paramètres, retour & exemple (2)
Paramètreslimit· integer · optionnel
How many pages to return, 1 to 20. Default 8.query· string · requis
What to look for.
Exemple d'appel{"name": "search_asyntai_docs", "arguments": {"query": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - search_knowledge_base≈ 238 tokens
Search one website's knowledge base and return the passages the chatbot would retrieve for this question, with a relevance score. Use this to check what the chatbot knows about a topic. It does not generate an answer and does not use the message allowance.
Paramètres, retour & exemple (3)
Paramètreslimit· integer · optionnel
How many passages to return (1-20, default 5).query· string · requis
What to look for, in plain language.website_id· integer · optionnel
Numeric id of the website, from list_websites. Omit to use the account's primary website.
Exemple d'appel{"name": "search_knowledge_base", "arguments": {"query": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - send_agent_reply≈ 218 tokens
Send a message, as a human agent, to a real visitor who is chatting right now. Take the conversation over first. The visitor sees this immediately, so show the user the exact wording and get their agreement before calling this.
Paramètres, retour & exemple (3)
Paramètresmessage· string · requis
The text to send to the visitor.agent_name· string · optionnel
Name shown to the visitor. Defaults to the account's agent name.session_id· string · requis
Session id of the conversation.
Exemple d'appel{"name": "send_agent_reply", "arguments": {"message": "texte", "session_id": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - set_access_tags≈ 180 tokens
Switch Access Tags on or off for one website. Turning it on creates the signing secret your server needs to sign visitor entitlements. Needs the Enterprise plan.
Paramètres, retour & exemple (2)
Paramètresenabled· boolean · requis
True to switch it on.website_id· integer · optionnel
Numeric id of the website, from list_websites. Omit to use the account's primary website.
Exemple d'appel{"name": "set_access_tags", "arguments": {"enabled": true}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - set_daily_report≈ 167 tokens
Turn the daily email summary of chats on or off for one website. Needs the Standard plan or higher.
Paramètres, retour & exemple (2)
Paramètresenabled· boolean · requis
True to switch it on.website_id· integer · optionnel
Numeric id of the website, from list_websites. Omit to use the account's primary website.
Exemple d'appel{"name": "set_daily_report", "arguments": {"enabled": true}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - set_data_feed≈ 228 tokens
Point the chatbot at a product feed and index it. This fetches the feed, checks it really is a feed, clears whatever was indexed before, and rebuilds the index in the background. Send an empty url to remove the feed. Needs the Standard plan or higher.
Paramètres, retour & exemple (3)
Paramètresurl· string · requis
Address of the product feed. Empty removes it.enabled· boolean · optionnel
Whether the chatbot may use the feed.website_id· integer · optionnel
Numeric id of the website, from list_websites. Omit to use the account's primary website.
Exemple d'appel{"name": "set_data_feed", "arguments": {"url": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - set_data_feed_max≈ 214 tokens
Same as set_data_feed, for the Max tier, which indexes a larger catalogue. Fetches, validates, clears the old index and rebuilds it in the background. Needs the Pro plan or higher.
Paramètres, retour & exemple (3)
Paramètresurl· string · requis
Address of the product feed. Empty removes it.enabled· boolean · optionnel
Whether the chatbot may use the feed.website_id· integer · optionnel
Numeric id of the website, from list_websites. Omit to use the account's primary website.
Exemple d'appel{"name": "set_data_feed_max", "arguments": {"url": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - set_knowledge_tags≈ 204 tokens
Restrict who can retrieve one knowledge base entry. A visitor must present a matching tag, signed by your own server, before the chatbot will use the entry. Send an empty list to make it public again. Access Tags needs the Enterprise plan.
Paramètres, retour & exemple (2)
Paramètresentry_id· string · requis
The entry id from list_knowledge.access_tags· array · requis
Tag names. An empty list makes the entry public.
Exemple d'appel{"name": "set_knowledge_tags", "arguments": {"entry_id": "texte", "access_tags": []}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - set_widget_pinning≈ 192 tokens
Freeze the chat widget at its current version, so the site always serves the same copy with an integrity hash. Turning it on builds that snapshot and changes the embed code. Needs the Enterprise plan.
Paramètres, retour & exemple (2)
Paramètresenabled· boolean · requis
True to pin the widget.website_id· integer · optionnel
Numeric id of the website, from list_websites. Omit to use the account's primary website.
Exemple d'appel{"name": "set_widget_pinning", "arguments": {"enabled": true}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - set_widget_translation≈ 261 tokens
Set the chat widget's greeting, agent name and bubble text for one language. A visitor in that language sees this wording instead of the default.
Paramètres, retour & exemple (5)
Paramètreswebsite_id· integer · optionnel
Numeric id of the website, from list_websites. Omit to use the account's primary website.language_code· string · requis
Language code, for example de or fr.ai_support_name· string · optionnel
Agent name shown in the header.initial_message· string · optionnel
The greeting the visitor sees first.notification_bubble_text· string · optionnel
Text of the notification bubble.
Exemple d'appel{"name": "set_widget_translation", "arguments": {"language_code": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - start_crawl≈ 225 tokens
Crawl a website and add its pages to the knowledge base. Runs in the background; check on it with list_crawls. Each plan caps the pages per crawl, and asking for more than the cap is refused.
Paramètres, retour & exemple (3)
Paramètresmax_pages· integer · optionnel
How many pages to take at most. Capped by the plan.start_url· string · optionnel
Where to start. Defaults to the website's own domain.website_id· integer · optionnel
Numeric id of the website, from list_websites. Omit to use the account's primary website.
Exemple d'appel{"name": "start_crawl", "arguments": {"max_pages": 1, "start_url": "texte", "website_id": 1}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - take_over_conversation≈ 169 tokens
Stop the AI answering one conversation so a human can reply instead. The visitor is told a person has joined. Use send_agent_reply afterwards, and release_conversation when done. Needs the Standard plan or higher.
Paramètres, retour & exemple (1)
Paramètressession_id· string · requis
Session id from list_active_sessions.
Exemple d'appel{"name": "take_over_conversation", "arguments": {"session_id": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - update_ai_instructions≈ 208 tokens
Replace one website's AI instructions with new text. This overwrites the current instructions and changes how the live chatbot answers every visitor. Read them with get_ai_instructions first, and show the user what will change before calling this.
Paramètres, retour & exemple (2)
Paramètreswebsite_id· integer · optionnel
Numeric id of the website, from list_websites. Omit to use the account's primary website.instructions· string · requis
The full new instructions text.
Exemple d'appel{"name": "update_ai_instructions", "arguments": {"instructions": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - update_website_features≈ 239 tokens
Turn website features on or off and set their values, for example the Real-Time Data Feed URL or the PII Redaction rules. Pass an object of field name to value; read them with get_website_features first. A feature the plan does not include is refused with the plan it needs. These change how the live chatbot behaves for every visitor.
Paramètres, retour & exemple (2)
Paramètresfields· object · requis
Field name to new value, for example real_time_products_enabled set to true.website_id· integer · optionnel
Numeric id of the website, from list_websites. Omit to use the account's primary website.
Exemple d'appel{"name": "update_website_features", "arguments": {"fields": {}}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - update_widget_settings≈ 229 tokens
Change one or more chat widget settings. Pass an object of setting name to new value; read them with get_widget_settings first. Changes are live for every visitor at once. Settings the plan does not include are refused with the plan they need, and nothing is written unless every value is valid.
Paramètres, retour & exemple (2)
Paramètressettings· object · requis
Setting name to new value, for example widget_color set to #6366f1.website_id· integer · optionnel
Numeric id of the website, from list_websites. Omit to use the account's primary website.
Exemple d'appel{"name": "update_widget_settings", "arguments": {"settings": {}}}Exemple de retour{"content": [{"type": "text", "text": "…"}]}
C'est votre serveur ?
Revendiquez-le sur l'espace créateur (preuve GitHub, domaine ou npm) pour afficher le badge « propriétaire vérifié » et lancer un pentest comportemental à la demande afin d'obtenir le badge « Vérifié ».