telegram-support-bot 0.1.12 → 0.1.14

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f542e3e9a21dc2d7d9c45c9b65b19aec360bad95b60f0e4f999f3a9f4c532700
-  data.tar.gz: 0136afb1b7bea4ce86afcd4f28b3af38f56743f4a2a4a87c29bfd33287f792e4
+  metadata.gz: 1aa04c608a30e8eb69bd222ab37e804224d4850472bc183d52dee74b397557c1
+  data.tar.gz: a84baa26e47cb70191bc6b5736e86de0187efc799f1735b47b31114c03d7066d
 SHA512:
-  metadata.gz: 7599da9dab831b489bd6f687bf9d779fc5b3582a1a5546eea8d3c00e4febce46bddccc6aaa118177ad20e296f95fb1ff8f8bc54f013e30e41e462c9e3f8aa576
-  data.tar.gz: 00f33f8a9eed3902cbde9584d06a781880f6efe9a0cbd6f1405ac2450e82da1e0605a3c0eed25520e9c6c46e8291e40495276cd08cc59a0e92c7494023c35a13
+  metadata.gz: a4e14a5cc0d07a7f05764eaf0577eb965ef9db5e86e276d74196ed3e08c9f0956315e0bec3e9b5b5b2ec1b94f7429186e299b16a80473fff24731122ba481263
+  data.tar.gz: b875c18abaef4ad4dc5ce57d2e94635f354ca3e69d055fc2e9a0f8bdf626527dcd3ba16a021decd58d30746d0dfc7900f21aff707223955ccba8661d051ddb36

data/CHANGELOG.md

@@ -4,6 +4,18 @@ All notable changes to this project will be documented in this file.
 
 ## [Unreleased]
 
+## [0.1.14] - 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.
+- Update-level deduplication by Telegram `update_id` to prevent repeated replies/forwards
+  when webhook deliveries are retried.
+
+### Fixed
+- Initial `/start` forwarding is now fail-safe: errors in forwarding/persisting first-message
+  marker no longer crash update processing and block subsequent updates.
+
 ## [0.1.12] - 2026-02-26
 
 ### Fixed

data/README.md

@@ -50,8 +50,13 @@ 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: deduplicate repeated Telegram deliveries by update_id.
+  # Keep > 0 (default: 24h) to avoid repeated /start replies/forwards on retries.
+  config.processed_update_ttl_seconds = 24 * 60 * 60
   # Optional callback to persist/lookup user profile in your app.
   config.on_contact_received = ->(profile) { YourUserMatcher.sync_from_telegram(profile) }
   # Optional callback for user-chat commands other than /start.
@@ -222,6 +227,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)
 
@@ -242,6 +248,7 @@ TelegramSupportBot.configure do |config|
   # config.mapping_ttl_seconds = 30 * 24 * 60 * 60
   # config.reaction_count_ttl_seconds = 7 * 24 * 60 * 60
   # config.user_profile_ttl_seconds = nil
