telegram_ros repository

Repository Summary

Checkout URI https://github.com/tue-robotics/telegram_ros.git
VCS Type git
VCS Version master
Last Updated 2023-09-06
Dev Status MAINTAINED
CI status No Continuous Integration
Released UNRELEASED
Tags No category tags.
Contributing Help Wanted (0)
Good First Issues (0)
Pull Requests to Review (0)

Packages

Name Version
telegram_ros 0.0.0

README

telegram_ros

CI Lint

Bridges between a Telegram conversation and ROS.

Only a single Telegram user can send and receive text, images and locations to/from the ROS bridge. A user must send the /start command to start a conversation. A new user can then /start as well and take over. Once connected, a user can type /stop to disconnect

Currently, there is no authentication (Issue #6)

Installation (from source)

Go to the src directory of your catkin workspace and clone the package from github:

git clone https://github.com/tue-robotics/telegram_ros.git

Install the required dependencies:

rosdep install --from-path -y -i telegram_ros

Compile your workspace

catkin build # or catkin_make (make sure to refresh your workspace env afterwards)

Create a bot

If you don't have a bot yet, chat to BotFather in Telegram to create one. You can provide a name for your bot and you will receive the API token.

Run

rosrun telegram_ros telegram_ros_bridge _token:="YourToken:FromBotFather"

rosparam set /telegram_ros_bridge/whitelist '[1, 2]'  # For the chat IDs that should be allowed

ROS API

Topics

Output

Input

Parameters

  • ~token (string): Telegram BOT API token
  • ~caption_as_frame_id (bool): Whether to put the caption of the image in the frame_id (default: False)
  • ~whitelist (bool or list): False when everyone can use the bot or a list of telegram user IDs that are allowed to talk with the bot (default: False)

CONTRIBUTING

No CONTRIBUTING.md found.