Documentation

1. Installation & Setup

Step 1: Create Your Account

Sign up at CallbackHero Dashboard and choose your plan.

Step 2: Get Your Widget Code

After logging in, navigate to the Widgets section and copy your unique widget code:

<script>
var _emv = _emv || [];
_emv['key'] = 'YOUR_WIDGET_KEY';

(function() {
    var em = document.createElement('script');
    em.type = 'text/javascript';
    em.async = true;
    em.src = 'https://callbackhero.com/cbh.js';
    var s = document.getElementsByTagName('script')[0];
    s.parentNode.insertBefore(em, s);
})();
</script>

Step 3: Install on Your Website

Paste the code just before the closing </body> tag on every page where you want the widget to appear.

💡 Tip: For WordPress, WooCommerce, Shopify, or other CMS platforms, add the code to your theme's footer template or use a header/footer code injection plugin.

Step 4: Verify Installation

Visit your website and you should see the floating callback button appear in the bottom-right corner after a few seconds.

2. Widget Configuration

Basic Settings

Widget Key: Unique identifier for your widget (auto-generated)
Website URL: The domain where the widget will be installed
Email Notifications: Receive alerts for new callbacks
Active Status: Enable/disable the widget without removing code

Advanced Options

Timeout Period: How long before showing widget again to same visitor
Callback Time: Expected time for callback (shown to customer)
Exit Intent: Show widget when visitor is about to leave
URL Filtering: Show/hide widget on specific pages

3. Customization Options

Colors

Customize the widget to match your brand:

Primary Color - Main widget background and button color
Secondary Color - Accents and hover states
Text Color - Customize text for readability

Text Customization

Personalize all text displayed in the widget:

Welcome message
Button text
Form placeholders
Success messages
Offline messages

Position

Choose where the widget button appears on your site (bottom-right, bottom-left, etc.)

4. Phone Number Setup

Adding Phone Numbers

You can configure up to 5 phone numbers depending on your plan:

⚠️ Important: Always use international format with country code (e.g., +49301234567 for Germany)

Go to Widgets in your dashboard
Click Edit on your widget
Scroll to Phone Numbers section
Enter phone numbers in international format
Toggle the active status for each number
Save your changes

Call Routing

When multiple numbers are active, calls are distributed based on availability and current workload.

5. Working Hours

Setting Operating Hours

Configure when your team is available for callbacks:

Daily Hours: Set start and end times (e.g., 9:00 AM - 6:00 PM)
Weekdays: Select which days you're available (Mon-Sun)
Night Mode: Show alternative message outside business hours
Offline Message: Custom message when unavailable

Weekday Pattern

The 7-digit pattern represents Monday through Sunday:

1111100 = Mon-Fri (weekend off)
1111110 = Mon-Sat (Sunday off)
1111111 = Every day

6. Analytics & Reporting

Dashboard Overview

Your dashboard provides real-time insights:

Total Calls: Number of callbacks requested
Call Duration: Total and average call times
Conversion Rate: Percentage of visitors requesting callbacks
Active Widgets: Number of configured widgets

Visitor Tracking

Monitor visitor behavior:

Impressions - How many times widget was shown
Pageviews - Pages where widget appeared
Call events - Successful callback requests
Browser and location data
Referrer information

Call Records

Corporate plans include call recording features with 30-90 day retention for quality assurance.

7. Troubleshooting

Widget Not Appearing

Verify the code is installed before </body> tag
Check that your widget is set to "Active" in dashboard
Clear your browser cache and reload the page
Check browser console for JavaScript errors
Verify the domain matches your widget configuration

Calls Not Connecting

Ensure phone numbers are in international format (+country code)
Verify at least one phone number is marked as "Active"
Check that current time is within your working hours
Confirm your account has sufficient call credits

Styling Issues

Widget has z-index: 1000 - adjust if conflicts occur
Widget uses inline styles - CSS overrides may not work
Use customization options in dashboard instead of CSS

💚 Still having issues? Contact our support team for assistance.

Table of Contents