telegram-support-bot 0.1.10 → 0.1.12

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9263ca971ffb1e1bb24ae8bc23342c4596748573e7b694485173e14dd2d82d44
-  data.tar.gz: fce5aa69e55343db503d12779a3b66b4f2caabd407f18b1e6668532d1abf9bbb
+  metadata.gz: f542e3e9a21dc2d7d9c45c9b65b19aec360bad95b60f0e4f999f3a9f4c532700
+  data.tar.gz: 0136afb1b7bea4ce86afcd4f28b3af38f56743f4a2a4a87c29bfd33287f792e4
 SHA512:
-  metadata.gz: 60ab56248d3f245ab2aa8530f8b6c2254003e881c08f632d75e81648cafa0273d35c9cb35cd4d2aece9ec567de0e5effae6ef97205f578cc931695bfa01b1769
-  data.tar.gz: 2e6f1fa2f22a606cc418a2f3f054cc38a7565093d4187c609333583ca22db00c77b9f313f3f45aa0dac6eb5877d1386de91f2ba72730e3bab3caf5fdb9d2294f
+  metadata.gz: 7599da9dab831b489bd6f687bf9d779fc5b3582a1a5546eea8d3c00e4febce46bddccc6aaa118177ad20e296f95fb1ff8f8bc54f013e30e41e462c9e3f8aa576
+  data.tar.gz: 00f33f8a9eed3902cbde9584d06a781880f6efe9a0cbd6f1405ac2450e82da1e0605a3c0eed25520e9c6c46e8291e40495276cd08cc59a0e92c7494023c35a13

data/CHANGELOG.md

@@ -4,6 +4,23 @@ All notable changes to this project will be documented in this file.
 
 ## [Unreleased]
 
+## [0.1.12] - 2026-02-26
+
+### Fixed
+- `my_chat_member` onboarding message with support chat ID is no longer sent for private chats.
+- Support-chat onboarding message is now emitted only when the bot is newly added to a non-private chat.
+
+## [0.1.11] - 2026-02-25
+
+### Added
+- Optional host callback `on_user_command` for user-chat commands other than `/start`.
+  Return `true` to mark a command as handled and skip forwarding to support chat.
+
+### Fixed
+- User-chat `/start` detection now recognizes deep-link command forms and bot mentions:
+  `/start`, `/start <payload>`, `/start@botname`, `/start@botname <payload>`.
+- Start commands in user chats continue to run welcome/contact onboarding and are not forwarded to the support chat.
+
 ## [0.1.10] - 2026-02-25
 
 ### Added

data/README.md

@@ -54,6 +54,9 @@ TelegramSupportBot.configure do |config|
   config.require_contact_for_support = false
   # 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.
+  # Return true to mark the command as handled (it will not be forwarded).
+  config.on_user_command = ->(command:, args:, chat_id:, message:, bot_username: nil) { false }
   # Recommended in Kubernetes/multi-pod setup:
   # config.state_store = :redis
   # config.state_store_options = { url: ENV.fetch('REDIS_URL'), namespace: 'telegram_support_bot' }
@@ -197,6 +200,29 @@ other user messages until contact is shared.
 Support replies are routed by internal message mapping, so users do not need to change Telegram
 forwarding privacy settings to receive replies.
 
+## Host Handling For User Commands
+
+You can handle user-chat commands in your app before they are forwarded to support:
+
+```ruby
+TelegramSupportBot.configure do |config|
+  config.on_user_command = lambda do |command:, args:, chat_id:, message:, bot_username: nil|
+    case command
+    when '/help'
+      TelegramSupportBot.adapter.send_message(chat_id: chat_id, text: 'How can we help?')
+      true
+    else
+      false
+    end
+  end
+end
+```
+
+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.
+
 ## State Storage (Single Pod vs Multi-Pod)
 
 By default, runtime state is stored in-memory (`state_store = :memory`). This is fine for local

data/lib/telegram_support_bot/configuration.rb

@@ -7,6 +7,7 @@ module TelegramSupportBot
                   :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,
+                  :on_user_command,
                   :state_store, :state_store_options, :mapping_ttl_seconds,
                   :reaction_count_ttl_seconds, :user_profile_ttl_seconds
 
@@ -25,6 +26,7 @@ module TelegramSupportBot
       @contact_received_message = 'Thanks! We have saved your phone number.'
       @contact_invalid_message = 'Please use the button below to share your own phone number.'
       @on_contact_received = nil
+      @on_user_command = nil
       @state_store = :memory
       @state_store_options = {}
       @mapping_ttl_seconds = 30 * 24 * 60 * 60

