README

AI-powered customer service chat widget for Craft CMS 5. This plugin connects your Craft content to the Angie Chat SaaS platform, enabling intelligent product Q&A and customer support.

Requirements

Craft CMS 5.0 or later (Craft Pro edition if you use cart recovery — Craft Commerce requires it)
PHP 8.2 or later
An active Angie Chat subscription
Cart recovery additionally needs Craft Commerce 4/5 and the Abandoned Cart Recovery add-on

Installation

Via Composer (Recommended)

composer require dz0nika/angie-chat-craft
php craft plugin/install angie-chat

From the Plugin Store

Search for "Angie Chat" in the Craft Plugin Store and click Install.

Configuration

Get Your License Key
- Log in to your Angie Chat Dashboard
- Navigate to Websites → Select your website → Settings
- Copy your Craft License Key, Widget Public Key and Webhook Secret (the secret is shown once when generated — rotate it in the dashboard if lost)
Configure the Plugin
- In Craft, go to Settings → Plugins → Angie Chat
- Paste your license key
- Select which sections should be synced to the AI
Initial Sync
- Click Force Sync All Data to send existing content to the AI
- Future saves will sync automatically

How It Works

Content Sync

When you save an entry in an enabled section, the plugin:

Extracts text content from all fields (including Matrix blocks)
Strips HTML and flattens nested content
Extracts the primary image URL
Queues a background job to send data to Angie Chat

The sync happens asynchronously via Craft's queue, so your Control Panel stays fast.

Chat Widget

The plugin automatically injects the Angie Chat widget on your frontend pages. The widget:

Loads asynchronously (no impact on page speed)
Uses your custom styling from the Angie Chat dashboard
Maintains conversation context across page navigation

Cart Recovery (Craft Commerce)

Requires Craft Commerce and the Abandoned Cart Recovery add-on. Three layers, all driven by the shopper's real Commerce cart:

Exit-intent rescue — the plugin injects the live cart (prices, discounts, totals) into every page; when a shopper with a non-empty cart moves to leave, the widget opens and tells them what they'd lose. Toggle and message: dashboard → Websites → Cart Recovery. Nothing to configure in Craft.
Recovery emails — enable "Abandoned Cart Recovery" in the plugin settings and add the cron job (see Abandoned Cart Setup). Abandoned carts with an email get an AI-written recovery email and a 24 h follow-up. The "complete your order" link uses Commerce's commerce/cart/load-cart action, so it works from any device; set loadCartRedirectUrl in config/commerce.php to your cart page so shoppers land there.
Webhooks to your own system — instead of (or as well as) our emails, receive signed cart.exit_intent / cart.abandoned events at your URL and run your own workflow. Set up in the dashboard; spec at docs/cart-webhooks.

Configuration File

You can override settings via config/angie-chat.php:

<?php

return [
    'licenseKey' => getenv('ANGIE_LICENSE_KEY'),
    'enabledSections' => ['products', 'articles'],
    'enableAbandonedCart' => true,
    'apiEndpoint' => 'https://app.angiechat.com',
    'widgetUrl' => 'https://cdn.angiechat.com/widget.js',
    'autoInjectWidget' => true,
    'excludeSelectors' => '.no-chat, #checkout',
];

Manual Widget Injection

If you disable auto-injection, add the widget manually in your template:

{% if craft.app.plugins.isPluginEnabled('angie-chat') %}
    {{ craft.angieChat.widget.renderWidgetScript()|raw }}
{% endif %}

Troubleshooting

"Not Connected" Status

Verify your license key is correct
Check that your Angie Chat subscription is active
Ensure your server can reach app.angiechat.com

Content Not Syncing

Check the Craft queue utility for failed jobs
Verify the section is enabled in plugin settings
Check Craft logs for error messages

Widget Not Appearing

Verify "Auto-inject Widget" is enabled
Check if the page matches an exclude selector
Ensure you're viewing a frontend (site) request

Support

Documentation: angiechat.com
Email: info@angiechat.com
Dashboard: app.angiechat.com

License

MIT License - see LICENSE for details.

dz0nika / angie-chat-craft

Package info

Security

Statistics