Integration Guide

How to add AI agent to your website

Add GURAX voice capabilities to any website in less than 2 minutes. Follow this guide to get started.

Copy Your Integration Snippet

Each agent has a unique ID. You can find your specific code snippet in yourDashboardby clicking the "View Code" button on your agent card.

Example Snippet

<!-- GURAX Voice Widget -->
<div id="voice-widget-root"></div>
<script src="https://gurax.ai/widgets/YOUR_AGENT_ID_HERE/voice-widget.umd.cjs"></script>
<script>
  window.VoiceWidget.init({
    selector: 'body', // CSS selector for where to mount
    agentId: "YOUR_AGENT_ID_HERE",
    wsUrl: "wss://ws.gurax.ai",
    apiUrl: "https://api.gurax.ai",
    position: 'bottom-right', // bottom-right, bottom-left, top-right, top-left
    theme: 'light', // light or dark
    callTimeLimit: 15 // In minutes
  });
</script>

Paste into Your Website

You can place the code anywhere in your HTML file, but we recommend putting it in one of these locations:

Recommended:Just before the closing </body> tag. This ensures the widget loads without blocking your site's content.
Alternative:widthin the <head> tag if you want it to initialize immediately.

CMS Users (WordPress, Wix, Shopify): Look for "Custom Code", "Header/Footer Scripts", or "Theme.liquid" in your platform's settings to paste the snippet.

Verify Installation

Once added, publish your changes and refresh your website. You should see the GURAX widget icon in the bottom-right corner (default).

If the widget appears, test a call to ensure your microphone permissions work correctly.

Slack Setup

How to Connect Slack

Receive notifications and let your team chat with the agent directly from your Slack workspace.

Click "Add to Slack"

Navigate to your Agent's Settings > Appointments & Apps tab and click the "Add to Slack" button.

Authorize GURAX

You will be redirected to Slack. Review the permissions and select the channel where you want the agent to post notifications, then click "Allow".

Start Chatting

Once connected, your dashboard will show a green checkmark. You can now interact with your agent in Slack in two ways:

•Direct Message: Open a DM with the Gurax bot and chat privately — great for personal queries or testing.
•@Gurax in a channel: Mention @Gurax in any channel where the bot has been added to get a response visible to the whole team.

Telegram Bot Setup

How to Connect a Telegram Bot

Give your customers a direct line to your agent through Telegram.

Talk to BotFather

Open your Telegram app and search for @BotFather (the official Telegram bot creator with a blue verified checkmark).

Create a New Bot

Send the message /newbot and follow the prompts. You'll need to choose a display name and a unique username (ending in 'bot') for your agent.

Copy your Token

Once created, BotFather will give you a message containing your HTTP API Token. It looks like a long string of numbers and letters (e.g. 123456:ABC-DEF1234ghI...).

Connect in Dashboard

Go back to your Agent's Settings > Appointments & Apps tab. Paste the token into the Telegram Bot section and click "Connect".

Webhook Setup

How to Setup Webhooks

Receive real-time HTTP POST requests with the full conversation history to your own servers or automation platforms at the end of each session.

Create an Endpoint or Zap

Set up an endpoint on your own server (e.g., https://api.yourdomain.com/gurax-webhook), or create a Catch Hook trigger in Zapier, Make.com, or Zoho.

Add URL in Dashboard

Navigate to your Agent's Settings > Appointments & Apps tab. Paste your endpoint URL into the Webhook section. We will POST a JSON payload containing the user's details and the full transcript at the end of every interaction so you can automatically create tickets or CRM records.