Hazelchat
Start free

AI chat agent for websites that run Matomo

Hazelchat answers your visitors from the pages and documents you approve, shows the sources under every answer and passes enquiries on to you. A free Matomo plugin adds the chat with Tag Manager and shows in Matomo how visitors use it.

Start freeSee it in Matomo

Plugin 0.1.0 for Matomo 5, in review at the Matomo Marketplace. The Free plan includes 50 answers a month on one website, with no card, and stays free.

For Matomo 5 On-Premise and Matomo for WordPress. On Matomo Cloud the chat's events work without the plugin.

What you need

  • Matomo 5, installed on your own server or as Matomo for WordPress, with a Super User who can install plugins. Tag Manager comes with Matomo.
  • A Hazelchat account. The plugin needs the hosted Hazelchat service; the Free plan includes 50 answers a month on one website, with no card.

Add Hazelchat with Matomo in five steps

  1. In Hazelchat

    Prepare your agent and copy the key

    Add your content and try your agent. Under Website → Install on your website, add your website's domain and copy your public widget key. It is not a password.

  2. In Matomo

    Install the plugin

    Open Administration → Marketplace, find Hazelchat, click Install, then Activate. Until Matomo has finished its review, the chat’s events already work without the plugin, under Behaviour → Events.

  3. In Matomo

    Add the tag and publish

    Open Tag Manager, choose your container, then Tags → Create new tag and pick Hazelchat Chat. Paste the key, choose the Pageview trigger, save and Publish.

  4. On your site

    Switch it on and test it

    Back in Hazelchat, click I’ve added the code, then Publish and switch on. Open your website, ask a question in the chat, return to Hazelchat and click Yes, I saw this answer.

  5. In Matomo

    Count enquiries as a goal

    Open Behaviour → Hazelchat and click Count enquiries as a goal. Goal reports then show which pages, channels and campaigns bring enquiries.

Already added the chat another way? Skip steps 2–4 on the tag; the events and the Hazelchat page work however the chat was added.

Chats and enquiries in Matomo

When Matomo is on the page, the chat adds three events to the visit, in the category Hazelchat.

  • Chat opened

    A visitor opened the chat.

  • Chat started

    A visitor's first question in a new conversation was answered.

  • Chat enquiry

    A visitor left an enquiry in the chat.

Behaviour → Hazelchat shows the three numbers for the period and segment you pick, and is also a dashboard widget. The goal Hazelchat enquiry counts a visit once when it includes an enquiry. You also find the events under Behaviour → Events and can segment by them.

What reaches Matomo

Only the category and one of the three actions. No chat text, no name or email address and no page details. The events go from the visitor's browser to your own Matomo; Hazelchat receives nothing from Matomo, and the plugin makes no request of its own. The chat itself collects what our privacy notice and DPA describe.

If something is missing

  • No chat

    Publish the container after you add the tag, and switch your agent on in Hazelchat for this website.

  • No numbers

    Matomo counts only visits it tracks: visitors who declined tracking or block Matomo still get the chat but are not in Matomo.

  • No goal button

    You need write access to the website. If enquiries already count as a goal, the page says so instead.

  • Content-Security-Policy

    Allow https://app.hazelchat.co in script-src and frame-src.

Change or remove

Turn the events off

Add data-matomo="off" to the Hazelchat installation code on your website.

New widget key

If you rotate the key in Hazelchat, paste the new key into the tag and publish the container again.

Remove it

Delete the tag and publish the container, or deactivate the plugin. Your Hazelchat account and plan are not affected.

Matomo is a registered trademark of InnoCraft Ltd. Hazelchat is not affiliated with or endorsed by Matomo or InnoCraft; the name is used here only to say which software the plugin works with.

See your chat's enquiries next to your campaigns.

Questions? Email hello@hazelchat.co. We answer within one business day. Not using Matomo? See all the ways to install Hazelchat.

Start freeCheck your site first