telegram-support-bot 0.1.12 → 0.1.13

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f542e3e9a21dc2d7d9c45c9b65b19aec360bad95b60f0e4f999f3a9f4c532700
-  data.tar.gz: 0136afb1b7bea4ce86afcd4f28b3af38f56743f4a2a4a87c29bfd33287f792e4
+  metadata.gz: 0e2776425f88d7b3255ed8130fbc382325c5c50234963b4cc4d626092e16defd
+  data.tar.gz: 7529852a1df10a48cf1b1381fb0d04822a9fc70875340e0cae3afb36da0430d2
 SHA512:
-  metadata.gz: 7599da9dab831b489bd6f687bf9d779fc5b3582a1a5546eea8d3c00e4febce46bddccc6aaa118177ad20e296f95fb1ff8f8bc54f013e30e41e462c9e3f8aa576
-  data.tar.gz: 00f33f8a9eed3902cbde9584d06a781880f6efe9a0cbd6f1405ac2450e82da1e0605a3c0eed25520e9c6c46e8291e40495276cd08cc59a0e92c7494023c35a13
+  metadata.gz: cc195cf56e0bdd9299d65342ab7619d9bc091727a09c66f3d4e56a4dde5689b3083cf0cc0531ab7784f85bb600b9b097c5ab056f62f617b2a420b47b980f54b5
+  data.tar.gz: d931f2c70b662d7167cc670a3e2b8eb6f88cfb8b3036dbdcd2f95f50b5c643762f1309921e0c593ce1b68ce38ff579e648bdbd751ad825074690a82a50705a76

data/CHANGELOG.md

@@ -4,6 +4,12 @@ All notable changes to this project will be documented in this file.
 
 ## [Unreleased]
 
+## [0.1.13] - 2026-02-26
+
+### Added
+- Optional `forward_start_to_support` configuration to forward the first user `/start`
+  message to support chat, so the team can proactively start the conversation.
+
 ## [0.1.12] - 2026-02-26
 
 ### Fixed

data/README.md

@@ -50,6 +50,8 @@ TelegramSupportBot.configure do |config|
   config.non_command_message_response = 'I only respond to commands. Please use /start.'
   # Optional: ask users to share their phone once for account lookup.
   config.request_contact_on_start = true
+  # Optional: forward the user's first /start message to support chat.
+  config.forward_start_to_support = false
   # Optional: block forwarding until contact is shared.
   config.require_contact_for_support = false
   # Optional callback to persist/lookup user profile in your app.
@@ -222,6 +224,7 @@ Behavior:
 - Triggered only for user-chat commands that start with `/` and are not `/start`.
 - Receives `command` (normalized to lowercase), `bot_username` (if present), and `args` (text after command).
 - Return `true` to stop forwarding to support chat; return `false`/`nil` to keep default forwarding.
+- `/start` can be forwarded once per user to support chat when `forward_start_to_support = true`.
 
 ## State Storage (Single Pod vs Multi-Pod)
 

data/lib/telegram_support_bot/configuration.rb

@@ -6,7 +6,7 @@ module TelegramSupportBot
                   :auto_away_message, :auto_away_interval, :ignore_unknown_commands,
                   :ignore_non_command_messages, :non_command_message_response,
                   :request_contact_on_start, :require_contact_for_support, :contact_request_message,
-                  :contact_received_message, :contact_invalid_message, :on_contact_received,
+                  :contact_received_message, :contact_invalid_message, :forward_start_to_support, :on_contact_received,
                   :on_user_command,
                   :state_store, :state_store_options, :mapping_ttl_seconds,
                   :reaction_count_ttl_seconds, :user_profile_ttl_seconds
@@ -25,6 +25,7 @@ module TelegramSupportBot
       @contact_request_message = 'Please share your phone number so we can quickly identify your account.'
       @contact_received_message = 'Thanks! We have saved your phone number.'
       @contact_invalid_message = 'Please use the button below to share your own phone number.'
+      @forward_start_to_support = false
       @on_contact_received = nil
       @on_user_command = nil
       @state_store = :memory

data/lib/telegram_support_bot/state_stores/memory.rb

@@ -11,6 +11,7 @@ module TelegramSupportBot
         @reverse_message_map = {}
         @reaction_count_state = {}
         @user_profiles = {}
+        @start_forwarded_users = {}
       end
 
       def message_map
@@ -49,6 +50,15 @@ module TelegramSupportBot
         )
       end
 
