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:

  1. Navigate to "Chat Widget" in your dashboard

    Click "Create New Widget" to begin.

  2. Copy your unique widget code
  3. Paste the code into your website's HTML before the closing </body> tag
  4. Save and publish your changes
  5. 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:

  1. From your Shopify admin, go to "Online Store" → "Themes"
  2. Click "Actions" on your current theme, then "Edit code"
  3. In the Layout section, find theme.liquid
  4. Paste your Chatplugify widget code just before the closing </body> tag
  5. Click "Save"

Wix

For Wix websites:

  1. In your Wix dashboard, go to "Settings" → "Custom Code"
  2. Click "Add Custom Code"
  3. Give your code a name (e.g., "Chatplugify Widget")
  4. Paste your Chatplugify widget code
  5. Set placement to "Body - end"
  6. 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:

  1. In your Chatplugify dashboard, go to "Integrations" → "CRM"
  2. Select your CRM platform
  3. Click "Connect" and follow the authentication steps
  4. Configure field mappings between Chatplugify and your CRM
  5. Set up automation rules for contact creation and data syncing
  6. 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:

  1. Generate an API key in your Chatplugify dashboard under "Settings" → "API"
  2. Include your API key in the request header: X-API-Key: your_api_key
  3. 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