Integration Guide
Learn how to integrate Chatplugify with your website and other business tools.
Introduction
Chatplugify is designed to work seamlessly with your existing website and tools. This guide covers everything you need to know about integrating our chat widget with different platforms and connecting it to your favorite business tools.
Website Integration
Basic Installation
Adding Chatplugify to your website is simple and only takes a few minutes:
- Navigate to "Chat Widget" in your dashboard
Click "Create New Widget" to begin.
- Copy your unique widget code
- Paste the code into your website's HTML before the closing
</body>
tag - Save and publish your changes
- Visit your website to verify the widget appears
<script>
(function(w,d,s,c,i,f,y){
w['ChatplugifyWidget']=c;w[c]=w[c]||function(){
(w[c].q=w[c].q||[]).push(arguments)};
w[c].l=1*new Date();f=d.createElement(s);
y=d.getElementsByTagName(s)[0];f.async=1;
f.src='https://cdn.chatplugify.com/widget.js';i=i||'XXXX-YYYY-ZZZZ';
w[c]('init',{widgetId:i});y.parentNode.insertBefore(f,y);
})(window,document,'script','cp','YOUR_WIDGET_ID');
</script>
Platform-Specific Guides
WordPress
For WordPress sites, you have two installation options:
- Plugin Method: Install our official WordPress plugin from the WordPress plugin directory. Search for "Chatplugify" in the plugins section of your dashboard.
- Manual Method: Add the widget code to your theme's footer.php file before the closing
</body>
tag, or use a header/footer script plugin.
Shopify
To add Chatplugify to your Shopify store:
- From your Shopify admin, go to "Online Store" → "Themes"
- Click "Actions" on your current theme, then "Edit code"
- In the Layout section, find theme.liquid
- Paste your Chatplugify widget code just before the closing
</body>
tag - Click "Save"
Wix
For Wix websites:
- In your Wix dashboard, go to "Settings" → "Custom Code"
- Click "Add Custom Code"
- Give your code a name (e.g., "Chatplugify Widget")
- Paste your Chatplugify widget code
- Set placement to "Body - end"
- Check "Add to all pages" and click "Apply"
Pro Tip: Make sure your PDF files are "well-structured" and "properly formatted" for optimal AI performance.
CRM Integration
Connect Chatplugify with your CRM to automatically sync customer data and conversation history.
Supported CRM Platforms
Chatplugify integrates natively with these popular CRM systems:
- Salesforce: Sync contacts, create leads, and log conversations directly in Salesforce.
- HubSpot: Create and update contacts, log chat interactions, and trigger workflows.
- Zoho CRM: Sync contact data, add chat transcripts, and create follow-up tasks.
- Pipedrive: Create deals, add contacts, and log activities from chat conversations.
Setting Up CRM Integrations
To connect your CRM with Chatplugify:
- In your Chatplugify dashboard, go to "Integrations" → "CRM"
- Select your CRM platform
- Click "Connect" and follow the authentication steps
- Configure field mappings between Chatplugify and your CRM
- Set up automation rules for contact creation and data syncing
- Test the integration by starting a chat conversation
Best Practice: When configuring your AI agent's "response style" and "tone", consider your brand's "voice" and "personality".
API Documentation
For advanced integrations and custom functionality, Chatplugify provides a comprehensive API.
API Overview
The Chatplugify API allows you to:
- Programmatically manage chat widgets and settings
- Access and export conversation data
- Create and manage AI agents
- Build custom integrations with any platform
- Automate workflows and Insighting
Authentication
All API requests require authentication using your API key:
- Generate an API key in your Chatplugify dashboard under "Settings" → "API"
- Include your API key in the request header:
X-API-Key: your_api_key
- Use HTTPS for all API requests
Sample API Request
curl -X GET "https://api.chatplugify.com/v1/conversations" \
-H "X-API-Key: your_api_key" \
-H "Content-Type: application/json"
Rate Limits
API rate limits vary by plan:
- Starter: 100 requests per hour
- Professional: 1,000 requests per hour
- Enterprise: Custom limits based on your needs
For detailed API documentation, code examples, and SDKs, visit our API Reference page.
Other Integrations
Beyond CRMs, Chatplugify integrates with many other business tools:
Help Desk & Ticketing
- Zendesk: Create tickets from chat conversations
- Freshdesk: Convert chats to tickets and track resolutions
- Help Scout: Add chat conversations to customer histories
Team Communication
- Slack: Receive chat notifications and respond directly from Slack
- Microsoft Teams: Get alerts and collaborate on customer inquiries
- Discord: Manage chat conversations through Discord channels
Marketing Tools
- Mailchimp: Add chat contacts to email lists
- Klaviyo: Trigger email flows based on chat interactions
- Google Analytics: Track chat events and conversions
Workflow Automation
- Zapier: Connect Chatplugify to 3,000+ apps without coding
- Make (formerly Integromat): Create complex automation scenarios
- Webhooks: Send chat data to any custom endpoint
Troubleshooting
If you encounter issues with your integration, try these common solutions:
Widget not appearing on website
- Verify the code is correctly placed before the
</body>
tag - Check for JavaScript errors in your browser console
- Ensure your widget is activated in the Chatplugify dashboard
- Try clearing your browser cache or testing in an incognito window
CRM integration not syncing data
- Verify authentication credentials are still valid
- Check field mappings for any misconfigurations
- Ensure required CRM permissions are granted
- Look for any API usage limits you may have reached
API requests returning errors
- Confirm your API key is valid and included in requests
- Check request formatting against API documentation
- Verify you're not exceeding rate limits
- Look for detailed error messages in the API response
Previous
Getting Started GuideNext
Best Practices