Redmine Integration
An AI chat assistant on your Redmine, answers from your wiki, and support tickets as Redmine issues
Overview
Redmine is an open-source project and issue tracker. The Asyntai plugin puts an AI chat assistant on every page of your Redmine. It answers your users from your wiki pages and your website, all day, in their language.
When a user needs a person, the assistant opens a support ticket. The same ticket appears as an issue in the Redmine project you choose, with the whole conversation that produced it. Your team answers from Redmine.
How It Works
The plugin does three things:
- The chat assistant. The chat widget appears on every Redmine page, for signed-in users and for visitors of your public projects. Connect it from the plugin settings in one step.
- Your wiki as knowledge. Every wiki page of a public project goes to your Asyntai knowledge base when it is saved, and a deleted page is removed again. The assistant answers from your wiki, and links to the page it took the answer from. Private projects join when you switch them on.
- Tickets as issues. When the assistant opens a support ticket, Asyntai creates the matching issue in Redmine at once: the subject, the visitor's email address, the page they were on, and every message of the chat. Pick the project and the tracker, for example Support.
Requirements
- Redmine 5.0 or newer, self-hosted, with access to the server for the plugin install
- An Asyntai account. The wiki sync and the issue sync use the Asyntai API, which needs the Starter plan or higher
- For the issue sync: the REST web service switched on in Redmine, under Administration → Settings → API
Installation
Follow these steps to add Asyntai to Redmine:
Install the Plugin
Download the plugin from GitHub and put the folder redmine_asyntai into the plugins directory of your Redmine. Then run, from the Redmine directory:
bundle exec rake redmine:plugins:migrate RAILS_ENV=productionRestart Redmine.
Connect the Chat Assistant
In Redmine open Administration → Plugins and press Configure next to Asyntai AI Chatbot. Press Get started. A window opens where you sign in to Asyntai, or create an account. When it closes, the chat widget is live on every page.
Send Your Wiki
On the same settings page, paste your Asyntai API key. You find it in Asyntai under Settings, then API. Switch on Send wiki pages when they are saved and press Apply. Press Send all pages now once, and every wiki page of your public projects is in the knowledge base. From then on, every save keeps it up to date.
Get Your Redmine API Key
In Redmine open My account. On the right, under API access key, press Show and copy the key. If the section is missing, switch on the REST web service under Administration → Settings → API first.
Connect the Issue Sync
Open the Redmine connect page in Asyntai. Paste your Redmine address and the key, then press Continue. Choose the project, the tracker, and the website whose chat the tickets come from. Press Connect Redmine.
Send a Test Ticket
Press Send a test ticket. An issue called Asyntai connection test appears in your project. You can close it.
Tip: Every issue carries the visitor's email address at the top of its description, and the chat below it, so your team can answer straight away.
Settings
- Include the wikis of private projects. Off by default. The assistant answers visitors of your public site, so private wikis stay out until you switch this on.
- Projects to leave out. Project identifiers, separated by commas. Their wikis never go to the knowledge base.
- Check the key. Confirms that Asyntai accepts the API key you saved.
Turning It Off
The chat widget: open the plugin settings and press Reset connection. The widget disappears from every page at once.
The wiki sync: switch off Send wiki pages when they are saved and press Apply. Pages already in the knowledge base stay there until you remove them in Asyntai.
The issue sync: open the Redmine connect page and press Disconnect. Asyntai forgets the key at once and stops creating issues. Issues already in Redmine stay where they are.
The plugin: from the Redmine directory run bundle exec rake redmine:plugins:migrate NAME=redmine_asyntai VERSION=0 RAILS_ENV=production, remove the plugin folder, and restart Redmine.
Privacy
The wiki sync sends the text of your wiki pages to Asyntai. The issue sync sends the ticket and the chat behind it to the Redmine you connect. Privacy policy.
Plans & Pricing
The plugin is free and open source. The wiki sync and the issue sync use the Asyntai API, which needs the Starter plan or higher. View pricing.
Need Help?
If you have any questions or run into issues, contact us at [email protected].