data/lib/telegram_support_bot/version.rb

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

data/lib/telegram_support_bot.rb

@@ -173,12 +173,18 @@ module TelegramSupportBot
         return
       end
 
-      if message['text'] == '/start'
+      command_data = parse_command(message['text'])
+
+      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)
         return
       end
 
+      if command_data && handle_user_command(command_data: command_data, message: message, chat_id: chat_id)
+        return
+      end
+
       if configuration.require_contact_for_support && !contact_known_for_user?(chat_id)
         request_contact_from_user(chat_id: chat_id)
         return
@@ -226,7 +232,9 @@ module TelegramSupportBot
     end
 
     def process_command(message, chat_id:)
-      command = message['text'].split(/[ \@]/).first.downcase # Extract the command, normalize to lowercase
+      command_data = parse_command(message['text'])
+      command = command_data && command_data[:command]
+      return unless command
 
       case command
       when '/start'
@@ -240,6 +248,35 @@ module TelegramSupportBot
       end
     end
 
+    def handle_user_command(command_data:, message:, chat_id:)
+      callback = configuration.on_user_command
+      return false unless callback.respond_to?(:call)
+      return false if command_data[:command] == '/start'
+
+      callback.call(
+        command: command_data[:command],
+        bot_username: command_data[:bot_username],
+        args: command_data[:args],
+        message: message,
+        chat_id: chat_id
+      )
+    rescue StandardError => error
+      warn "Failed to run on_user_command callback: #{error.class}: #{error.message}"
+      false
+    end
+
+    def parse_command(text)
+      return nil unless text.is_a?(String)
+
+      token, args = text.strip.split(/\s+/, 2)
+      return nil unless token&.start_with?('/')
+
+      command, bot_username = token.split('@', 2)
+      return nil if command.nil? || command.empty?
+
+      { command: command.downcase, bot_username: bot_username, args: args&.strip }
+    end
+
     def process_reply_in_support_chat(message)
       reply_to_message = message['reply_to_message']
       reply_to_message_id = reply_to_message['message_id']
@@ -329,11 +366,18 @@ module TelegramSupportBot
     end
 
     def handle_my_chat_member_update(update)
-      # Check if the bot has been added to the chat
-      if update['new_chat_member']
-        chat_id = update['chat']['id']
-        send_welcome_message(chat_id: chat_id)
-      end
+      new_status = update.dig('new_chat_member', 'status')
+      old_status = update.dig('old_chat_member', 'status')
+      return unless %w[member administrator].include?(new_status)
+      return if %w[member administrator].include?(old_status)
+
+      chat = update['chat'] || {}
+      return if chat['type'] == 'private'
+
+      chat_id = chat['id']
+      return if chat_id.nil?
+
+      send_welcome_message(chat_id: chat_id)
     end
 
     def process_message_reaction(message_reaction)

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: telegram-support-bot
 version: !ruby/object:Gem::Version
-  version: 0.1.10
+  version: 0.1.12
 platform: ruby
 authors:
 - Max Buslaev
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-02-25 00:00:00.000000000 Z
+date: 2026-02-26 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: redis
@@ -40,7 +40,6 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- ".idea/workspace.xml"
 - ".rspec"
 - CHANGELOG.md
 - CODE_OF_CONDUCT.md

data/.idea/workspace.xml

