Wasabee Telegram Bots - wasabee-project/Wasabee-IITC GitHub Wiki

Each Wasabee Server has a telegram bot:

  • Americas: @PhDevBot (a legacy name from before Wasabee was known as Wasabee)
  • EU: @WasabeeEU_bot
  • Asia/Pacific: @WasabeeAP_bot

In your favorite telegram client, you can give the bot permission to contact you by sending it the /start command.

Features

The bots have a few features for operators:

  • They allow operators to send targets to agents; these targets are formatted so that you can use your favorite map app (Google Maps, Apple Map, Intel) to get to the location
  • They allow operators to send announcements to teams
  • They allow chats to be set up to manage team membership -- to some degree

The bots have a few features for agents:

  • They allow agents to send their location to the Wasabee server without needing to install the Wasabee-Mobile app.
  • They allow agents to set assignment status (in a chat where the operation is linked to the chat)
    • Reject an assignment
    • Mark a task as "completed"
    • Mark a task as "acknowledged"
    • Mark a task as "incomplete"

Linking a Telegram Chat to a Wasabee Team

Only the team owner can link a team to a chat. A team can be linked to only one chat. A chat can be linked to only one team. Anyone who is added to the chat will be added to the team if the wasabee account is linked to the telegram ID of the added agent. Anyone who leaves the chat will be removed from the team.

  1. In the telegram chat, add the bot for the appropriate server
  2. Send the command to the bot /link teamID (the teamID is available in the WebUI and is formatted like word-word-random; e.g. flowing-smurf-t34r5)
  3. Confirm the linkage with the /status command

Allow wasabee to manage the chat membership -- limited by Telegram's restrictions

  1. Grant the bot administrator access to the chat Wasabee will then be able to remove members from the chat when they are removed from the team. Wasabee cannot add agents to the chat due to Telegram's restrictions.

Linking a team AND operation to a chat

When a team and an operation are linked to a chat, additional functionality is available.

  1. In the telegram chat, add the bot for the appropriate server
  2. Send the command to the bot /link teamID opID (the teamID is available in the WebUI and is formatted like word-word-random; e.g. flowing-smurf-t34r5; the opID is a 40-letter random string, visible in the WebUI)
  3. Confirm the linkage with the /status command

When an operation is linked, several additional commands become available

  • /assignments will show any assigned tasks in the op
  • /complete {ID} will mark that task as complete
  • /incomplete {ID} will mark the task as incomplete
  • /claim {ID} will claim the task (assign it to the claiming agent)
  • /reject {ID} will un-assign the task from the agent rejecting it