Back to Dashboard

Documentation

Learn how to use Asyntai

Getting Started
Installation Knowledge Base How the AI Accesses Your Content Connect Your Website Test Your AI Manage Websites
Customization
Chat Button Designs Chat Button Icon Widget Colors Font AI Assistant Name Initial Message Widget Position Auto-Trigger Greeting Bubble Unread Badge Instruction Mode Ask Questions Use Emoji Allow Only Certain Languages Collect Emails Collect Phone Numbers Smart Lead Capture Localization Hide Branding Privacy Link Custom Notice Open Links in the Same Tab Transcript Download New Conversation Conversation History Tagline & Status Dot Speech to Text Chat Icon Company Logo Character Limit Temperature
AI Instructions Tips Switching From Another Chatbot Compare Plans
Features
Ask AI Bar AI Search Bar Website Crawl Knowledge Gaps Product Cards Dynamic Product Cards Dynamic Images User Context Custom Tools Link Parameters Proactive Messages Live Monitoring Human Takeover Escalation AI Notifications Browser Notifications Daily Report Real-Time Data Feed Real-Time Data Feed Max Team Members Single Sign-On Two-Factor Authentication Include Images Image Vision Translation Widget Localization AI Transparency Leads Smart Lead Capture Support Tickets AI Email Replies Chat Categories Help Center Bookings Voice Agent Embeds Exclude Pages Blocked IPs Retention Policy Zero Retention Mode PII Redaction Output Classifier Access Tags Widget Version Pinning Audit Log Reply Suggestions Follow-up Messages Speech to Text Transcript Download Embedded Chat Iframe Embed
Analytics
Chat Analytics Chat Logs
Integrations
REST API Instagram Messenger WhatsApp Twilio Discord Zapier Email Mobile Apps
Other
Add to Home Screen Custom Open Button Ask AI Buttons Payment Failed?
Ask AI

Koha Integration

Add the Asyntai AI chat to the public catalog of your Koha library

Create Account

Overview

Koha is the open source library system that schools, universities and public libraries use. The Asyntai plugin puts the AI chat on the pages of your public catalog (OPAC).

Asyntai answers your patrons day and night, in more than 80 languages. Patrons can ask about opening hours, membership, loans, renewals, services and how to contact you.

How It Works

The plugin adds the Asyntai chat script to every page of your public catalog. The staff interface does not get the chat. The script loads without holding up your page, so your patrons see the catalog first.

Asyntai answers from your own content. Your knowledge base is built in the Asyntai dashboard: it crawls your site, and you can add files, pages and questions of your own.

Requirements

  • Koha 24.11 or later. Tested on 24.11.21 and 26.05.05.
  • Plugins enabled on your Koha server: <enable_plugins>1</enable_plugins> in koha-conf.xml. After you change this value, restart Koha.
  • A Koha staff account that can manage plugins
  • An Asyntai account. The free plan is enough to start.

Installation

Follow these steps to add Asyntai to Koha:

1

Get Your Widget ID

Sign in to Asyntai and open Add to Your Website. Copy the widget ID, for example asyntai_ab12cd34. You can also copy the whole snippet.

2

Download the Plugin

Download asyntai-koha.kpz. Do not unzip it.

3

Upload It to Koha

In the Koha staff interface, open Administration, then Manage plugins. Press Upload plugin, choose the file and press Upload.

4

Paste the Widget ID

Open the Actions menu next to Asyntai AI Assistant and press Configure. Paste the widget ID and press Save. The chat appears at once in your public catalog.

Plugin Settings

  • Widget ID — the identifier from your Asyntai dashboard. You can paste the whole snippet and the ID is read out of it. An empty field switches the chat off.
  • Guests only — patrons who are signed in to the catalog do not see the chat.
  • Widget script address — change this only if Asyntai support asks you to.

Tip: Your patrons get better answers when Asyntai knows more. Open Knowledge Base in the Asyntai dashboard and add your opening hours, your borrowing rules and your frequent questions.

Content Security Policy

Koha has no content security policy unless you switch it on. In report-only mode the chat works as usual. In enabled mode the default Koha policy blocks the chat, so set this value in <opac><csp_header_value> in koha-conf.xml, and then restart Koha:

default-src 'self'; script-src 'self' 'nonce-_CSP_NONCE_' https://widget.asyntai.com; style-src 'self' 'unsafe-inline'; img-src 'self' data: https:; font-src 'self' data: https:; connect-src 'self' https://asyntai.com https://widget.asyntai.com; object-src 'none'

Removing It

Open Administration, then Manage plugins. Open the Actions menu next to Asyntai AI Assistant. Disable removes the chat at once and keeps your settings. Uninstall removes the plugin and its settings.

Plans & Pricing

The plugin is free. It works with every Asyntai plan, and the free plan is enough to start. View pricing.

Need Help?

If you have any questions or run into issues, contact us at [email protected].