# Методы геймификации ## Методы геймификации в \*\*stagram\* и ВКонтакте {% hint style="danger" %} \*Соц. сеть Instagram принадлежит Meta, деятельность которой признана в РФ экстремисткой и запрещена. {% endhint %} {% hint style="warning" %} Для настройки работы функций рекомендуем опираться на шаблон геймификации в чатах \*\*stagram\* {% endhint %} Для работы нижеперечисленных функций требуется объявить общие переменные в Настройках проекта:
Наименование переменнойНазначение переменнойЗначение, пример
comment_scoreсколько начислять баллов за комментарии10
comment_max_actions максимальное количество комментарий в день5
min_comment_lenминимальная длина комментария25
stories_scoreсколько начислять баллов за реакции на сториз15
stories_max_actionsмаксимальное количество действий в день1
stories_mention_scoreсколько начислять баллов за упоминания в сторис5
stories_mention_max_actionsмаксимальное количество действий в день2
post_mention_scoreсколько начислять баллов за упоминания в посте10
post_mention_max_actionsмаксимальное количество действий в день3
end_game_dateдата завершения игры30.12.2021
**game\_add\_comment**(text=None) - добавляет очки за комментарий в инстаграм или вк, также можно передать любой текст **game\_add\_stories**() - добавляет очки за реакции на сториз **game\_add\_message**() - добавляет очки за сообщения в директ **game\_add\_stories\_mention**() - добавляет очки за упоминание в истории **game\_get\_user\_score**() - возвращает очки пользователя **game\_get\_user\_place**() - показывает место пользователя в рейтинге **game\_get\_leader\_score**() - возвращает очки лидера в рейтинге **game\_get\_top(count=99999999, shift=0, humanize=False, delimiter=None, platform=None)** - вызов без аргументов вернет отсортированный рейтинг с массивом пользователей. На вход принимает следующие 4 параметра: count - сколько пользователей вернуть, shift - с какого места рейтинга сделать выборку (0 - список начнется с лидера и так по нисходящей по очкам, т.е. 3 - выборка будет с 4-го места в рейтинге и ниже), humanize - 0 - вернет массив со словарями пользователей, 1 вернет список для вывода пользователю, delimiter - это разделитель между именем пользователя и его результатом (если предыдущий параметр humanize=1), platform - 1 - вместо имени выводит логин в инстаграм в формате @nik. Пример 1: game\_get\_top(10, 0, 1, ' - ') вернет: Вася - 40 Маша - 30 Петя - 10\ \ Пример 2: game\_get\_top(3, 0, 1, ' - ', 1) вернет: @vasya - 40 @masha - 30 @privet - 10 **game\_add\_score**(count=1, client\_id=None) - добавляет пользователю очков **game\_set\_score**(score, client\_id=None) - задает пользователю количество очков **game\_ban\_player**() - блокирует пользователя **game\_unban\_player**() - разблокирует пользователя **game\_user\_banned**() - возвращает статус блокировки пользователя, заблокирован - True, не заблокирован -False \# позволяет работать с произвольными значениями в турнирной таблице. **game\_add\_value**(val\_name, count=1, client\_id=None) - **game\_set\_value**(val\_name, value, client\_id=None) {% hint style="info" %} если не передавать client\_id, то функция работает с текущим клиентом {% endhint %} **game\_minus\_user\_score**(count =10) - отнимает очки у пользователя (count - сколько очков отнять) **game\_get\_today\_user\_comment\_action**() - количество комментариев от пользователя за сегодня **game\_get\_today\_user\_message\_actions**() - количество сообщений от пользователя за сегодня **game\_get\_today\_user\_stories\_actions**() - количество сториз от пользователя за сегодня **game\_get\_today\_user\_mention\_actions**() - количество активностей от пользователя за сегодня **game\_get\_today\_user\_post\_mention\_actions**() - количество постов с упоминаниями от пользователя за сегодня **game\_get\_total\_comment\_action**() - количество комментариев за все время игры **game\_get\_total\_message\_actions**() - количество сообщений за все время игры **game\_get\_total\_stories\_actions**() - количество сториз за все время игры **game\_get\_total\_stories\_mention\_actions()** - количество упоминаний в истории за все время игры **game\_get\_total\_post\_mention\_actions()** - количество упоминаний в постах за все время игры ## Получение рейтинга в Telegram {% hint style="warning" %} Для настройки работы функции рекомендуем опираться на [шаблон геймификации в чатах Телеграм](https://docs.salebot.pro/shablony/geimifikaciya-v-chatakh-telegram-igra-na-aktivnost-karmabot) {% endhint %} В общих переменных следует завести словарь **tg\_thanks\_score\_data**, в котором будут храниться сведения по клиентам в формате: `{"total_thanks":20,"326659632":{"name":"Constantin","user_name":"сonstantin","score":5},"403051597":{"name":"Timm","user_name":"dbeing","score":15,"banned":false}}` **tg\_get\_top(count=99999999, shift=0, humanize=False, delimiter=None)** Параметры: **count** - сколько пользователей вернуть\ **shift** - с какого места рейтинга сделать выборку (0 - список начинается с лидера и так по нисходящей по очкам, т.е. 3 - выборка будет с 4-го места в рейтинге и ниже)\ **humanize** - 0 - вернет массив со словарями пользователей, 1 вернет список для вывода пользователю\ **delimiter** - это разделитель между именем пользователя и его результатом (если предыдущий параметр humanize=1) **tg\_get\_user\_info()** {'score': user\_score, 'place': place, 'name': name} --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.salebot.pro/chatbots/peremennye-i-funkcii/kalkulyator/metody-geimifikacii.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.