+  # config.processed_update_ttl_seconds = 24 * 60 * 60
 end
 ```
 

data/lib/telegram_support_bot/configuration.rb

@@ -6,10 +6,10 @@ 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
+                  :reaction_count_ttl_seconds, :user_profile_ttl_seconds, :processed_update_ttl_seconds
 
     def initialize
       @adapter                 = :telegram_bot
@@ -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
@@ -32,6 +33,7 @@ module TelegramSupportBot
       @mapping_ttl_seconds = 30 * 24 * 60 * 60
       @reaction_count_ttl_seconds = 7 * 24 * 60 * 60
       @user_profile_ttl_seconds = nil
+      @processed_update_ttl_seconds = 24 * 60 * 60
     end
   end
 end

data/lib/telegram_support_bot/state_store.rb

@@ -37,6 +37,7 @@ module TelegramSupportBot
           mapping_ttl_seconds: configuration.mapping_ttl_seconds,
           reaction_count_ttl_seconds: configuration.reaction_count_ttl_seconds,
           user_profile_ttl_seconds: configuration.user_profile_ttl_seconds,
+          processed_update_ttl_seconds: configuration.processed_update_ttl_seconds,
           **options
         )
       when :redis
@@ -46,6 +47,7 @@ module TelegramSupportBot
           mapping_ttl_seconds: configuration.mapping_ttl_seconds,
           reaction_count_ttl_seconds: configuration.reaction_count_ttl_seconds,
           user_profile_ttl_seconds: configuration.user_profile_ttl_seconds,
+          processed_update_ttl_seconds: configuration.processed_update_ttl_seconds,
           **options
         )
       else

data/lib/telegram_support_bot/state_stores/memory.rb

@@ -11,6 +11,8 @@ module TelegramSupportBot
         @reverse_message_map = {}
         @reaction_count_state = {}
         @user_profiles = {}
+        @start_forwarded_users = {}
+        @processed_updates = {}
       end
 
       def message_map
@@ -49,6 +51,24 @@ 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 processed_updates
+        @processed_updates_proxy ||= StateStore::MapProxy.new(
+          get_proc:   ->(key) { get_processed_update(key) },
+          set_proc:   ->(key, value) { set_processed_update(key, value) },
+          clear_proc: -> { clear_processed_updates },
+          size_proc:  -> { processed_updates_size }
+        )
+      end
+
       def get_message_mapping(key)
         synchronize { @message_map[normalize_key(key)] }
       end
@@ -113,6 +133,38 @@ 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
+
+      def get_processed_update(key)
+        synchronize { @processed_updates[normalize_key(key)] }
+      end
+
+      def set_processed_update(key, value)
+        synchronize { @processed_updates[normalize_key(key)] = value }
+      end
+
+      def clear_processed_updates
+        synchronize { @processed_updates.clear }
+      end
+
+      def processed_updates_size
+        synchronize { @processed_updates.size }
+      end
+
       private
 
       def synchronize(&block)

data/lib/telegram_support_bot/state_stores/redis.rb

@@ -8,7 +8,8 @@ module TelegramSupportBot
       DEFAULT_NAMESPACE = 'telegram_support_bot'
 
       def initialize(url: nil, redis: nil, namespace: DEFAULT_NAMESPACE,
-                     mapping_ttl_seconds: nil, reaction_count_ttl_seconds: nil, user_profile_ttl_seconds: nil, **_options)
+                     mapping_ttl_seconds: nil, reaction_count_ttl_seconds: nil, user_profile_ttl_seconds: nil,
+                     processed_update_ttl_seconds: nil, **_options)
         @redis = redis || begin
           require 'redis'
           ::Redis.new(url: url)
@@ -19,6 +20,7 @@ module TelegramSupportBot
         @mapping_ttl_seconds = mapping_ttl_seconds
         @reaction_count_ttl_seconds = reaction_count_ttl_seconds
         @user_profile_ttl_seconds = user_profile_ttl_seconds
+        @processed_update_ttl_seconds = processed_update_ttl_seconds
       end
 
       def message_map
@@ -57,6 +59,24 @@ 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 processed_updates
+        @processed_updates_proxy ||= StateStore::MapProxy.new(
+          get_proc:   ->(key) { get_processed_update(key) },
+          set_proc:   ->(key, value) { set_processed_update(key, value) },
+          clear_proc: -> { clear_processed_updates },
+          size_proc:  -> { processed_updates_size }
+        )
+      end
+
       def get_message_mapping(key)
         payload = parse_json(@redis.get(map_key(:message_map, key)))
         symbolize_hash(payload)
@@ -124,6 +144,38 @@ 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
+
+      def get_processed_update(key)
+        parse_json(@redis.get(map_key(:processed_updates, key)))
+      end
+
+      def set_processed_update(key, value)
+        write_json(map_key(:processed_updates, key), value, @processed_update_ttl_seconds)
+      end
+
+      def clear_processed_updates
+        delete_by_prefix(prefix(:processed_updates))
+      end
+
+      def processed_updates_size
+        count_by_prefix(prefix(:processed_updates))
+      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.14"
 end

data/lib/telegram_support_bot.rb

@@ -59,6 +59,14 @@ 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 processed_updates(bot_key = nil)
+      state_store(bot_key).processed_updates
+    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]
@@ -71,6 +79,9 @@ module TelegramSupportBot
 
     def process_update(update, bot: DEFAULT_BOT_KEY)
       with_bot_context(bot) do
+        update_id = update['update_id'] || update[:update_id]
+        return if duplicate_update?(update_id)
+
         # Handle different types of updates
         if update['message']
           # Process standard messages
@@ -87,6 +98,8 @@ module TelegramSupportBot
           # Log or handle unknown update types
           puts "Received an unknown type of update: #{update}"
         end
+
+        mark_update_as_processed(update_id)
       end
     end
 
@@ -178,6 +191,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 +377,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 +518,39 @@ 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
+    rescue StandardError => error
+      warn_start_forwarding_failure(chat_id: chat_id, message_id: message['message_id'], error: error)
+    end
+
+    def start_forwarded_to_support?(chat_id)
+      !start_forwarded_users[chat_id].nil?
+    end
+
+    def duplicate_update?(update_id)
+      return false if update_id.nil?
+
+      !processed_updates[update_id].nil?
+    end
+
+    def mark_update_as_processed(update_id)
+      return if update_id.nil?
+
+      processed_updates[update_id] = true
+    end
+
+    def warn_start_forwarding_failure(chat_id:, message_id:, error:)
+      warn "Failed to forward initial /start for chat_id=#{chat_id} message_id=#{message_id}: #{error.class}: #{error.message}"
+    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.14
 platform: ruby
 authors:
 - Max Buslaev