+      def start_forwarded_users
+        @start_forwarded_users_proxy ||= StateStore::MapProxy.new(
+          get_proc:   ->(key) { get_start_forwarded_user(key) },
+          set_proc:   ->(key, value) { set_start_forwarded_user(key, value) },
+          clear_proc: -> { clear_start_forwarded_users },
+          size_proc:  -> { start_forwarded_users_size }
+        )
+      end
+
       def get_message_mapping(key)
         synchronize { @message_map[normalize_key(key)] }
       end
@@ -113,6 +123,22 @@ module TelegramSupportBot
         synchronize { @user_profiles.size }
       end
 
+      def get_start_forwarded_user(key)
+        synchronize { @start_forwarded_users[normalize_key(key)] }
+      end
+
+      def set_start_forwarded_user(key, value)
+        synchronize { @start_forwarded_users[normalize_key(key)] = value }
+      end
+
+      def clear_start_forwarded_users
+        synchronize { @start_forwarded_users.clear }
+      end
+
+      def start_forwarded_users_size
+        synchronize { @start_forwarded_users.size }
+      end
+
       private
 
       def synchronize(&block)

data/lib/telegram_support_bot/state_stores/redis.rb

@@ -57,6 +57,15 @@ module TelegramSupportBot
         )
       end
 
+      def start_forwarded_users
+        @start_forwarded_users_proxy ||= StateStore::MapProxy.new(
+          get_proc:   ->(key) { get_start_forwarded_user(key) },
+          set_proc:   ->(key, value) { set_start_forwarded_user(key, value) },
+          clear_proc: -> { clear_start_forwarded_users },
+          size_proc:  -> { start_forwarded_users_size }
+        )
+      end
+
       def get_message_mapping(key)
         payload = parse_json(@redis.get(map_key(:message_map, key)))
         symbolize_hash(payload)
@@ -124,6 +133,22 @@ module TelegramSupportBot
         count_by_prefix(prefix(:user_profiles))
       end
 
+      def get_start_forwarded_user(key)
+        parse_json(@redis.get(map_key(:start_forwarded_users, key)))
+      end
+
+      def set_start_forwarded_user(key, value)
+        write_json(map_key(:start_forwarded_users, key), value, @user_profile_ttl_seconds)
+      end
+
+      def clear_start_forwarded_users
+        delete_by_prefix(prefix(:start_forwarded_users))
+      end
+
+      def start_forwarded_users_size
+        count_by_prefix(prefix(:start_forwarded_users))
+      end
+
       private
 
       def prefix(name)

data/lib/telegram_support_bot/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module TelegramSupportBot
-  VERSION = "0.1.12"
+  VERSION = "0.1.13"
 end

data/lib/telegram_support_bot.rb

@@ -59,6 +59,10 @@ module TelegramSupportBot
       state_store(bot_key).user_profiles
     end
 
+    def start_forwarded_users(bot_key = nil)
+      state_store(bot_key).start_forwarded_users
+    end
+
     def user_profile(chat_id, bot: nil)
       profiles = user_profiles(bot)
       profiles[chat_id] || profiles[chat_id.to_s] || profiles[chat_id.to_i]
@@ -178,6 +182,7 @@ module TelegramSupportBot
       if command_data && command_data[:command] == '/start'
         adapter.send_message(chat_id: chat_id, text: configuration.welcome_message)
         request_contact_from_user(chat_id: chat_id) if should_request_contact?(chat_id)
+        forward_start_to_support_chat_if_needed(message, chat_id: chat_id)
         return
       end
 
@@ -363,6 +368,7 @@ module TelegramSupportBot
         end
       end
       # scheduler.schedule_auto_away_message(message_id, message_chat_id)
+      result
     end
 
     def handle_my_chat_member_update(update)
@@ -503,6 +509,21 @@ module TelegramSupportBot
       configuration.request_contact_on_start && !contact_known_for_user?(chat_id)
     end
 
+    def should_forward_start_to_support?(chat_id)
+      configuration.forward_start_to_support && !start_forwarded_to_support?(chat_id)
+    end
+
+    def forward_start_to_support_chat_if_needed(message, chat_id:)
+      return unless should_forward_start_to_support?(chat_id)
+      return unless forward_message_to_support_chat(message, chat_id: chat_id)
+
+      start_forwarded_users[chat_id] = true
+    end
+
+    def start_forwarded_to_support?(chat_id)
+      !start_forwarded_users[chat_id].nil?
+    end
+
     def contact_known_for_user?(chat_id)
       !user_profile(chat_id).nil?
     end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: telegram-support-bot
 version: !ruby/object:Gem::Version
-  version: 0.1.12
+  version: 0.1.13
 platform: ruby
 authors:
 - Max Buslaev