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 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

Roam Research Integration

Turn your Roam pages into the knowledge of your website chatbot

Create Account

Overview

Roam Research is a note app that keeps your writing as a graph of linked pages. The Asyntai extension connects your graph to your website chatbot. Choose the pages, and every one of them becomes an answer the assistant can give your visitors.

The extension also adds an Asyntai panel to Roam. Ask your chatbot a question there, read the latest website chats and leads, and save any chat as a page.

What It Does

  • Sends pages to the knowledge base. Every page whose title starts with a prefix you choose goes to Asyntai. Each edit goes up again a few seconds after you stop typing, and a renamed or deleted page leaves the knowledge base.
  • Keeps block references whole. A block reference is sent as the text it points to, so a fact you keep in one place reaches every page that references it. A reference into a page you leave out, or into a daily note while daily notes are off, sends nothing.
  • Answers questions inside Roam. The panel gives you the same answer the chatbot gives your visitors. Press Insert into page to add it to your graph.
  • Shows website chats and leads. The panel lists the latest conversations and every visitor who left an email address or phone number. Save as page keeps a conversation under Asyntai chats/.

Requirements

  • Roam Research, in the browser or the desktop app
  • An Asyntai account on the Starter plan or higher, because the extension uses the Asyntai API

Installation

Follow these steps to connect Roam to Asyntai:

1

Get Your API Key

Sign in to Asyntai, open Settings, then API, and copy your API key.

2

Install the Extension

In Roam, open Settings from the … menu in the top right corner, go to the Roam Depot tab, and press Browse. Search for Asyntai AI Chatbot and press Install.

3

Paste the API Key

Open Settings, then the Asyntai AI Chatbot tab, and paste your key into Asyntai API key. Then run Asyntai: check API key from the command palette to see the account the key belongs to.

4

Choose What To Send

In Pages to send, write the title prefixes, comma separated. These are the pages your Asyntai chatbot answers from, on your website and in the Roam panel. For example Docs sends the page Docs and every page under it, such as Docs/Refund policy.

Type / on its own to send every page. Put prefixes such as Docs/Drafts in Pages to leave out.

5

Send Your Pages

Open the command palette with Ctrl+P (Cmd+P on a Mac), search for Asyntai, and run Asyntai: send all pages. Roam shows how many pages went up.

After that, every edit goes up on its own a few seconds after you stop typing.

Where To Find It

  • Top bar: the chat icon opens and closes the panel.
  • Command palette: every command starts with Asyntai:.
  • Slash command: type a question in a block, then /Asyntai ask. The panel opens with your question ready, and Insert into page puts the answer under that block.

Commands

CommandWhat it does
Asyntai: open panelOpens Ask, Chats and Leads
Asyntai: send this pageSends the page you are on
Asyntai: remove this pageTakes the page out of Asyntai
Asyntai: send all pagesSends every page you chose
Asyntai: remove all pagesTakes every sent page out of Asyntai
Asyntai: check API keyShows the account the key belongs to

Settings

SettingMeaning
Asyntai API keyFrom Settings → API in your Asyntai dashboard
Pages to sendThe pages your chatbot answers from, on your website and in the panel. Title prefixes, comma separated. / means every page
Pages to leave outPrefixes that stay out even when a parent is sent, block references into them included
Send daily notesOff by default, because daily notes are usually private
Send changes automaticallySends a page a few seconds after you stop typing
Asyntai addressLeave as it is unless support asks you to change it. Must start with https://

Tip: You can send one page from outside your chosen prefixes with Asyntai: send this page. It stays in Asyntai until you remove it or run send all pages again.

Removing It

Run Asyntai: remove all pages from the command palette to take every sent page out of the knowledge base. Your pages in Roam stay. Then uninstall the extension in Roam Depot.

Plans & Pricing

The extension is free. It uses 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].