@@ -1,170 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<project version="4">
-  <component name="AutoImportSettings">
-    <option name="autoReloadType" value="SELECTIVE" />
-  </component>
-  <component name="ChangeListManager">
-    <list default="true" id="edf498b0-8552-42f1-846d-0c79d29ff991" name="Changes" comment="" />
-    <option name="SHOW_DIALOG" value="false" />
-    <option name="HIGHLIGHT_CONFLICTS" value="true" />
-    <option name="HIGHLIGHT_NON_ACTIVE_CHANGELIST" value="false" />
-    <option name="LAST_RESOLUTION" value="IGNORE" />
-  </component>
-  <component name="EmbeddingIndexingInfo">
-    <option name="cachedIndexableFilesCount" value="26" />
-  </component>
-  <component name="FileTemplateManagerImpl">
-    <option name="RECENT_TEMPLATES">
-      <list>
-        <option value="Minitest Spec" />
-      </list>
-    </option>
-  </component>
-  <component name="Git.Settings">
-    <option name="RECENT_GIT_ROOT_PATH" value="$PROJECT_DIR$" />
-  </component>
-  <component name="MarkdownSettingsMigration">
-    <option name="stateVersion" value="1" />
-  </component>
-  <component name="McpProjectServerCommands">
-    <commands />
-    <urls />
-  </component>
-  <component name="ProjectColorInfo">{
-  &quot;associatedIndex&quot;: 4
-}</component>
-  <component name="ProjectId" id="2ciiVgDyGIIwTjG6xCPIunFNdqZ" />
-  <component name="ProjectLevelVcsManager">
-    <ConfirmationsSetting value="2" id="Add" />
-  </component>
-  <component name="ProjectViewState">
-    <option name="hideEmptyMiddlePackages" value="true" />
-    <option name="showLibraryContents" value="true" />
-  </component>
-  <component name="PropertiesComponent"><![CDATA[{
-  "keyToString": {
-    "DefaultRubyCreateTestTemplate": "Minitest Spec",
-    "ModuleVcsDetector.initialDetectionPerformed": "true",
-    "RSpec.Unnamed.executor": "Run",
-    "Ruby.scratch_61.executor": "Run",
-    "RunOnceActivity.MCP Project settings loaded": "true",
-    "RunOnceActivity.OpenProjectViewOnStart": "true",
-    "RunOnceActivity.ShowReadmeOnStart": "true",
-    "RunOnceActivity.TerminalTabsStorage.copyFrom.TerminalArrangementManager.252": "true",
-    "RunOnceActivity.git.unshallow": "true",
-    "RunOnceActivity.typescript.service.memoryLimit.init": "true",
-    "com.intellij.ml.llm.matterhorn.ej.ui.settings.DefaultModelSelectionForGA.v1": "true",
-    "git-widget-placeholder": "main",
-    "junie.onboarding.icon.badge.shown": "true",
-    "last_opened_file_path": "/Users/max/code/gems/telegram_support_bot",
-    "node.js.detected.package.eslint": "true",
-    "node.js.detected.package.tslint": "true",
-    "node.js.selected.package.eslint": "(autodetect)",
-    "node.js.selected.package.tslint": "(autodetect)",
-    "nodejs_package_manager_path": "npm",
-    "ruby.structure.view.model.defaults.configured": "true",
-    "settings.editor.selected.configurable": "org.jetbrains.plugins.ruby.settings.RubyActiveModuleSdkConfigurable",
-    "to.speed.mode.migration.done": "true",
-    "vue.rearranger.settings.migration": "true"
-  },
-  "keyToStringList": {
-    "com.intellij.ide.scratch.ScratchImplUtil$2/New Scratch File": [
-      "ruby"
-    ]
-  }
-}]]></component>
-  <component name="RecentsManager">
-    <key name="CopyFile.RECENT_KEYS">
-      <recent name="$PROJECT_DIR$/spec/telegram_support_bot/adapters" />
-      <recent name="$PROJECT_DIR$/spec/support" />
-      <recent name="$PROJECT_DIR$/spec" />
-      <recent name="$PROJECT_DIR$/lib/telegram_support_bot" />
-      <recent name="$PROJECT_DIR$/lib/telegram_support_bot/adapters" />
-    </key>
-  </component>
-  <component name="RunManager" selected="Ruby.scratch_61">
-    <configuration name="Unnamed" type="RSpecRunConfigurationType" factoryName="RSpec" nameIsGenerated="true">
-      <module name="telegram_support_bot" />
-      <predefined_log_file enabled="true" id="RUBY_RSPEC" />
-      <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="RUBY_ARGS" VALUE="" />
-      <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="WORK DIR" VALUE="" />
-      <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="SHOULD_USE_SDK" VALUE="false" />
-      <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="ALTERN_SDK_NAME" VALUE="" />
-      <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="myPassParentEnvs" VALUE="true" />
-      <EXTENSION ID="BundlerRunConfigurationExtension" BUNDLE_MODE="AUTO" bundleExecEnabled="true" />
-      <EXTENSION ID="RubyCoverageRunConfigurationExtension" runner="rcov" />
-      <EXTENSION ID="org.jetbrains.plugins.ruby.rails.run.RailsRunConfigurationExtension" SCRATCH_USE_RAILS_RUNNER="false" />
-      <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="TESTS_FOLDER_PATH" VALUE="$MODULE_DIR$/spec" />
-      <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="TEST_SCRIPT_PATH" VALUE="" />
-      <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="TEST_SCRIPT_PATHS" VALUE="" />
-      <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="SPEC_RUNNER_PATH" VALUE="" />
-      <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="TEST_FILE_MASK" VALUE="**/*_spec.rb" />
-      <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="SPEC_EXAMPLE_NAME" VALUE="" />
-      <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="USE_EXAMPLE_MATCHES" VALUE="false" />
-      <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="LINE_NUMBER_EXAMPLE_IDS" VALUE="" />
-      <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="TEST_TEST_TYPE" VALUE="ALL_IN_FOLDER" />
-      <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="SPEC_ARGS" VALUE="" />
-      <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="RUNNER_VERSION" VALUE="" />
-      <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="USE_CUSTOM_SPEC_RUNNER" VALUE="false" />
-      <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="DRB" VALUE="false" />
-      <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="ZEUS" VALUE="false" />
-      <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="SPRING" VALUE="false" />
-      <RSPEC_RUN_CONFIG_SETTINGS_ID NAME="FULL_BACKTRACE" VALUE="false" />
-      <method v="2" />
-    </configuration>
-    <configuration name="scratch_61" type="RubyRunConfigurationType" factoryName="Ruby" temporary="true">
-      <RUBY_RUN_CONFIG NAME="RUBY_ARGS" VALUE="" />
-      <RUBY_RUN_CONFIG NAME="WORK DIR" VALUE="$PROJECT_DIR$" />
-      <RUBY_RUN_CONFIG NAME="SHOULD_USE_SDK" VALUE="false" />
-      <RUBY_RUN_CONFIG NAME="ALTERN_SDK_NAME" VALUE="" />
-      <RUBY_RUN_CONFIG NAME="myPassParentEnvs" VALUE="true" />
-      <EXTENSION ID="BundlerRunConfigurationExtension" BUNDLE_MODE="AUTO" bundleExecEnabled="true" />
-      <EXTENSION ID="RubyCoverageRunConfigurationExtension" runner="rcov" />
-      <EXTENSION ID="org.jetbrains.plugins.ruby.rails.run.RailsRunConfigurationExtension" SCRATCH_USE_RAILS_RUNNER="false" />
-      <RUBY_RUN_CONFIG NAME="SCRIPT_PATH" VALUE="$APPLICATION_CONFIG_DIR$/scratches/scratch_61.rb" />
-      <RUBY_RUN_CONFIG NAME="SCRIPT_ARGS" VALUE="" />
-      <method v="2" />
-    </configuration>
-    <list>
-      <item itemvalue="RSpec.Unnamed" />
-      <item itemvalue="Ruby.scratch_61" />
-    </list>
-    <recent_temporary>
-      <list>
-        <item itemvalue="Ruby.scratch_61" />
-      </list>
-    </recent_temporary>
-  </component>
-  <component name="SharedIndexes">
-    <attachedChunks>
-      <set>
-        <option value="bundled-js-predefined-d6986cc7102b-9b0f141eb926-JavaScript-RM-253.30387.79" />
-      </set>
-    </attachedChunks>
-  </component>
-  <component name="SpellCheckerSettings" RuntimeDictionaries="0" Folders="0" CustomDictionaries="0" DefaultDictionary="application-level" UseSingleDictionary="true" transferred="true" />
-  <component name="SpringUtil" SPRING_PRE_LOADER_OPTION="true" RAKE_SPRING_PRE_LOADER_OPTION="true" RAILS_SPRING_PRE_LOADER_OPTION="true" />
-  <component name="TaskManager">
-    <task active="true" id="Default" summary="Default task">
-      <changelist id="edf498b0-8552-42f1-846d-0c79d29ff991" name="Changes" comment="" />
-      <created>1708600824931</created>
-      <option name="number" value="Default" />
-      <option name="presentableId" value="Default" />
-      <updated>1708600824931</updated>
-      <workItem from="1708600827139" duration="10157000" />
-      <workItem from="1708784534887" duration="682000" />
-      <workItem from="1708944130416" duration="99000" />
-      <workItem from="1708944249622" duration="627000" />
-      <workItem from="1708949675518" duration="80000" />
-      <workItem from="1708951183744" duration="310000" />
-      <workItem from="1770972800781" duration="13916000" />
-    </task>
-    <servers />
-  </component>
-  <component name="TypeScriptGeneratedFilesManager">
-    <option name="version" value="3" />
-  </component>
-  <component name="com.intellij.coverage.CoverageDataManagerImpl">
-    <SUITE FILE_PATH="coverage/telegram_support_bot@Unnamed.rcov" NAME="Unnamed Coverage Results" MODIFIED="1708610177774" SOURCE_PROVIDER="com.intellij.coverage.DefaultCoverageFileProvider" RUNNER="rcov" COVERAGE_BY_TEST_ENABLED="true" COVERAGE_TRACING_ENABLED="false" WORKING_DIRECTORY="" MODULE_NAME="telegram_support_bot" />
-  </component>
-</project>