Table of Contents

Slack Integration & Synchronization

The Slack integration empowers your team to handle customer support directly from your existing Slack workspace. By synchronizing the two platforms, messages sent from Slack are mirrored in the chat dashboard, and user replies are pushed to Slack in real-time.

How to Setup Slack

1

Install & Activate

Navigate to Settings > Apps, locate Slack, and enter your license key to install the application. If you are using the Cloud version, simply click Active.

2

Synchronize Workspace

Go to Settings > Slack and click the Synchronize now button. Follow the authentication prompts to connect your specific Slack workspace.

3

Channel Configuration

Select a Public Channel (e.g., #general) to receive notifications. If you encounter issues, ensure you chose a public channel during the initial sync. If not, re-sync and select the correct channel type.

Troubleshooting Slack Issues

Cannot Reply from Slack

Navigate to /script/apps/slack/post.php in your browser to verify connectivity. Additionally, check your Slack Workspace Settings > Permissions and ensure that “Anyone can create public channels” is enabled. If problems persist, contact Slack support.

OpenCart Integration

This integration supports OpenCart 3 and OpenCart Multistore. It embeds the chat widget and synchronizes logged-in customer data automatically.

OpenCart Setup Guide

1

App Installation

Install the OpenCart app via Settings > Apps. Go to Settings > OpenCart and fill in your store URL and database details.

2

API Configuration

In OpenCart Admin, navigate to System > Users > API. Edit the “Default” user, generate an API Key, enable the Status, and ensure your server IP is added to the allowed IP list.

3

Edit Controller File

Edit catalog/controller/common/header.php via FTP. Insert the following code block inside the $data variable definition:

$data['script'] = $this->customer->getFirstName() ? 'var SB_DEFAULT_USER = { first_name: "' . $this->customer->getFirstName() . '", last_name: "' . $this->customer->getLastName() . '", email: "' . $this->customer->getEmail() . '", extra: { opencart_id: ["' . $this->customer->getId() . '|' . (isset($_COOKIE['OCSESSID']) ? $_COOKIE['OCSESSID'] : '') . '", "Open Cart ID"], phone: ["' . $this->customer->getTelephone() . '", "Phone"], opencart_store: ["' . $this->config->get('config_name') . '", "OpenCart Store"], opencart_store_url: ["' . $_SERVER['HTTP_HOST'] . '", "OpenCart Store URL"] } };' : '';
4

Update Template & API

Edit catalog/view/theme/default/template/common/header.twig (or your active theme folder). Add <script>{{ script }}</script> inside the <head> tag. Finally, download the sb.php file from the installation package and upload it to catalog/controller/api/.

Active eCommerce Integration

For Active eCommerce CMS users, this integration enables chat features and supports “Sellers Chat” for multi-vendor marketplaces. Note: Not compatible with the Cloud version.

  • App Setup: Activate the App and enter your database details. Retrieve the Secret Key (APP_KEY) from your website’s root .env file.
  • Code Integration: Edit the file \resources\views\frontend\inc\footer.blade.php. Insert the code below immediately after the <footer> tag. Replace [YOUR-SITE] with your actual chat installation URL.
<script src="https://[YOUR-SITE]/js/min/jquery.min.js"></script>
<script id="sbinit" src="https://[YOUR-SITE]/js/main.js"></script>
@php
$sb_code = '';
$sb_cart = false;
if (Auth::check() && !isAdmin()) $sb_code = 'var SB_AECOMMERCE_ACTIVE_USER = '. Auth::user()->id. ';';
if (isset($detailedProduct)) $sb_code.= 'var SB_DEFAULT_AGENT = "aecommerce-'. $detailedProduct->user->id. '";';
if (auth()->user() != null) $sb_cart = \App\Models\Cart::where('user_id', Auth::user()->id)->get(); else {
$temp_user_id = Session()->get('temp_user_id'); if ($temp_user_id) {
$sb_cart = \App\Models\Cart::where('temp_user_id', $temp_user_id)->get();
}}
if ($sb_cart && count($sb_cart) > 0) {
$sb_code.= 'var SB_AECOMMERCE_CART = ['; foreach ($sb_cart as $key => $item) { $sb_code.= '["'. $item['product_id']. '", "'. $item['price']. '", "'. $item['quantity']. '"],'; } $sb_code = substr($sb_code, 0, -1). '];';
}
if ($sb_code != '') echo '<script>'. $sb_code. '</script>';
@endphp

Sellers Chat: To restrict vendors to only see their own customer conversations, enable Settings > Miscellaneous > Hide conversations of other agents. Use the Import vendors button to automatically register sellers as agents.

Martfury Integration

Compatible with the Martfury Laravel Marketplace script. Note: Not compatible with the Cloud version.

  • Database: Get credentials from your .env file and enter them in Settings > Martfury.
  • Path Verification: Upload the verification file to the /public/ directory of Martfury and open it in a browser to confirm the path.
  • Front-End Code: Copy your chat installation code (found in Settings) and paste it into Martfury Admin > Appearance > Custom JS > Footer JS. Remove the jQuery script line if it’s already loaded by Martfury.
  • Sellers Chat: Enable “Private Chat” in Martfury settings. Import all vendors, then manually link each vendor to their store ID in the Private chat linking settings.

Zalo Integration Setup

Integrate your Zalo Official Account to receive and reply to messages directly.

Zalo Installation Process

1

Register Zalo App

Create a new App at developers.zalo.me. Copy the Application ID and Application Secret Key and paste them into Settings > Synchronization > Zalo.

2

Configure Webhooks

In the Zalo developer portal, go to Webhooks. Set the URL provided by your chat settings (Settings > Zalo > Synchronization > Webhook URL). Also, copy the OA Secret Key from the developer portal and save it in your chat settings.

3

Enable Events

You must enable all the following webhook events in the Zalo portal: user_send_location, user_send_image, user_send_link, user_send_text, user_send_sticker, user_send_gif, user_received_message, user_seen_message, oa_send_text, oa_send_image, oa_send_list, oa_send_gif, user_send_audio, user_send_video, user_send_file, user_reacted_message, user_received_message.

4

Link Official Account

Navigate to Official Account > OA Management in the Zalo portal and link your official account to the app.

5

Generate Tokens

Use the API Explorer tool. Select OA Access Token, choose your Official Account, and click Get Access Token. Copy the Refresh Token generated and paste it into Settings > Zalo > Synchronization > Refresh token.

6

Review & Test

Add a test user as Admin under the Role menu to test the integration. Finally, go to Sign up to use API > Official Account API, enable User Management, and click Submit for review.

Zendesk Integration

This integration links Zendesk users to chat users via email or phone number and creates tickets for new conversations.

  • Domain: If your Zendesk URL is https://script.zendesk.com, enter only script in Settings > Zendesk.
  • API Key: Generate a token in Zendesk (Admin > Channels > API > Settings > Add API token) and use your Zendesk email address.

WHMCS Integration

Requires installing the App within the chat system and a separate Add-on within WHMCS. Not compatible with Cloud version.

Go to Settings > Apps > WHMCS. Enter your license key, database details, and the full WHMCS installation URL. Ensure script/config.php is updated if database details change.

Upload the script folder from addon.zip to /modules/addons/ in your WHMCS installation. In WHMCS Admin, go to System Settings > Addon Modules, activate it, click Configure, and input your Chat Plugin URL.

Perfex CRM

Requires the chat system to be installed on the same domain and file system. Not compatible with Cloud version. Install the App in settings, then upload the module.zip in Perfex (Setups > Modules).

Other Messaging Integrations

Viber

Create a bot account at the Viber Partner site. Copy the Token into Settings > Viber. Your site must use HTTPS.