mailru-im-bot-updated 0.0.25

Pure Python interface for Bot API. Bot cookbook for Humans.

🐍 bot-python

Pure Python interface for Bot API.

Table of contents

• Introduction
• Getting started
• Installing
• API description

Introduction

This library provides complete Bot API 1.0 interface and compatible with Python 2.7, 3.4, 3.5, 3.6, 3.7, 3.8, 3.9, 3.10.

Getting started

• Create your own bot by sending the /newbot command to Metabot and follow the instructions.

  Note: a bot can only reply after the user has added it to his contact list, or if the user was the first to start a dialogue.

• You can configure the domain that hosts your ICQ server. When instantiating the Bot class, add the address of your domain.

  Example: Bot(token=TOKEN, name=NAME, version=VERSION, api_url_base="https://api.icq.net/bot/v1"), by default we use the domain: https://api.icq.net/bot/v1

• If you are Myteam client, you can add flag "is_myteam=True", when instantiating the Bot class. This will let you use additional chat methods.

  Example: Bot(token=TOKEN, name=NAME, is_myteam=True), by default it is False.

An example of how to use the framework can be seen in example/test_bot.py

Installing

Install using pip:

pip install --upgrade mailru-im-bot-updated

Install from sources:

git clone https://github.com/Lunatik-cyber/bot-python-icq.git
cd icq_bot-python-icq
python setup.py install

New features

• Added file_name argument to send_file function. Now you can send files with custom names.
• Now you can receive sent data in send_text, send_file, send_voice, edit_text functions, answer_callback_query.

Example file_name argument

bot.send_file(chat_id=chat_id, file_name="test.txt", file=open("test.txt", "rb"))

Example sent data

msg = bot.send_text(chat_id=chat_id, text="test")
bot.edit_text(chat_id=chat_id, message_id=msg["msgId"], text="test2")

API description

• icq.com/botapi/
• agent.mail.ru/botapi/