Integration Options

Deploy your AI agents across multiple platforms including websites, Instagram, WhatsApp, and APIs.

Website Chat Widget

The most popular integration method. Adds a floating chat button to your website with customizable styling.

Basic Integration

Add this script tag before closing </body> tag:

<script src="https://www.aidesk.us/api/e?uid=YOUR_AGENT_ID" async></script>

Custom Styling

With theme and position options:

<script src="https://www.aidesk.us/api/e?uid=YOUR_AGENT_ID" async></script>

Widget Options

• data-theme: "light" or "dark"
• data-position: "bottom-right", "bottom-left"
• data-color: Custom hex color for widget
• data-greeting: Custom greeting message

Direct Chat Links

Share direct links to start conversations with your AI agents. Perfect for email signatures, social media, or support tickets.

Basic chat link:

https://www.aidesk.us/c?uid=YOUR_AGENT_ID

Alternative with agent parameter:

https://www.aidesk.us/c?agent=YOUR_AGENT_ID

With pre-filled message:

https://www.aidesk.us/c?uid=YOUR_AGENT_ID&message=Hello,%20I%20need%20help

Use Cases

• Email signature support links
• Social media bio links
• QR codes for offline marketing
• Support ticket auto-responses

Instagram DM Integration

Connect your Instagram Business account to handle DMs automatically with your AI agent.

Setup Steps

1. Go to agent settings → Integrations → Instagram
2. Connect your Instagram Business account
3. Configure auto-response settings
4. Monitor conversations in your AI Desk inbox

⚠️ Requirements

• Instagram Business account (not personal)
• Facebook Business Manager access
• Webhook permissions approved

WhatsApp Integration

Handle WhatsApp Business messages through your AI agents for comprehensive customer support.

• Available on paid plans
• Requires WhatsApp Business API setup
• Contact support for configuration assistance
• Supports message templates and media

🔗 Setup Required

WhatsApp Business API requires approval and configuration. Contact our support team to get started.

API Integration

Build custom integrations with our chat API for advanced use cases and enterprise applications.

Chat API endpoint:

POST https://www.aidesk.us/api/chat

Alternative streaming endpoint:

POST https://www.aidesk.us/api/chat/{{agentId}}

Example request body:

{
  "uid": "YOUR_AGENT_ID",
  "messages": [
    {
      "role": "user",
      "content": "Hello, I need help"
    }
  ],
  "sessionId": "optional-session-id"
}

🔑 Authentication

API access may require authentication for production use. Contact support for API keys and documentation.

Iframe Embedding

Embed the full chat interface directly into your webpage for seamless integration.

Iframe embed:

<iframe src="https://www.aidesk.us/c?uid=YOUR_AGENT_ID&embed=1" width="400" height="600"></iframe>

Responsive iframe:

<iframe src="https://www.aidesk.us/c?uid=YOUR_AGENT_ID&embed=1" style="width: 100%; height: 600px; border: none;"></iframe>

Best Practices

• Set minimum height of 500px for mobile
• Use responsive width (100%) for mobile compatibility
• Add loading placeholder for better UX
• Test across different devices and browsers

Integration Complete!

Your AI agent is now deployed. Learn how to optimize its performance with a knowledge base.

Setup Knowledge Base →Troubleshooting Guide