livehelperchat/twilio

Twilio SMS chat support for LiveHelperChat

Live helper chat

It's an open-source powered application that brings simplicity and usability into one place. With Live Helper Chat, you can bring live support to your site for free. http://livehelperchat.com.

Need help?

• Documentation - https://doc.livehelperchat.com
• Forum/Discussions - https://github.com/LiveHelperChat/livehelperchat/discussions
• Chat (Discord) https://discord.gg/YsZXQVh
• Laravel version of Live Helper Chat

Demo

http://livehelperchat.com/demo-12c.html

Integrations

• Mobile app flutter
• Agora - Voice & Video & ScreenShare powered by agora, paid
• Jitsi - Voice & Video & ScreenShare powered by jitsi, Free out of the box integration
• Rest API
• Bot with the possibility to integrate any third-party AI
• Telegram
• Rasa
• Mattermost
• Facebook messenger
• Facebook WhatsApp
• Google Business Message
• Insult detection powered by DeepPavlov.ai and NudeNet
• SMS, WhatsApp (Twilio based)
• WhatsApp open-wa based.
• Elasticsearch get statistic for millions of chats in seconds
• Node.js
• Docker
• Background worker for heavy tasks offload Rest API calls
• Integrate any third party Rest API
• Google Authentication login using Google account
• 2FA Authenticator mobile app support
• Amazon S3 scale infinitely by storing app files in the cloud
• Desktop app written with electron
• Sentiment analysis using DeepPavlov
• Shopify integration
• MessageBird integration
• CloudTalk integration
• Chat API integration

Quick development guide

• After the app is installed, disable cache and enable debug output.
  • https://github.com/LiveHelperChat/livehelperchat/blob/master/lhc_web/settings/settings.ini.default.php#L13-L16
  • Change the following values to:

  * debug_output => true
  * templatecache => false
  * templatecompile => false
  * modulecompile => false
  

• To compile JS from lhc_web folder execute. This will compile main JS and old widget javascript files.
  • npm install && gulp
• To compile new widget V2
  • There is two apps wrapper and widget
  • cd lhc_web/design/defaulttheme/widget/wrapper && npm install && npm run build
  • cd lhc_web/design/defaulttheme/widget/react-app && npm install && npm run build && npm run build-ie
• To recompile back office React APP (Left toolbar, Group Chat etc...)
  • cd lhc_web/design/defaulttheme/js/admin && npm run build
• Recompile static JS/CSS files. This is required if you change core JS files. It also avoids missing CSS/JS files if more than one server is used.
  • php cron.php -s site_admin -c cron/util/generate_css -p 1 && gulp js-static
• ORM - https://doc.livehelperchat.com/docs/development/orm
• Common classes - https://doc.livehelperchat.com/docs/development/common-classes
• To recompile everything at once
  • cd lhc_web/ && ./deploy.sh

Extensions

https://github.com/LiveHelperChat

Translations contribution

https://explore.transifex.com/remigijus-kiminas/live-helper-chat/

Folders structure

• Directories content:
• lhc_web - WEB application folder.

Features

A few main features:

• Bot with the possibility to integrate any third-party AI
• XMPP support for notifications about new chats (iPhone, iPad, Android, Blackberry, GTalk, etc.)
• Chrome extension
• Repeatable sound notifications
• Work hours
• See what the user sees with a screenshot feature
• Drag & Drop widgets, minimize/maximize widgets
• Multiple chats at the same time
• See what users are typing before they send a message
• Multiple operators
• Send delayed canned messages as if it was a real user typing
• Chats archive
• Priority queue
• Chats statistic generation, top chats
• Resume chat after the user closed the chat
• All chats in a single window with tabs interface; tabs are remembered before they are closed
• Chat transcript print
• Chat transcript send by mail
• Site widget
• Page embed mode for live support script or widget mode, or standard mode
• Multilanguage
• Chats transfering
• Departments
• Files upload
• Chat search
• Automatic transfers between departments
• Option to generate JS for different departments
• Option to prefill form fields.
• Option to add custom form fields, which can be either user variables or hidden fields. Useful if you are integrating with a third-party system and want to pass user_id, for example.
• Cronjobs
• Callbacks
• Closed chat callback
• Unanswered chat callback
• Asynchronous status loading, not blocking site javascript.
• XML, JSON export module
• Option to send transcript to users e-mail
• SMTP support
• HTTPS support
• No third parties cookies dependency
• Previous users chats
• Online users tracking, including geo detection
• GEO detection using three different sources
• Option to configure start chat fields
• Sounds on pending chats and new messages
• Google chrome notifications on pending messages.
• Browser title blinking then there is pending message.
• Option to limit pro active chat invitation messages based on pending chats.
• Option to configure frequency for pro active chat invitation message. You can set after how many hours for the same user invitation message should be shown again.
• Users blocking
• Top performance with enabled cache
• Windows, Linux and Mac native applications.
• Advanced embed code generation with numerous options of includable code.
• Template override system
• Module override system
• Support for custom extensions
• Changeable footer and header content
• Option to send messges to anonymous site visitors,
• Canned messages
• Informing then operator or user is typing.
• Option to see what user is typing before he sends a message
• Canned messages for desktop client
• Voting module
• FAQ module
• Online users map
• Pro active chat invitatio
• Remember me functionality
• Total pageviews tracking
• Total pageviews including previous visits tracking
• Visits tracking, how many times user has been on your page.
• Time spent on site
• Auto responder
• BB Code support. Links recognition. Smiles and few other hidden features :)
• First user visit tracking
• Option for customers mute sounds
• Option for operators mute messages sounds and new pending chat's sound.
• Option to monitor online operators.
• Option to have different pro active messages for different domains. This can be archieved using different identifiers.
• Dekstop client supports HTTPS
• Protection against spammers using advanced captcha technique without requiring users to enter any captcha code.
• Option for operator set online or offline mode.
• Desktop client for
• Windows
• Linux
• Mac
• Flexible permission system:
• Roles
• Groups
• Users

