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.