raine/telegram-tori-bot

Telegram bot created with the intent of making selling stuff on tori.fi as streamlined as possible.

telegram-tori-bot

Telegram bot created with the intent of making selling stuff on tori.fi as streamlined as possible. Putting stuff for sale with this thing is actually a joy. Takes advantage of Telegram's photo sending and bot features like Custom Reply Keyboards and Inline Keyboards.

demo.mp4

features

• Determines the listing category from subject, instead of having to browse through endless list of nested categories
• Add photos to listing by dragging them to chat at any point
• Edit listing subject and body by editing the original message
• Uploads a sent listing as an archive that can be relisted later by replying /tuojson on the archive file

install

The Go Toolchain is required.

go install github.com/raine/telegram-tori-bot@latest

usage

1. Create a bot on Telegram by talking to @botfather and save the bot token it gives you.

   • https://core.telegram.org/bots#creating-a-new-bot

2. Get the user config template: curl https://github.com/raine/telegram-tori-bot/blob/master/user_config.example.toml > user_config.toml.

3. In user_config.toml, fill token and toriAccountId for your user with the JavaScript snippet in user config. You can figure out what your telegramUserId is by sending any message to the bot, so proceed to run the bot with incomplete configuration, if you don't have your user id at this point.

4. Run telegram-tori-bot with the env variables set:

   BOT_TOKEN=<bot_token_from_step_1> \
   USER_CONFIG_PATH=./user_config.toml \
      telegram-tori-bot

5. Search for your bot in telegram with the username you gave to it.

6. /start a conversation with the bot and tell what you're selling.

env vars

• BOT_TOKEN: Telegram bot's token. You get this from @botfather. required
• USER_CONFIG_PATH: Path to user config. See user_config.toml.example for an example. If your telegram user id is not found in the user config, the bot will disregard your message. required

user config

The program expects a TOML config file that contains telegram user to tori user -pairs. The format is as follow:

[[users]]
telegramUserId = 123
token = 'abc'
toriAccountId = '123123'

[[users]]
telegramUserId = 124
# etc...

No login mechanism with tori.fi (or whatever schibsted it is thesedays) credentials is implemented as of yet.

Here's a JavaScript snippet to get the access token and tori account id for user_config.toml. Run it in browser developer tools on tori.fi with active session. It will work as long as the cookie is readable in JS.

const { access_token, token_type, account_id } = JSON.parse(
  atob(
    Object.fromEntries(
      document.cookie.split('; ').map((v) => v.split(/=(.*)/s))
    )['sessioninfo']
  )
)
console.log(
  `token = '${token_type} ${access_token}'\ntoriAccountId = '${
    account_id.split('/')[3]
  }'`
)

faq

how to create "annetaan" type listings?

Start the message with the listing subject with the word "annetaan". For example: "Annetaan Kylpyhuoneen matto".

how do i start over when making some kind of mistake that cannot be reversed?

Use the command /peru. It will forget everything from the current listing creation. Note that subject and description can be edited by editing the original message.

which of the uploaded photos will be used as primary picture in listing?

The first uploaded picture. When uploading multiple photos in Telegram client, photos can be reorded both on desktop and mobile. Or you can just upload them separately -- that way works also.

bot is failing to guess the correct category based on listing subject, what do?

The bot comes up with a subject for your listing based on the subject you enter. This works by searching tori.fi for existing listings with parts of the entered subject. If none can be found, there is currently no fallback to select the category manually. What you can do, however, is enter a noun as the last word in the subject. The bot will always search the last word of the subject independently if all else fails.

For example,

Good: Lake CX 176 maantiekengät

Searching for "maantiekengät" is almost guaranteed to provide a result that we can get the correct category from.

Bad: Lake CX 176

If no one is currently selling Lake CX 176 road cycling shoes, we can't get a category.

Another strategy is entering something that is guaranteed to be found, and then replacing the whole subject by editing the message.

does it add a phone number to listing?

No. Adding phone number to listing is an invitation for annoying Whatsapp scam messages.

development

The project uses just as a command runner (or make alternative).

See just -l for recipes.