ChatRAG Documentation

ChatRAG helps you build AI agents that answer based on your documents. Get up and running in just a few minutes with our simple setup process.

Embed your AI agent on any website with just one line of code. The widget is fully responsive and customizable to match your brand.

Bubble Embed

<script 
  src="https://chatrag.co/embed.min.js" 
  data-agent-id="your-agent-id">
</script>

Secure User Authentication

For secure user identification, generate an HMAC token using your user's userID and embed secret key. This ensures authentic user sessions and prevents spoofing.

// Backend implementation
const crypto = require('crypto');

const userId = 'user123';
const secretKey = 'your-embed-secret-key'; // From specific agents embedding

const hmacToken = crypto
  .createHmac('sha256', secretKey)
  .update(userId)
  .digest('hex');

// Include in embed script
<script>
window.chatragUserConfig = {
  user_id: "your-application-user-id",
  user_hash: "generated hash code",
  user_metadata: {
    email: "user email",
    name: "user name",
    other data's....
  }
};
</script>

<script
  src="https://chatrag.co/embed.min.js"
  data-agent-id="your-agentid"
  defer
></script>;

Connect ChatRAG with your favorite tools to automate workflows and enhance productivity.

Connect your ChatRAG agent to Slack to receive real-time notifications when users interact with your AI assistant, submit feedback, or become leads.

Step 1: Create the #support Channel

ChatRAG looks for a specific channel to send notifications. Follow these steps:

Step 2: Connect ChatRAG to Slack

Now connect your ChatRAG agent to your Slack workspace:

Step 3: Invite ChatRAG Bot to #support Channel

After authorization, you need to invite the ChatRAG bot to your support channel:

What Notifications You'll Receive

Once configured, ChatRAG will send notifications to your #support channel for:

Testing Your Integration

Test your Slack integration to ensure everything is working:

Customizing Notifications

You can customize which events trigger Slack notifications in your agent's Flow settings:

Connect your ChatRAG agent to Discord to receive notifications, and automated alerts when users interact with your AI assistant.

Step 1: Create the Support Channel

ChatRAG requires a specific channel to send notifications. Here's how to create it:

Step 2: Check Your Permissions

You need specific permissions to add the ChatRAG bot to your server:

Step 3: Connect ChatRAG to Discord

Now connect your ChatRAG agent to your Discord server:

Step 4: Configure Bot Permissions

After adding the bot, configure its permissions in your support channel:

What Notifications You'll Receive

Once configured, ChatRAG will send notifications to your #support channel for various events:

After connecting your Notion workspace, you need to create two specific databases to enable feedback collection and lead generation features.

Step 1: Create Feedback Database

In your connected Notion workspace, create a new database named exactly "Feedback"with the following properties:

Step 2: Create Leads Database

In your connected Notion workspace, create another new database named exactly "Leads"with the following properties:

Testing Your Setup

Once you've created both databases, test the integration by asking your AI assistant:

Usage Examples

Once setup is complete, your AI assistant can automatically collect feedback and capture leads:

You need to create a base called "ChatRAG Integration" with two specific tables to enable feedback collection and lead generation features before connecting your airtable account to chatrag.

Step 1: Create ChatRAG Integration Base

First, create a new base in your Airtable workspace:

Step 2: Create Feedback Table

Inside your "ChatRAG Integration" base, create a new table named exactly "Feedback" with the following fields:

Step 3: Create Leads Table

Inside the same "ChatRAG Integration" base, create another table named exactly "Leads" with the following fields:

Testing Your Setup

Once you've created the base with both tables, test the integration by asking your AI assistant:

Final Base Structure

Your completed Airtable setup should look like this:

Usage Examples

Once setup is complete, your AI assistant can automatically collect feedback and capture leads:

Common issues and solutions to help you get the most out of ChatRAG.