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/widget.js" data-agent="YOUR_AGENT_ID"></script>
Custom Styling
With theme and position options:
<script src="https://www.aidesk.us/widget.js" data-agent="YOUR_AGENT_ID" data-theme="light" data-position="bottom-right"></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/chat?agent=YOUR_AGENT_ID
With pre-filled message:
https://www.aidesk.us/chat?agent=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 REST API for advanced use cases and enterprise applications.
Start conversation endpoint:
POST https://api.aidesk.us/v1/conversations
Send message endpoint:
POST https://api.aidesk.us/v1/conversations/{conversationId}/messages
API documentation available in your console under "API Keys"
Iframe Embedding
Embed the full chat interface directly into your webpage for seamless integration.
Basic iframe:
<iframe src="https://www.aidesk.us/chat?agent=YOUR_AGENT_ID&embed=true" width="400" height="600"></iframe>
Responsive iframe:
<iframe src="https://www.aidesk.us/chat?agent=YOUR_AGENT_ID&embed=true" 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.