Mobile app setup
In order for mobile app to function properly you have to be using min 3.42v.
Mobile apps
The most recent build can be found here.
How to keep online status?
As we all know once app is closed background sync processe is stopped so Live Helper Chat can't know is it online or not. To retain your online status you can do following things.
- Setup department online hours
- Change your online status to "Always online" from "Based on activity"
- Once you finished your work shift don't forget to go offline.
Permissions
In order for mobile app to work correctly operator has to have permission to
'lhrestapi','use_direct_logins'
Notifications
In order to enable mobile app notifications you have to enable mobile notifications there.
Configuration -> System -> Mobile (Settings)
Testing
The Easiest way to test is just to login to Live Helper Chat back office and go to System configuration -> Mobile (Sessions)
and edit session record. In edit window just click Send test notification
.
If you are not receiving notification check those things.
- You have enabled notifications in
Configuration -> System -> Mobile (Settings)
Most of the time if app is installed on iPhone for some reason it does not receive notifications. If this is happening to you do the following
- Uninstall the app
- Delete related session record
Configuration -> System -> Mobile (Sessions)
- Install an app
- Now notifications should work.
Live notifications testing
If you do not receive notification once chat is started, but you receive notification with Send test notification
check those things.
- You have proper permissions as operator
- You are online as an operator.
- You have enabled notifications in
Configuration -> System -> Mobile (Settings)
- You have permission to access department where chat started.
- App is using few notifications channels where each channel can have different settings. Make sure app notifications settings are correct.
- If for some reason sessions status is
thumbs down
. You can delete a session and re-login from the app and try again to test notifications.
tip
At the moment clicking notifications does not open chat window. It just opens an app. This will be changed in next releases.
How to login?
Login to demo of live helper chat details:
- https://demo.livehelperchat.com
- Login: admin
- Password: demo
- Un check "Append index.php to address"
I can't login?
- Make sure you have entered domain address correctly, pay attention does your URL requires
www
or not.https://www.example.com
andhttps://example.com
are two different URL's - If you still can't login please apply this
.htaccess
file because sometimesAuthorization
headers are not parsed correctly by apache server.
Apache config file if you are running in a root directory. E.g https://example.com/index.php/site_admin/user/login
or https://example.com/site_admin/user/login
AddType application/wasm .wasm
<Files ~ "\.(gif|jpe?g?|png|bmp|swf|css|js|svg|otf|eot|ttf|woff|woff2|map|swf|mp3|ogg|wasm|wav|pdf|ico|txt)$"> Header always Set Access-Control-Allow-Origin "*" Header always Set Access-Control-Allow-Methods: "GET, POST, OPTIONS, PUT, DELETE" Header always Set Access-Control-Allow-Headers: "Origin, X-Requested-With, Content-Type, Accept, API-Key, Authorization"</Files>
RewriteEngine On
# If for some reason you can't authentificate for Rest API try to uncomment following lines# https://stackoverflow.com/questions/26475885/authorization-header-missing-in-php-post-request
RewriteCond %{HTTP:Authorization} ^(.*)RewriteRule .* - [e=HTTP_AUTHORIZATION:%1]
# Adds support for URL without index.php in URLRewriteRule ^/var/[^/]+/cache/(stylesheets|images|javascripts?)/.* - [L]RewriteRule ^upgrade.php - [L]RewriteRule !\.(gif|jpe?g|png|bmp|css|js|xml|html|json|ico|mp3|wasm|ogg|wav|ogv|map|swf|flv|otf|woff2|woff|eot|ttf)|var(.+)storage.pdf(.+)\.pdf$ index.php
DirectoryIndex index.php
Apache config to try if you are running in a subdirectory. E.g https://example.com/lhc_web/index.php/site_admin/user/login
AddType application/wasm .wasm
<Files ~ "\.(gif|jpe?g?|png|bmp|swf|css|js|svg|otf|eot|ttf|woff|woff2|swf|mp3|ogg|wasm|wav|pdf|ico|txt)$"> Header always Set Access-Control-Allow-Origin "*" Header always Set Access-Control-Allow-Methods: "GET, POST, OPTIONS, PUT, DELETE" Header always Set Access-Control-Allow-Headers: "Origin, X-Requested-With, Content-Type, Accept, API-Key, Authorization"</Files>
RewriteEngine On
# If for some reason you can't authentificate for Rest API try to uncomment following lines# https://stackoverflow.com/questions/26475885/authorization-header-missing-in-php-post-request
RewriteCond %{HTTP:Authorization} ^(.*)RewriteRule .* - [e=HTTP_AUTHORIZATION:%1]
What to enter if I'm running Live Helper Chat in subfolder/subdomain?
- If subdomain host in that case would be
https://<subdomain>.example.org
- If sub-folder host would be
https://example.org/support
How to compile?
Refer to flutter documentation. Few quick tips.
- Comment these lines - https://github.com/LiveHelperChat/lhc_messenger/blob/master/android/app/build.gradle#L18-L20
- Comment these lines - https://github.com/LiveHelperChat/lhc_messenger/blob/master/android/app/build.gradle#L39-L46
- Comment these lines - https://github.com/LiveHelperChat/lhc_messenger/blob/master/android/app/build.gradle#L39-L46
- Comment these lines - https://github.com/LiveHelperChat/lhc_messenger/blob/master/android/app/build.gradle#L53
- Comment these lines - https://github.com/LiveHelperChat/lhc_messenger/blob/master/android/app/build.gradle#L72
My visitors can't see while I'm typing
Most likely it's a problem of apache because it removes Authorization
header. Please see this article for a possible fix.
Demo images