Biz1 Embed Chat
Last updated: 2026-06-01
Biz1 Embed Chat is a **website chat widget** you add to your own site. Visitors click a chat icon, enter their details, and message your business — without logging into Biz1.
Your team reads and replies from Biz1 (customer profile → Chat tab).
What it is
Embed Chat puts a **live chat bubble** on any website you control — marketing site, landing page, online store, etc.
Visitors do not need a Biz1 account. They see a friendly chat window, fill in name / email / phone once, and start talking.
Two ways to offer it:
| Mode | Experience |
|------|------------|
| **Floating widget** | Small icon in the corner; opens a chat panel on click |
| **Full-page chat** | Dedicated chat page (link or iframe) |
Where to see it
| Location | Purpose |
|----------|---------|
| **Your website** | Live widget or chat page your visitors use |
| **Embed configurator** | `https://your-domain.com/chat/embed.php` — pick options and copy code |
| **Test page** | `https://your-domain.com/chat/test.html` — preview before going live |
| **Biz1 → Customer → Chat tab** | Where your team sees and replies to visitor messages |
Features
For website visitors
| Feature | Details |
|---------|---------|
| **Start a chat** | Name, email, and phone form on first visit |
| **Text messages** | Standard chat messages |
| **File upload** | PDF, Word, images |
| **Voice messages** | Built-in voice recorder |
| **Camera** | Take a photo on mobile |
| **Return visits** | Browser remembers the visitor for ~30 days |
| **Chat history** | Previous messages load on return (when history is enabled) |
| **Greeting** | “Hello {name}” shown locally when chat opens |
Customization (your branding)
| Option | Choices |
|--------|---------|
| **Language** | English, Hebrew, Arabic, Thai, Burmese |
| **Direction** | Left-to-right or right-to-left |
| **Color** | Any hex color for header and visitor message bubbles |
| **Default state** | Chat open or closed when page loads |
| **History** | Load past messages on return visit (on/off) |
Default branding uses Biz1 colors and logo; you override the primary color with your own.
For your team
- Visitor messages create or link to a **customer record** in Biz1. - Replies are sent from **Customer profile → Chat tab** or the sidebar chat. - You can follow up later via email, WhatsApp, or other channels from the same customer record.
How to set it up
Step 1 — Get your API token
1. Log in to Biz1 as the **account owner**. 2. Go to **Settings**. 3. In your account / profile section, find **API Token**. 4. Copy the token — you will need it in the embed code.
> Embed chat uses your account API token. API access may require a paid plan — see FREE_PLAN_MAP.md.
Step 2 — Build the widget (recommended)
1. Open **`https://your-domain.com/chat/embed.php`** in your browser. 2. Set: - Language and direction - Brand color - Open or closed by default - Whether to load history - Your API token 3. Click **Copy embed script**. 4. Paste the script into your website HTML, just before `</body>`.
The configurator also provides:
- **Preview link** — open in a new tab to see how it looks - **Live preview** — test the widget with your settings
Step 3 — Floating widget (manual)
If you prefer to write the code yourself, add one script tag:
<script src="https://your-domain.com/chat/chat.php" data-lang="en" data-direction="ltr" data-color="#021225" data-default="close" data-api_hash_token="YOUR_API_TOKEN" data-history="1"> </script>
| Attribute | Meaning |
|-----------|---------|
| `data-lang` | UI language |
| `data-direction` | `ltr` or `rtl` |
| `data-color` | Brand color (hex) |
| `data-default` | `open` or `close` on page load |
| `data-api_hash_token` | Your API token from Settings |
| `data-history` | `1` = load past messages on return |
Step 4 — Full-page chat (alternative)
Link directly to a chat page instead of a floating widget:
https://your-domain.com/chat/index.php?lang=en&api_hash_token=YOUR_API_TOKEN
**Subdomain accounts:** If you use a personal subdomain (e.g. `yourname.biz1.co.il`), full-page chat on supported domains can work **without** a token:
https://yourname.biz1.co.il/chat/index.php?lang=he&history=1
Supported domains: `biz1.co.il`, `bull36.com`, `mastrocrm.com`.
The floating embed script always requires the API token.
Step 5 — Pre-identify a returning visitor (optional)
If you already know the customer (e.g. from your CRM or logged-in user on your site):
<script src="https://your-domain.com/chat/chat.php" data-api_hash_token="YOUR_API_TOKEN" data-con_id="ENCRYPTED_CONTACT_ID" data-name="John Doe" data-history="1" data-default="open"> </script>
The visitor skips the intro form and goes straight to chat.
Step 6 — Test before going live
1. Open **`https://your-domain.com/chat/test.html`** (or the preview link from embed.php). 2. Send a test message. 3. In Biz1, open the matching **customer → Chat tab** and confirm the message arrived. 4. Reply from Biz1 and confirm the visitor sees it (or use the test inject buttons on the test page).
Step 7 — Reply from Biz1
When a visitor chats on your site:
1. A customer record is created or matched. 2. Open that customer in Biz1. 3. Go to **Chat tab**. 4. Type your reply.
You can also use the **sidebar Chat** for quick access.
Visitor experience (step by step)
First visit
1. Visitor lands on your website. 2. Clicks the **chat icon** (bottom corner). 3. Fills in **name, email, phone**. 4. Submits → chat opens with a greeting. 5. Sends messages, files, or voice notes.
Return visit (within ~30 days)
1. Visitor returns to your site. 2. Clicks chat icon — **no form** (remembered by browser). 3. If history is on, previous messages load automatically.
Languages & RTL
| Language | Code | Default direction |
|----------|------|-------------------|
| English | `en` | LTR |
| Hebrew | `he` | RTL |
| Arabic | `ar` | RTL |
| Thai | `th` | LTR |
| Burmese | `my` | LTR |
Hebrew and Arabic auto-detect RTL if direction is not set.
Plan note
| Item | Free plan |
|------|-----------|
| Embed chat / API token | Typically requires paid plan or API access |
Core **client chat inside Biz1** (where you reply) is included on free. See FREE_PLAN_MAP.md.
Quick checklist
- [ ] Copy **API Token** from Settings - [ ] Configure widget at **`/chat/embed.php`** - [ ] Paste embed script on your website - [ ] Test at **`/chat/test.html`** - [ ] Confirm messages appear in Biz1 **Customer → Chat** - [ ] Train team to reply from the Chat tab
