Add the CallbackQuery.open_private_chat method

Author: pietroalbini

botogram/context.py

@@ -39,6 +39,10 @@ def __enter__(self):
     def __exit__(self, *_):
         _local._botogram_context.pop()
 
+    def bot_username(self):
+        """Get the username of the bot"""
+        return self.bot.itself.username
+
     def component_name(self):
         """Get the name of the current component"""
         return self.hook.component.component_name

botogram/objects/callbacks.py

@@ -19,6 +19,7 @@
 #   DEALINGS IN THE SOFTWARE.
 
 from .base import BaseObject
+from ..context import ctx
 from .messages import User, Message
 from .mixins import _require_api
 
@@ -73,6 +74,25 @@ def open_url(self, url, cache=0):
             "cache_time": cache,
         })
 
+    @_require_api
+    def open_private_chat(self, start_arg, cache=0):
+        """Open the bot private chat with the user"""
+        self._answered = True
+
+        # Telegram doesn't support opening private chats with empty parameters,
+        # so here we present the developer a friendlier message
+        if not start_arg:
+            raise ValueError("You must provide a non-empty start argument")
+
+        # Construct the correct link
+        url = "https://t.me/" + ctx().bot_username() + "?start=" + start_arg
+
+        self._api.call("answerCallbackQuery", {
+            "callback_query_id": self.id,
+            "url": url,
+            "cache_time": cache,
+        })
+
     @_require_api
     def _maybe_send_noop(self):
         """Internal function to hide the spinner if needed"""