Forum: http://forum.livehelperchat.com/

twilio's Issues

Update Twilio SDK

The legacy library is currently used.

I suggest migrating to the latest library.

Auto return to dashboard

Hi Team,

I suggest after clicking the Send SMS IF the message is sent, return to the dashboard automatically.

Eric

Can't receive Inbound SMS

I tried posting to the callback URL and the response is Invalid recipient.

https://forum.livehelperchat.com/viewtopic.php?pid=13822#p13822

SSL issue IIS7

We keep getting the following error when trying to use the twilio extension on LHC SSL certificate problem: unable to get local issuer certificate can anyone advise?

PHP 7.4 - Undefined index: To

[17-Jan-2020 12:10:12] WARNING: [pool www] child 96541 said into stderr: "NOTICE: PHP message: PHP Notice: Undefined index: To in /var/www/lhc/lhc_web/extension/twilio/bootstrap/bootstrap.php on line 450"
[17-Jan-2020 12:10:12] WARNING: [pool www] child 96541 said into stderr: "NOTICE: PHP message: Exception: Invalid recipient in /var/www/lhc/lhc_web/extension/twilio/bootstrap/bootstrap.php:453"
[17-Jan-2020 12:10:12] WARNING: [pool www] child 96541 said into stderr: "Stack trace:"
[17-Jan-2020 12:10:12] WARNING: [pool www] child 96541 said into stderr: "#0 /var/www/lhc/lhc_web/cache/compiledtemplates/4f30eb016ce809098e0fc0e06f873835.php(2): erLhcoreClassExtensionTwilio->processCallback(Array)"
[17-Jan-2020 12:10:12] WARNING: [pool www] child 96541 said into stderr: "#1 /var/www/lhc/lhc_web/lib/core/lhcore/lhmodule.php(96): include('/var/www/lhc/lh...')"
[17-Jan-2020 12:10:12] WARNING: [pool www] child 96541 said into stderr: "#2 /var/www/lhc/lhc_web/lib/core/lhcore/lhmodule.php(542): erLhcoreClassModule::runModule()"
[17-Jan-2020 12:10:12] WARNING: [pool www] child 96541 said into stderr: "#3 /var/www/lhc/lhc_web/index.php(44): erLhcoreClassModule::moduleInit()"
[17-Jan-2020 12:10:12] WARNING: [pool www] child 96541 said into stderr: "#4 {main}"

PDOException Table 'livechat-db.lhc_twilio_phone' doesn't exist

Fresh Install of LHC

1. Add twilio to extension directory
2. Edit twillio settings file
3. Enable twillio by adding to the settings file.
4. LHC admin Modules -> Twilio -> Twilio Phones

