Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.linkaiil.com/llms.txt

Use this file to discover all available pages before exploring further.

Website Integration

Add LinkAI to your website with a customizable chat widget that provides instant support to visitors. Choose from a floating chat bubble, embedded iframe, or full-page chat experience.

Why Website Chat?

Your website is often the first touchpoint with potential customers:
  • Instant Engagement - Capture visitors before they leave
  • 24/7 Availability - Answer questions even when you’re offline
  • Lead Capture - Convert anonymous visitors into qualified leads
  • Reduced Bounce Rate - Keep visitors engaged longer
  • Self-Service Support - Reduce support tickets with instant answers

Integration Options

A floating chat bubble that appears on your website, similar to Intercom or Drift.

Best For

Most websites - e-commerce, SaaS, service businesses

Fully Customizable

Colors, position, behavior, and appearance

Mobile Responsive

Works perfectly on all devices

Advanced Features

Supports all LinkAI capabilities

2. Embedded iFrame

Embed the chat interface directly into your page layout.

Best For

Help centers, support pages, dedicated chat pages

Simple Integration

Just add an iframe code snippet

Full Control

Control exact size and placement

Note

Some advanced features not supported

3. Chatbubble & Wireframe

Third-party embedding solutions for additional customization options.

Chat Widget Setup

1

Navigate to Deploy

Go to Dashboard > [Agent] > Deploy > Chat Widget
2

Enable Widget

Toggle the chat widget to Enabled
3

Customize Appearance

Configure colors, position, icon, and theme
4

Set Content

Add welcome message, suggested questions, and branding
5

Copy Embed Code

Copy the provided script and paste before closing </body> tag
6

Test

Visit your website and test the chat widget

Customization Options

Content Settings

Display Name
  • The name shown at the top of the chat widget
  • Example: “Customer Support” or “AI Assistant”
Initial Message
  • The first message visitors see
  • Example: “Hi! How can I help you today?”
Suggested Messages
  • Quick-reply buttons for common questions
  • Example: “Track my order”, “Pricing info”, “Talk to sales”
Message Placeholder
  • Text shown in the input field
  • Example: “Type your message…”
Footer Text
  • Disclaimer or link at bottom of chat
  • Example: “Powered by LinkAI” or link to privacy policy
Dismissable Notice
  • Banner message above input that disappears after first message
  • Example: “We typically reply in under 1 minute”

Style Settings

Choose between Light or Dark theme to match your website
Set the accent color for user message bubbles and buttons
Position the chat button on the left or right side of the screen
Customize the color of the floating chat button
Upload a custom icon for the chat button
Set the AI agent’s avatar image

Behavior Settings

Auto-Show Initial Message
  • Automatically display a message after X seconds
  • Set to negative number to disable
  • Example: Show “Need help?” after 10 seconds
Collect Feedback
  • Display thumbs up/down buttons on AI responses
  • Gather feedback to improve your agent
Regenerate Messages
  • Allow users to regenerate AI responses
  • Useful if the first answer wasn’t helpful
Allowed Domains
  • Restrict where your chat widget can load
  • Prevent unauthorized use on other websites

Advanced Features

Localization

Support multiple languages with automatic detection:
1

Add Languages

Click Add language and select from available options
2

Set Default

Choose which language to use as default
3

Automatic Detection

Widget displays in visitor’s browser language if available
4

RTL Support

Right-to-left languages (Arabic, Hebrew) fully supported

Channel-Specific Instructions

Override your agent’s base instructions for the website channel:
  1. Disable Sync with base instructions
  2. Add website-specific behavior
  3. Example: “Be more casual on the website” or “Focus on lead capture”

Lead Collection

Automatically capture visitor information:
  • After X messages exchanged
  • When visitor mentions specific keywords
  • Before transferring to human
  • On high-intent conversations
  • Name
  • Email
  • Phone number
  • Company
  • Custom fields
Automatically send captured leads to your CRM

Installation Methods

Standard Installation

Add this code before the closing </body> tag:
<script>
  window.linkaiConfig = {
    agentId: "YOUR_AGENT_ID"
  }
</script>
<script src="https://cdn.linkai.com/widget.js" defer></script>

WordPress

  1. Install the LinkAI WordPress plugin
  2. Enter your Agent ID in settings
  3. Customize appearance in the plugin dashboard

Shopify

  1. Go to Online Store > Themes > Actions > Edit Code
  2. Open theme.liquid
  3. Paste the embed code before </body>
  4. Save and test

Webflow

  1. Go to Project Settings > Custom Code
  2. Paste embed code in Footer Code
  3. Publish your site

Wix

  1. Go to Settings > Custom Code
  2. Add new code snippet
  3. Paste embed code
  4. Set to load on all pages

iFrame Integration

For embedding chat directly in your page layout:
<iframe
  src="https://linkai.com/chat/YOUR_AGENT_ID"
  width="100%"
  height="600px"
  frameborder="0"
></iframe>
Limitations:
  • No persistent chat history across pages
  • Some advanced features unavailable
  • Less customization options

Best Practices

Make it clear, friendly, and action-oriented. Tell visitors what the AI can help with.
Add 3-5 common questions as quick-reply buttons to guide conversations.
Set expectations: “I typically respond in seconds” builds trust.
Make it easy to escalate to a human: “Would you like to speak with a team member?”
Test on mobile devices - most traffic is mobile.
The widget loads asynchronously and won’t slow down your site.

Analytics

Track chat widget performance:

Conversations

Total chats started and messages exchanged

Response Time

Average time to first response

Resolution Rate

Percentage of inquiries resolved without human help

Satisfaction

Thumbs up/down feedback from visitors

Leads Captured

Number of visitors who provided contact info

Conversion Rate

Visitors who chatted vs. took desired action

Troubleshooting

Widget not appearing:
  • Check that the script is before </body> tag
  • Verify your Agent ID is correct
  • Check browser console for errors
  • Ensure domain is in allowed domains list
Widget conflicts with other chat tools:
  • Only one chat widget should be active
  • Remove other chat scripts (Intercom, Drift, etc.)
  • Or use LinkAI’s API to integrate with existing tools
Styling issues:
  • Check for CSS conflicts with your site
  • Use browser dev tools to inspect elements
  • Adjust z-index if widget is behind other elements
Slow loading:
  • Script loads asynchronously by default
  • Check your website’s overall performance
  • Contact support if issues persist

Chatbubble Integration

For advanced customization using Chatbubble:
  1. Sign up for Chatbubble account
  2. Connect your LinkAI agent via API
  3. Customize with Chatbubble’s advanced styling options
  4. Embed on your website
Benefits:
  • More design flexibility
  • Advanced animations
  • Custom positioning options

Wireframe Integration

For developers who want full control:
  1. Use LinkAI’s API to build custom chat interface
  2. Design your own UI with Wireframe
  3. Connect to LinkAI backend for AI responses
  4. Full control over appearance and behavior

Next Steps

Customize Your Widget

Set up and customize your chat widget

Train Your Agent

Upload FAQs and documentation

Set Up Lead Capture

Configure lead collection forms

View Analytics

Track chat performance and optimize

Your website chat is ready! Visitors can now get instant answers 24/7, and you’ll capture more leads without lifting a finger.