Documentation

Getting Started with Hal

Hal is a simple, real-time chat widget for your website. This guide will help you get up and running in minutes.

Quick Start

1. Create an account

   Sign up at app.chatwithhal.com/signup. No credit card required.

2. Create an app

   After signing in, you'll be prompted to create your first app. Give it a name (e.g., "My Website").

3. Get your embed code

   Go to Settings to find your embed code. It looks like this:

   <script src="https://api.chatwithhal.com/widget.js" data-app-id="your-app-id"></script>

4. Add to your website

   Paste the code just before the closing </body> tag on your website.

5. Start chatting!

   Open your website and you'll see the chat widget. Messages from visitors will appear in your Hal inbox.

Key Features

Hal is more than just a chat widget. It's a complete customer support platform with:

• Real-time Messaging - Live chat with WebSocket support for instant delivery
• AI-Powered Suggestions - Get AI-generated response suggestions based on your knowledge base
• CRM & Pipeline Management - Track contacts through customizable sales/support stages
• Knowledge Base - Build a help center with articles, groups, and multi-language support
• Team Collaboration - Invite team members with role-based permissions
• File Attachments - Share images, documents, and files in conversations
• Multi-Language Support - Widget available in 12+ languages
• Identity Verification - Secure visitor identification with HMAC

Dashboard Overview

The Hal dashboard has several main sections:

• Inbox - View and respond to all conversations with AI suggestions
• Contacts - Manage your CRM with pipeline stages and deal tracking
• CRM - Visual Kanban board for managing contact stages
• Articles - Create and manage knowledge base content
• Settings - Customize your widget, manage team, and configure AI

Next Steps