• PDOException Object
  (
  [message:protected] => SQLSTATE[42S02]: Base table or view not found: 1146 Table 'liveichat-db.lhc_twilio_phone' doesn't exist
  [string:Exception:private] =>
  [code:protected] => 42S02
  [file:protected] => /home/chatexphvac/public_html/lib/core/lhcore/lhdbtrait.php
  [line:protected] => 219
  [trace:Exception:private] => Array
  (
  [0] => Array
  (
  [file] => /lib/core/lhcore/lhdbtrait.php
  [line] => 219
  [function] => execute
  [class] => PDOStatement
  [type] => ->
  [args] => Array
  (
  )

           )
  
       [1] => Array
           (
               [file] => /extension/twilio/modules/lhtwilio/list.php
               [line] => 16
               [function] => getCount
               [class] => erLhcoreClassModelTwilioPhone
               [type] => ::
               [args] => Array
                   (
                       [0] => Array
                           (
                           )
  
                   )
  
           )
  
       [2] => Array
           (
               [file] => /lib/core/lhcore/lhmodule.php
               [line] => 98
               [args] => Array
                   (
                       [0] => extension/twilio/modules/lhtwilio/list.php
                   )
  
               [function] => include
           )
  
       [3] => Array
           (
               [file] => /lib/core/lhcore/lhmodule.php
               [line] => 486
               [function] => runModule
               [class] => erLhcoreClassModule
               [type] => ::
               [args] => Array
                   (
                   )
  
           )
  
       [4] => Array
           (
               [file] => index.php
               [line] => 39
               [function] => moduleInit
               [class] => erLhcoreClassModule
               [type] => ::
               [args] => Array
                   (
                   )
  
           )
  
   )
  

  [previous:Exception:private] =>
  [errorInfo] => Array
  (
  [0] => 42S02
  [1] => 1146
  [2] => Table 'livechat-db.lhc_twilio_phone' doesn't exist
  )

)

Whatsapp Twilio

Hi,
I read the Twilio Whatsapp documentation and found that SMS is similar, it would be interesting for us to implement this functionality on the LHC.

https://www.twilio.com/docs/sms/whatsapp/api#configuring-inbound-message-webhooks

Receiving a WhatsApp message
The web hook for inbound messages uses the same format as incoming SMS messages, with the exception that To and From addresses will be set to WhatsApp addresses (whatsapp: and whatsapp:<User's E.164 phone number>) respectively.

Can't receive Inbound SMS

PHP Version 7.2
Prefixed number with whatsapp:

[20-Oct-2020 20:29:07 Asia/Kolkata] Exception: Invalid recipient in /home/helpfuldotnet/public_html/chatbot/extension/twilio/bootstrap/bootstrap.php:610
Stack trace:
#0 /home/helpfuldotnet/public_html/chatbot/cache/compiledtemplates/4f30eb016ce809098e0fc0e06f873835.php(2): erLhcoreClassExtensionTwilio->processCallback(Array)
#1 /home/helpfuldotnet/public_html/chatbot/lib/core/lhcore/lhmodule.php(96): include('/home/helpfuldo...')
#2 /home/helpfuldotnet/public_html/chatbot/lib/core/lhcore/lhmodule.php(555): erLhcoreClassModule::runModule()
#3 /home/helpfuldotnet/public_html/chatbot/index.php(49): erLhcoreClassModule::moduleInit()
#4 {main}
[20-Oct-2020 20:32:23 Asia/Kolkata] PHP Deprecated:  Function create_function() is deprecated in /home/helpfuldotnet/public_html/chatbot/extension/twilio/vendor/twilio-php-master/Services/Twilio/Resource.php on line 93

Docs

https://livehelperchat.com/twilio-support-for-sms-chat-477a.html

3rd?

How to close chat?

Close Twilio SMS and Whatsapp chat when operator close chat.

In https://github.com/LiveHelperChat/twilio/blob/master/bootstrap/bootstrap.php comment lines below:

Lines: 470, 471 and 493

• `//if ($tChat !== false && ($chat = $tChat->chat) !== false ) {
• //$renotify = false;
• // fix LiveHelperChat/fbmessenger#1
• if ($chat instanceof erLhcoreClassModelChat && $chat->status == erLhcoreClassModelChat::STATUS_CLOSED_CHAT) {
• $chat->status = erLhcoreClassModelChat::STATUS_PENDING_CHAT;
• $chat->status_sub_sub = 2; // Will be used to indicate that we have to show notification for this chat if it appears on list
• $chat->user_id = 0;
• $chat->pnd_time = time();
• $renotify = true;
• //}`

Add disable option for twilio phones

New pending SMS not send notification email

Hi,
I tested the SMS with Twilio, inbound and outbound working fine, but the pending SMS didn't send the notification email, other messages from the website "Visitor" working fine, I want to receive every pending message email notification. Please help

Eric

What is the callback value for buttons in bot chat?

Sending the Button value doesn't work

Display Phone Number Department

In the dropdown where you select the phone number you're sending from, we'd like to show which department the phone number is assigned to.