Métodos de gamificação

Métodos de gamificação no Instagram e no Facebook

Para configurar operações de função, recomendamos usar a gamificação modelo para chats do Instagram como referência.

Para usar as funções listadas abaixo, você precisa declarar variáveis comuns no Configurações do projeto:

comment_score	quantos pontos conceder para comentários	10
comment_max_actions	número máximo de comentários por dia	5
min_comment_len	comprimento mínimo do comentário	25
stories_score	quantos pontos conceder por reações em stories	15
stories_max_actions	número máximo de ações por dia	1
stories_mention_score	quantos pontos conceder por menções em stories	5
stories_mention_max_actions	número máximo de ações por dia	2
post_mention_score	quantos pontos conceder por menções em postagens	10
post_mention_max_actions	número máximo de ações por dia	3
end_game_date	data de término do jogo	30.12.2021

game_add_comment(text=None) - adiciona pontos por um comentário no Instagram ou no FB; você também pode passar qualquer texto.

game_add_stories() - adiciona pontos por reações em stories

game_add_message() - adiciona pontos para mensagens diretas

game_add_stories_mention() - adiciona pontos por menções em stories

game_get_user_score() - retorna os pontos do usuário

game_get_user_place() - exibe a posição do usuário no ranking

game_get_leader_score() - retorna os pontos do líder no ranking

game_get_top(count=99999999, shift=0, humanize=False, delimiter=None, platform=None) - chamar a função sem argumentos retorna um ranking ordenado como um array de usuários. Ela aceita os seguintes 5 parâmetros: count - quantos usuários retornar; shift - a posição inicial do ranking para a seleção (0 significa que a lista começa do líder e segue para baixo por pontos; por exemplo, 3 significa que a seleção começa da 4ª colocação para baixo); humanize 0 - retorna um array de dicionários de usuários, 1 retorna uma lista formatada para exibição ao usuário; delimiter - o separador entre o nome de usuário e sua pontuação (usado se humanize=1); plataforma 1 - exibe o login do Instagram (por exemplo, @nik) em vez do nome de usuário.

Exemplo 1: game_get_top(10, 0, 1, ' - ') retornará: John - 40 Anna - 30 George - 10 Exemplo 2: game_get_top(3, 0, 1, ' - ', 1) retornará: @john - 40 @anna - 30 @privet - 10

game_add_score(count=1, client_id=None) - adiciona pontos ao usuário

game_set_score(score, client_id=None) - define os pontos totais do usuário

game_ban_player() - bloqueia o usuário

game_unban_player() - desbloqueia o usuário

game_user_banned() - retorna o status de banimento do usuário; True se estiver banido, False caso contrário

# permite trabalhar com valores arbitrários no ranking.

game_add_value(val_name, count=1, client_id=None) -

game_set_value(val_name, value, client_id=None)

Se client_id não for fornecido, a função trabalha com o cliente atual.

game_minus_user_score(count =10) - subtrai pontos do usuário (count - quantos pontos subtrair)

game_get_today_user_comment_action() - número de comentários feitos pelo usuário hoje

game_get_today_user_message_actions() - número de mensagens enviadas pelo usuário hoje

game_get_today_user_stories_actions() - número de stories publicados pelo usuário hoje

game_get_today_user_mention_actions() - número de atividades do usuário (menções) hoje

game_get_today_user_post_mention_actions() - número de publicações com menções feitas pelo usuário hoje

game_get_total_comment_action() - número total de comentários durante todo o jogo

game_get_total_message_actions() - número total de mensagens durante todo o jogo

game_get_total_stories_actions() - número total de stories durante todo o jogo

game_get_total_stories_mention_actions() - número total de menções em stories durante todo o jogo

game_get_total_post_mention_actions() - número total de menções em postagens durante todo o jogo

Obtendo ranking no Telegram

Para configurar operações de função, recomendamos usar a gamificação modelo para chats do Telegram como referência.

Nas variáveis globais, você deve criar um dicionário chamado tg_thanks_score_data para armazenar as informações do cliente no seguinte formato:

{"total_thanks":20,"326659632":{"name":"John","user_name":"john","score":5},"403051597":{"name":"Timm","user_name":"dbeing","score":15,"banned":false}}

tg_get_top(count=99999999, shift=0, humanize=False, delimiter=None)

Parâmetros:

count - quantos usuários retornar shift - a posição inicial do ranking para a seleção (0 significa que a lista começa do líder e segue para baixo por pontos; por exemplo, 3 significa que a seleção começa da 4ª colocação para baixo) humanize - 0 retorna um array de dicionários de usuários, 1 retorna uma lista formatada para exibição ao usuário delimiter - o separador entre o nome de usuário e sua pontuação (usado se humanize=1)

tg_get_user_info()

{'score': pontuação_do_usuário, 'place': posição, 'name': nome}