📘 Hemnix Assist Chatbot

Integration & Usage Documentation

1. Overview

Hemnix Assist is an AI-powered chatbot that can be integrated into websites, web applications, and mobile apps to provide:

Instant AI responses
Lead capture
Image & voice interactions
Human escalation
Analytics & conversation tracking

The chatbot is deployed using a lightweight embed mechanism and connects securely to Hemnix servers using a Public Chatbot Key.

2. Core Integration Concept

All integrations ultimately load the same chatbot script. Simply add this script tag to your site:

<script
  src="https://chatbot.hemnix.com/widget.js"
  data-key="YOUR_PUBLIC_CHATBOT_KEY"
  async>
</script>

Key ID: The Public Chatbot Key identifies your specific chatbot configuration.

Rendering: The script automatically renders the UI and handles all communication.

Security: No backend code is required on the client's side for standard integration.

3. Supported Platforms

Hemnix Assist works seamlessly across all modern digital platforms:

Static HTML

WordPress

Shopify

Laravel / PHP

React / Next.js

Android/iOS

GTM

4. Website Integration (HTML / Frameworks)

1. Open your website's main layout file.
2. Paste the script before the closing </body> tag.
3. Replace YOUR_PUBLIC_CHATBOT_KEY with your key.
4. Save and deploy.

Note: Works with any frontend framework and loads asynchronously without blocking page rendering.

<script
  src="https://chatbot.hemnix.com/widget.js"
  data-key="PUBLIC_KEY"
  async>
</script>

5. WordPress Integration

A Plugin (Recommended)

• Download the plugin file below.
• Upload hemnix-assist.php to your wp-content/plugins/ directory.
• Go to Settings → Hemnix Assist.
• Enable chatbot and paste your Public Key.
• Save. The script is injected automatically.

Download Plugin (.zip)

Version 1.0.0 | Recommended for WordPress

B Manual Theme Integration

Go to Appearance → Theme Editor, open footer.php, and paste the script before </body>.

6. Shopify Integration

1. Shopify Admin → Online Store → Themes
2. Click ... → Edit code
3. Open theme.liquid
4. Paste chatbot script before </body>

No Shopify app required. Works with all themes.

7. Google Tag Manager (GTM)

Marketing & Agencies

Ideal for restricted code access environments.

1 Create a New Tag
2 Tag Type: Custom HTML
3 Paste chatbot script
4 Trigger: All Pages

8. Mobile App Integration (WebView)

How it works

Load the website containing the chatbot inside a WebView. The script auto-loads, requiring no native SDK for basic functionality.

Supported

Android iOS Flutter React Native

9. Chatbot Configuration

Configure everything from the Hemnix Assist Dashboard. Changes apply instantly.

AI guidance & prompts

Business information

Language support

Lead capture fields

Escalation rules

Image & voice permissions

Analytics & usage limits

10. WhatsApp Alerts (Admin)

Real-time Notifications

Get notified instantly when a new conversation starts.

• Triggered on first user message only.
• Sent once per conversation to avoid spam.

11. Security & Domains

Public Keys

Public keys are safe to expose in client-side script. They identify your chatbot but don't grant administrative access.

Domain Protection

Keys are restricted to allowed domains. Requests from unknown domains are rejected automatically.