Update docs

Author: Your Name

docs/bot/check-conditions.md

@@ -40,6 +40,14 @@ One of the few possible scenarios can be
 * `{{args.chat.online_user.previous_chat.id}} > 0` and use that condition to check did visitor had chat before with you.
 * `{args.msg.msg}` OR `{args.chat.last_message}` check against last visitor message.
 * `media_type` you can check this way was uploaded file or not. In right part just enter extensions `jpg,png,jpeg,gif` and as a comparison variable choose `In list, items separated by ||` 
+* `custom_schedule` E.g `2,12:30-13:00;1,12:30-14:00` it will be valid on Monday and Tuesday within specific time ranges. You can use with `=` and `!=` comparable operators. E.g `custom_schedule = 1` (Schedule matches) or `custom_schedule != 1` (Schedule does not match). More examples:
+
+```
+1-5,11:00-20:00 - Monday to Friday, 11:00 to 20:00
+6-7,11:00-19:00 - Saturday to Sunday, 11:00 to 19:00
+1,10:00-18:00 - Monday only, 10:00 to 18:00
+7,09:00-17:00 - Sunday only, 09:00 to 17:00
+```
 
 If you do not enter `Value` means it's empty.
 

docs/bot/conditions.md

@@ -87,6 +87,16 @@ This is extremely useful in case you have a bot and to migrate some of its flows
  * You can use E.g `is_lt_user` to expecting condition to be valid
  * You can use E.g `-is_lt_user` (`-`) prefix for expecting condition to be invalid
 
+## Date range use case
+
+You can have conditions which work based on date
+
+![](/img/bot/conditions/conditions.jpg)
+
+After you have a defined condition, you can use it in trigger
+
+![](/img/bot/conditions/conditions-trigger.jpg)
+
 ## Bot Example
 
 Example usage in a bot:

docs/bot/image-file-verification-flow.md

@@ -63,7 +63,21 @@ We will listen to `file.verify_img_file` event as it's dispatched once image nee
 
 ![](/img/bot/moondream/webhook.jpg)
 
-## Permissions
+## Sample flow using OpenAI
+
+### Rest API
+
+* Import [Rest API](/img/bot/open-ai-image-verification/rest-api.json) and change `YOUR_API_KEY` in `Authorization` section with your own API key.
+
+### Bot setup
+
+* Import [Bot](/img/bot/open-ai-image-verification/bot.json). Choose in bot import window just imported Rest API
+
+### Webhook setup
+
+We will listen to `file.verify_img_file` event as it's dispatched once image needs verification.
+
+# Permissions
 
 Operator MUST have `lhfile,verify_file` permission to check verification of file access.
 
@@ -121,6 +135,8 @@ They are identical to chat permissions so same flow applies
 
 > `lhmailconv,can_download` - this permission should be removed from operators as it allows to download raw eml content which includes images themself.
 
+> `lhmailconv,download_restricted` - this permission allows to download file if file extension is one of the restricted ones. `Mail conversations options => File download restrictions`
+
 ### Debugging
 
 * Request from Rest API for chat calls will be logged under message ID. Use `Object ID` field and enter Message ID. Message ID you can find by expanding message details and you will see `Message ID: <number>` field.

docs/bot/sentiment-analysis-per-message.md

@@ -141,8 +141,9 @@ We are currently interested in the following events:
 
 *   `chat.web_add_msg_admin`: Listens for operator messages and sets the sentiment.
 *   `chat.chat_started`: Listens for the first visitor message.
-*   `chat.addmsguser`: Listens for visitor messages.
+*   `chat.addmsguser`: Listens for visitor messages (web widget).
 *   `chat.close`: Summarizes the sentiment based on chat messages.
+*   `chat.addmsguser_webhook`: Listens for visitor messages (incoming webhook).
 
 ![](/img/bot/sentiment-per-message/webhooks.png)
 

docs/bot/text.md

@@ -27,6 +27,8 @@ Text message can have few sending options
     * `{good_morning_monday__Good morning monday__t[7:9]||1}` show this message only on Monday
     * `{good_morning_tue_wed__Good morning monday__t[7:9]||2,3}` show this message only on Tuesday and Wednesday
 * You can give random answer by separating messages by `|||` or just clicking ![](/img/bot/new-variation.png)
+  * It has to be as a separate character from the new line
+  * Or wrap it with spaces so it won't be included in any other parsing tags.
 
 First message part before text message is text identifier and can be used to translating messages to multiple languages.
 

docs/chat/offline.md

@@ -183,6 +183,8 @@ The email and offline request will be assigned to the very first defined departm
 
 * `{args.input_data.*}` - hold direct visitor entered data.
 * `{args.chat.phone}, {args.input_data.email}, {args.input_data.username}` - if you are prefilling variables via JS it will be overridden by it. So it won't hold visitor entered data. If you are not prefilling vars via JS it's safe just to use `{args.chat.*`
+* `{args.chatprefil.*}` - holds original chat data
+* `{args.chat.*}` - holds chat data where it's data is set from visitor entered data.
 
 Sample of offline chat message content
 

docs/hooks.md

@@ -843,6 +843,21 @@ erLhcoreClassChatEventDispatcher::getInstance()->dispatch('chat.unread_chat',arr
 erLhcoreClassChatEventDispatcher::getInstance()->dispatch('chat.addmsguser',array('files' => $files, 'chat' => & $chat, 'msg' => & $msg));
 ```
 
+### chat.addmsguser_webhook
+**File:** https://github.com/LiveHelperChat/livehelperchat/commit/0dbda405f4e9fb6adc379c345788a23fcdd80848
+**Purpose:** Triggered when a user adds a message via incoming webhook.
+
+```php
+erLhcoreClassChatEventDispatcher::getInstance()->dispatch('chat.addmsguser_webhook', array(
+    'chat' => & $chat,
+    'msg' => $msg,
+    'source' => 'webhook',
+    'webhook' => & $incomingWebhook,
+    'webhook_data' => $payloadAll,
+    'webhook_msg' => $payloadMessage
+));
+```
+
 ### chat.auto_responder_triggered
 **File:** https://github.com/LiveHelperChat/livehelperchat/tree/cf4ff02ac116cc7b99f8192bb6d7a378c3a31aec/lhc_web/modules/lhchat/addmsguser.php  
 **Line:** 126  

docs/integrating/slack-notification.md

@@ -9,7 +9,7 @@ This guide explains how to send a Slack notification when a visitor sends a mess
 
 ## How does it work?
 
-*   Set up a webhook in `Home > System configuration > Webhooks` for the `chat.addmsguser` event.
+*   Set up a webhook in `Home > System configuration > Webhooks` for the `chat.addmsguser` (web widget) and `chat.addmsguser_webhook` (incoming webhook) event.
 *   Create a bot and define the keyword to listen for.
 *   Configure the bot to execute a REST API call to send the Slack notification.