Ultima revisão: 20 de junho de 2019

Detective Pikachu é um bot para o Telegram com o objetivo de criar listas de participantes para raids do Pokemon GO.

Este bot não é afiliado com a Niantic ou com The Pokémon Company, é um recurso independente para ajudar na organização de raids em comunidades de jogadores.

Podes pedir por ajuda no grupo @detectivepikachuhelp e ser informado do desenvolvimento no canal @detectivepikachunews.

  1. Ajuda para treinadores
    1. Encontrar comunidade
    2. Registo no bot
    3. Criar anúncios e raids
    4. Editar, cancelar, apagar e puxar uma raid
    5. Inscrever numa raid
    6. Alertas de raids
    7. Estatísticas
    8. Mais ajuda
  2. Ajuda para administradores
    1. Grupos e canais
    2. Adicionar bot em um grupo ou canal
    3. Configurações
    4. Localizações dos ginásios
      1. Palavras chave
      2. Etiquetas
      3. Zonas
      4. Limites no número de zonas e localizações de ginásios
    5. Modo ama
    6. Fuso horário
    7. Idioma
    8. Rankings
    9. Outros comandos exclusivos para administradores
    10. Administração via web
    11. Templates
  3. Política de burla
  4. Política de privacidade
  5. Problemas frequentes
  6. Lista de comandos
  7. Créditos

Ajuda para treinadores

Encontrar comunidade

Este bot, tem a finalidade de ser usado em grupos, super-grupos ou canais. Normalmente, em cada cidade (ou bairros de grandes cidades) têm uma ou mais comunidades.

Para encontrares uma comunidade, na tua área, podes usar o mapa de comunidades do The Silph Road ou o grupo de listagem de grupos Pokemon GO. Aviso, algumas comunidades usam outros bot para organizar raids.

Se não consegues encontrar, na tua área, uma comunidade, podes criar uma nova. Terás de ler a Ajuda para administradores onde poderás encontrar as instruções para adicionar e configurar o bot.

Registo no bot

O registo permite que seja mostrado o teu nome, equipa e nível de treinador na lista de participantes de uma raid e participar nas classificações. É necessário estar registado para conseguir usar os botões coloridos +1. Alguns grupos poderão requerer o registo para participar em raids ou mesmo como condição para entrar no grupo (ao critério dos administradores do grupo).

Em conversa privada com @detectivepikachubot, escreve o comando /register para começar o processo de registo. Este processo é automático e irá pedir-te uma captura de ecrã do jogo com condições.

Nome de utilizador no Telegram

Para poderes usar as funções básicas do bot (criar anúncios de raids, participar em raids …) é necessário estabelecer um nome de utilizador no Telegram. Esse processo poderá ser feito pelas definições do Telegram.

Subida de nível

Se te encontras registado no bot, para indicar a subida de nível, basta enviares uma captura de ecrã do teu perfil de treinador com o novo nível.

Mudança de nome do treinador

Em caso de mudança de nome do treinador, é necessário refazer o registo no bot. Não existe nenhuma restrição, mesmo que, anteriormente, tenhas validado com uma conta diferente.

Mudança de conta Telegram

Se mudaste de número de telemóvel é possível manter a mesma conta Telegram, bastando mudar o número de telemóvel associado (site em inglês). Se mantiveres a mesma conta, não é necessário fazer mais nada.

Não puderás fazer isso, se já faz algum tempo que não usas o Telegram (as contas, tipicamente, serão eliminadas após seis meses) ou perdeste o número de telemóvel. Em seu lugar, terás de te registar novamente.

O nome de utilizador que usavas anteriormente ainda pode ser registado no bot, mas ao ser detetado uma nova conta, deverá ser libertado. No caso que não seja possível, receberá uma erro ao utilizar o comando /profile. Caso tudo seja bem sucedido, aparecerá o teu nome de utilizador associado à tua nova conta.

Se tentares registar com um nome de treinador que já se encontra associado a outra conta do Telegram, o bot indicará os passos a seguir antes de poderes continuar com o registo. Este processo é manual e poderá levar algum tempo.

Criar anúncios e raids

Os anúncios são raids no qual ainda não foi definido nenhuma hora para a sua realização. Criar previamente um anúncio é a forma recomendada para criar uma raid.

Desde que o grupo tenha configurado as localizações dos ginásios, pode-se enviar capturas de ecrã do jogo com o boss da raid ou com o ovo para criar automaticamente o anúncio. Também se pode criar os anúncios mediante o uso do comando /announce, ou mediante o comando /raid e depois carregando no botão Criar anúncio.

Os anúncios e as raids também se podem criar especificando os parâmetros no comando, quando o grupo tenha configurado as localizações dos ginásios, sempre com esta ordem:

/raid pokemon hora ginasio

Também se pode adicionar a hora de que desaparecerá o Pokémon, colocando-la no fim:

/raid pokemon hora ginasio horafim

Alguns exemplos:

/raid Raikou 14:30 Alameda
/raid Entei 3:30 Plaza de la verdura
/raid Metapod 12 Plaza Mayor 12:15
/announce Metapod 12 Plaza Mayor

No lugar de especificar um Pokémon, podesse especificar um ovo, por exemplo, para um ovo de nível 4 colocasse N4:

/raid N4 13:00 Alameda

Para criar uma EX raid deve-se utilizar a palavra EX e especificar o dia da raid com o seguinte formato:

/raid EX dia/hora ginasio

Por exemplo, para EX raid no dia 12 às 15:30 no ginásio de Crucero:

/raid EX 12/15:30 Crucero

Tem em conta que, caso o bot esteja configurado em um canal so podem criar anúncios e raids os administradores com a capacidade de enviar mensagens e imagens. Neste caso, so podes converter anúncios em raids e inscrever-te nas raids existentes, mas não podes criar novas. Fala com um dos administradores da tua comunidade, para mais detalhes.

Editar, cancelar, apagar e puxar uma raid

É possível editar e adicionar os detalhes da raid, após esta ser criada: modificar hora, ginásio, Pokémon (ou ovo) e a hora que abre ou desaparece o ovo.

Para editar ou adicionar qualquer um dos detalhes, basta responder à mensagem da raid com um dos seguintes comandos:

/time 12:00
/pokemon Wartortle
/gym Plaza de Abastos
/endtime 12:30
/endtime -
/opentime 11:50
/opentime -

No caso de se utilizar um hífen “-“ como parâmetro nos comandos /endtime ou /opentime, apagarão-se a hora que desaparece e a hora que abre o ovo, respetivamente.

Uma raid também pode ser cancelada respondendo com o comando /cancel, apagada com o comando /delete e puxada com o comando /refloat.

Por omissão, o criador da raid e os administradores são os únicos que podem fazer isto, a não ser que grupo tenha ativado a opção de edição permissiva. Os comandos /delete e /refloat, por defeito, só estão ativos para os administradores dos grupos, mas também podem ser ativados para os criadores das raids.

As raids terminam automaticamente passado meia hora desde a hora de inicio, mas também é possivel forçar a terminação com o comando /close a qualquer momento uma vez passada a hora de ínicio.

Os participantes recebe um aviso em privado quando se edita, cancela ou apaga uma raid.

Ao editar uma hora com /time é necessário especificiar o dia caso contrário será considerado a data atual. Já com os comandos /endtime e /opentime, não é necessário pois, por omissão, é considerado a data da raid.

Inscrever numa raid

Uma vez criada a raid, podes-te inscrever carregando no botão Vou. Se te increveste poucos minutos antes, ou mesmo depois, da hora marcada, poderá aparecer um ícone de um caracol 🐌 na lista, dependendo de como está configurado no grupo.

Se vais com acompanhastes, podes carregar no botão +1 por cada acompanhate adicional. Se te enganaste com o número de acompanhantes, carrega no botão Vou para repôr e recomeçar de novo. Tem em conta que os administradores dos grupos podem limitar o número de acompanhantes permitidos ou desativar esta opção completamente.

Quando chegar ao local da raid, indica-o carregando no botão Estou.

Se te increveste mas não podes ir, carrega em Não vou. Se, passado mais de cinco minutos desde que te increveste, permanecerás na lista com uma ❌ para que as pessoas saibam que cancelaste a inscrição. Nos grupos com a opção de Não Vou explícito, podes marcar diretamente Não Vou se quiseres aparecer como tal na lista.

Chegada à hora da raid e até seis horas depois da mesma, podes informar se apanhaste o Pokémon da raid carregando no botão Apanhei, Fugiu ou … . Estes botões estão desativados por pré-definição e os administradores dos grupos podem decidir não ativá-los.

Para que a participação seja contabilizada para as classificações há que increver-se antes da hora marcada e carregar em Estou de forma a confirmar que participaste na raid (pode ser feito depois da hora marcada). A configuração do caracol 🐌 não tem nenhum efeito. Além de mais, deves estar validado no momento em que se gera as classificações.

Alertas de raids

Os utilizadores podem configurar alertas, por mensagem privada, quando se cria raids ou anúncios em determinados ginásios ou de determinados Pokémon. Para configurá-las, utiliza o comando /alerts em privado com o bot e segue as instruções

Há um limite de 30 alertas de ginásios e 12 de Pokémon, por cada grupo. Com o comando /clearalerts podes eliminar todos os alertas de uma só vez.

Tem em conta que, antes de configurar os alertas, terás de ter tido participado em alguma raid em um grupo com as localizações dos ginásios configurados e com a opção de permitir alertas ativada, caso contrário o grupo e os ginásios não aparecerão.

Estatísticas

Os utilizadores podem solicitar as suas estatíticas pessoais de participação com o comando /stats. As estatísticas têm regras semelhastes ás das classificações para que as raids sejam contabilizadas.

Mais ajuda

Se necessitas de esclarecimentos ou ajuda que não se encontra neste manual, podes perguntar em @detectivepikachuayuda. Se és administrador de um grupo ou canal, vê mais abaixo para ajuda para administradores.

Ajuda para administradores

Grupos e canais

O bot pode ser adicionado a grupos e a canais, mas funciona de maneira diferente em ambos os casos, em parte, devido ao funcionamento do próprio Telegram.

Em grupos, o bot, assim que entra no grupo está pronto a usar e envia uma saudação. Porém, convém configurar-lo. Porém tem cuidado, se o bot já tiver sido adicionado ao grupo e o mesmo se converte para super-grupo, terás de o remover e voltar a adicioná-lo e voltar a configurar-lo. Um super-grupo é a melhor opção na maioria dos casos.

Em canais o bot ao entrar não envia uma saudação e necessita de ser configurado, usando /settings, antes de ser utilizado. Também funciona um pouco mais lento e tem mais algumas diferenças. Em un canal, não será mostrado o criado da raid porque a mesma é criada pelo canal, não pelo utilizador. Também, algumas das funções não aceites em canais. Usar um canal é uma opção simpltes, se quiseres integrar com outros bots, já que um bot não pode ler as mensagens de outros bots, em grupos.

Adicionar bot em um grupo ou canal

Para adicionares um bot a um grupo tens três alternativas:

  1. Vai ao perfil do @detectivepikachubot. No menú, seleciona a opção Adicionar ao grupo e escolhe o grupo na lista.

  2. Clica aqui, em um dispositivo onde tenhas o Telegram instalado.

  3. Podes tentar adicioná-lo como um contacto procurando pelo nome de utilizador @detectivepikachubot, mas existe alguns problemas usando este método, em versões mais recentes do Telegram.

Para adicionares o bot em um canal as opções são mais limitadas. Tens que ir à gestão de administadores e adicionar-lo diretamente como administrador, procurando pelo nome de utilizador @detectivepikachubot.

Para versões mais recentes do Telegram não se pode adicionar bots desta forma. Se é o teu caso, descarrega a versão para Android no canal beta do Telegram, procurando pelo arquivo tgrambeta.apk mais recente. O Telegram Beta será instalado à parte e, uma vez adicionado o bot, podes o desinstalar.

Configurações

Para fazer a configuração básica do bot utiliza o comando /settings. A configuração está dividia em vários sub-menus:

Funcionamento do grupo/canal

  1. Localizações. Ativa ou desativa a integração das localizações. Para poderes utilizar esta opção, deves configurar as localizações. Se não tencionas fazer-lo, é melhor deixares desativado. Opção ativada por defeito.

  2. Permitir configurar alertas. Requer a opção Localizações (é ativada automanticamente, se necessário). Permite ou não, que os utilizadores encontrem os ginásios configurados no grupo/canal, quando configuram os alertas pelo privado. Opção ativada por defeito.

  3. Modo ama. Elimina todas as mensagens, excepto as mensagens de criação de raids e os comandos permitidos. Vê a secção do modo ama para mais informações. Opção desativada por defeito.

  4. Validação obrigatória. Se ativada, obriga a todos os utilizadores a validarem-se no bot antes de poderem participar ou criar raids. Opção desativada por defeito.

  5. Puxar automático. Se activada, esta opção faz com que o bot puxe todas as raids activas a cada 5, 10, 15 ou 30 minutos. Considera-se raids ativas aquelas que falta menos de hora e meia para começar ou acabaram de começar (uma vez começadas, puxam-se uma única vez). Opção desativada por defeito.

  6. Ao puxar incluir os anúncios. Se ativada, esta opção faz com que o bot puxe os anúncios em massa ou automaticamente. Opção desativada por defeito.

Comandos disponiveis para membros

  1. Consultar ginásios (comando /search). Se ativada, permite que os utilizadores consultem a localização dos ginásios. Opção desativada por defeito.

  2. Criar raids e anúncios. Se ativada, permite que os utilizaodres criem raids e anúncios, segundo as opções da secção Criar anúncios e raids. Opção ativada por defeito

  3. Puxar raids (comando /refloat). Se ativada, permite aos criadores das raids puxá-las com o comando /refloat. Opção desativada por defeito.

  4. Apagar raids (comando /delete). Se ativada, permite aos criadores das raids apagá-las com o comando /delete. Se desativada, continua a ser possível cancelar-las usando o comando /cancel. Opção ativada por defeito.

Criação de raids e anúncios####

  1. Modo interativo de criar raids e anúncios. Se ativadas, permite criar raids e anúncios usando os menus interativos, baseadsoe em botões. Opção ativada por defeito.

  2. Anúncios mediante prints de ovo. Se ativada, permite que o bot analise as imagens em busca de ovos de raids e crie anúncios de forma automática. Opção ativada por defeito.

  3. Anúncios mediante prints de raid bosses. Se ativada, permite que o bot analise as imagens em busca de raid bosses e crie anúncios de forma automática. Opção ativada por defeito.

  4. Anúncios através de imagens de Ex-passes. Se ativada, permite que o bot analise as imagens em busca de convites de EX rais e crie anúncios de forma automática. Opção ativada por defeito.

Opções de vista de raids

  1. Mostrar totais separados. Se ativado, em vez de mostrar um único total de participantes, serão mostrados totais por equipas. Opção desativada por defeito.

  2. Mostrar «+1» separados por alínea. Requer a opção Tecla «+1» por cada equipa do sub-menu Funcionamento de raids (é ativada automaticamente, se necessário). Se ativada, mostra +1 com a cor correspondente em cada linha. Opção desativada por defeito.

  3. Mostrar horas em formato AM/PM. Se ativada, mostra as horas com o formato de 12 horas seguido de AM ou PM. Só afeta na visualização das raids. Opção desativada por defeito.

  4. Tema de ícones. Permite mudar os tema dos icones entre os disponiveis. Cada vez que é carregado, muda o tema para outro tema disponível.

  5. Agrupar inscritos por nível/equipa. Em vez de mostrar os participantes por ordem temporal, serão agrupados por equipa e nível. Opção desativada por defeito.

  6. Ordernar zonas/ginásios por atividade. Ao criar raids de forma interativa, mostra as zonas e os ginásios por ordem decrescente de atividade, em vez de ordenar unicamente por ordem alfabetica. Opção ativada por defeito.

  7. Marcar inscritos tarde. Marca na lista de treinadores que se inscreveram tarde com um 🐌. Pode-se configurar para 1, 3, 5 ou 10 minutos antes da hora fixada na raid. Opção ativada por defeito com 1 minuto.

Funcionamento de raids

  1. Tecla «Demoro». Se ativado, aparecerá um novo botão nas raids para que os treinadores possam avisar se vao chegar tarde. Opção desativada por defeito.

  2. Teclas «Apanhei-o!/Fugiu!». Se ativado, aparecerá os botões que permitem mostrar se capturaste ou não o Pokémon na raid. Os botões só apareem a partir da hora de inicio da raid e durante as seis horas seguintes. Opção desativada por defeito.

  3. Tecls «Shiny». Se ativada, aparecerá, junto aos botões «Apanhei-o!/Fugiu!», um botão para indicar que o Pokémon capturado é shiny. Semelhante aos botões «Apanhei-o!/Fugiu!», só aparecem a partir da hora de inicio da raid e durante as seis horas seguintes. Opção desativada por defeito.

  4. Tecla «+1». Se ativada, aparecerá um botão que permite indicar que vais com acompanhantes à radi. Pode-se configurar um máximo de 1, 2, 3, 5 e 10 acompanhantes. Opção activiada por defeito e configurada para um máximo de 5 acompanhantes.

  5. Tecla «+1» por cada equipa. Requer a opção Tecla «+1» (é ativada automaticamente, se necessária). Se ativada, mostra três botões «+1», um por cada euipa, em vez de um único botão. Esta opção só tem sentido se a opção de vista de raids Mostrar totais separados ou Mostar «+1» separados por alínea, encontra-se ativada. Opção desativada por defeito.

  6. Edição permissiva. Se ativada, permite que qualquer treinador edite a hora, a hora de finalização, o Pokémon ou o ginásio de uma raid ou anúncio. Esta opção só é recomendada para grupos reduzidos e não para utilizar de forma geral. Opção desativada por defeito.

  7. Puxar permissivo. Se ativada, permite qualquer treinador puxar qualquer raid ou anúncio. Esta opção só é recomendada para grupos reduzidos e não para utilizar de forma geral. Opção desativada por defeito.

  8. «Não vou» explícito. Se ativado, colocará na lista com uma ❌ aqueles que carreguem diretamenta no botão «Não vou». Esta opção é útil para comunidades pequenas, em que é bom saber quando um jogaodr não pode ir a uma raid. Opção desativada por defeito.

  9. Cancelar automaticamente raids vazias. Se ativada, o bot cancelará automaticamente raids que se consideram que ficaram vazias. Uma raid considera-se vazia quando só tem um ou menos treinadores inscritos e nenhum treinador carregou no botão Estou. O cancelamento ocorre após o fim da raid, normalmente 30 minutos depois da hora acordada, ou após passar a hora do fim da raid, se especificada. Opção desativada por defeito.

  10. Apenas membros do grupo. Ao estar ativada, não permite que os utilizador do Telegram que não são membros do grupo ou canal participarem em raids ou receberem alertas. Opção ativada por defeito.

  11. Permitir apenas raids nível ≥ n. Ao ativar esta opção, permite criar unicamento raids a partir de determinado nível do boss da raid, configurável desde 2 até 5, e sempre incluindo as EX. Ao desativar, permite criar raids de qualquer nível. Opção desativada por defeito.

  12. Permitir apenas anúncios nível ≥ n. Ao ativar esta opção, permite criar únicamento anúncios a partir de determinado nível do boss da raid, configurável desde 2 até 5, e sempre incluindo as EX. Ao desativar, permite criar anúncios de qualquer nível. Opção desativada por defeito.

Funcionamento de rankings

  1. Ranking semanal de raids. Se ativo, permite aos administradores de um grupo, mostrar o TOP 5, 10, 15 ou 20 semanal da participação dos treinadore (dependendo da opção selecionada, por defeito 10) utilizando o comando /ranking week (ou simplesmente /ranking).

  2. Ranking mensal de raids. Se ativo, permite aos administraodres de um grupo, mostrar o TOP 15, 25, 25 ou 50 mensal da participação dos treinadores (dependendo da opção selecionada, por defeito 15) utilzando o comando /ranking month.

  3. Contar apenas as raids nível ≥ n. Ao ativar essa opção, limita a raids que se tem em conta para o ranking de raids segundo o nível boos da raid, configurável de 2 a 5 e sempre incluindo as EX. Ao desativar, conta com todas as raids independentemente do nível. Opção desativada por defeito.

  4. Rankings de raid automáticos. Se ativado, publicará os rankings de raids, daqueles que não estão desativados, de forma automática, assim que disponiveis (duas horas antes do fim do período do ranking).

  5. Ranking semanal de anúncios. Se ativado, permite aos administradores de um grupo mostrar o TOP 5, 10, 15, 20 ou 25 semanal da criação de anúncios (dependendo da opção selecionada, por defeito 15) utilizando o comando /ranking announces week (ou simplesmente /ranking announces).

  6. Ranking mensal de anúncios. Se ativado, permite aos administradores de um grupo mostrar o TOP 15, 25, 35 ou 50 mensal da criação de anúncios (dependendo da opção selecionada, por defeito 15) utilizando o comando /ranking announces month.

  7. Contar apenas anúncios nível ≥ n. Ao ativar esta opção, limita os anúncios a ter em conta para o ranking de anúncios consoante o nível do boss da raid, configurável desde 2 até 5, e sempre incluindo as EX. Ao desativar, contas todas os anúncios independentemente do nível. Opção desativa por defeito.

  8. Rankings de anúncios automáticos. Se a opção estiver ativada, publicará os rankings de anúncios, daqueles que não estão desativos, de forma automática, assim que disponiveis (duas horas antes do fim do período do ranking).

Localizações dos ginásios

As localizações dos ginásios tem que ser configuradas em cada grupo de forma independente. Um grupo não conhece as localizações dos demais grupos.

Para começar, deverás criar uma folha de cálculo no Google com 4 colunas (e algumas opcionais que serão mencionadas mais à frente):

  1. Nome do ginásio
  2. Latitude en formato numérico (por exemplo 42.211345)
  3. Longitude também em formato numérico (por exemplo -8.21513)
  4. Palavras chave separadas por virgulas _(por favor lê a secção das palavras chave)
  5. Etiquetas (opcional)
  6. Zonas (opcional)

Por omissão, a Google tenta formatar os números e acaba por estragá-los. Se estás a escrever os dados manualmente, deverás selecionar as colunas B e C, e eliminar o formato como se mostra na seguinte animação, antes de começares a escrever as coordenadas.

O que acontece quando usamos folhas de cálculo como tabelas

É essencial entender como a quarta coluna funciona, pois é aquela que permite encontrar os ginásios. Vê a secção sobre palavras chave com calma.

A quinta coluna é opcional e podes sempre preencher mais tarde. Vê a secção etiquetas para uma explicação mais detalhada.

A sexta coluna também é opcional. Vê a secção sobre zonas para uma explicação mais detalhada.

Uma vez que tenhas a folha de cálculo, prime o botão Partilhar para obter o link partilhável da folha de cálculo e defini-o com o comando /spreadsheet no grupo. Por exemplo:

/spreadsheet https://docs.google.com/spreadsheets/d/1s2K8_hayc1aHt8bZeKucRz0s4G4rn9YUrDB2ZvvEJ4A/edit?usp=sharing

Uma vez definido, deves utilizar o comando /refresh para carrega-la. Cada vez que faças alguma alteração, deves voltar a utilizar /refresh para recarregar a lista. Não é necessário voltar a utilizar /spreadsheet a não ser que queiras mudar a folha de cálculo por outra.

Podes testar as localizações perguntando pelas mesmas com o comando /search. Por exemplo:

/search león de boca abierta

Para listar todos os ginásios conhecidos podes usar o comando /list. Se houver mais de 500 ginásios, o comando pode mostrar um exerto da lista.

Importante! Se editares, na primeira coluna, algum nome do ginásio, na próxima vez que fizeres /refresh, este se apagará e voltará a ser criado com um novo identificador. Todos os alertas, que foram criados pelos utilizadores, serão perdidos. Também pode afetar raids em curso que estão a utilizar esse ginásio, que perdeu a localização.

Palavras chave

As palavras chave escrevem-se na quarta coluna, separas por virgulas (os espaços entre palavras e as virgulas serão ignoradas).

Pensa, as palavras chave são como excertos da frase chave que pode, inclusivamente, ter espaços pelo meio. O bot procura por semelhanças entre o que escreve o utilizar e estes excertos de frase chave e interrompe a procura à primeira semelhança, assim há que escrevê-las com cuidado evitando pôr palavras muito curtas ou demasiado genéricas, que podem provocar colisões.

As palavras chave que contêm menos de três letras serão ignoradas de propósito. Também, tem em conta, que tildes e maísculas serão ignoradas e caracteres como «ç» e «ñ» serão substituidos para «c» e «n», respetivamente. Ou seja, para efeitos de pesquisa a palavra chave Peñíscola é o equivalente a peniscola.

Possível problema: O ginásio reconhecido é o errado e os nomes parecem curtos

Isto pode ocorrer se introduziste palavras chave demasiado curtas ou demasiado genéricas.

Por exemplo, os ginásios Plaza de Abastos e Niños jugando en la plaza podem confundir-se se utilizares como palavra chave plaza. Deves seguir as recomendações gerais de não usar palavras soltas demasiados genéricas.

Neste caso, as palavras chave adequadas poderiam ser:

Gimnasio Palabras clave
Plaza de Abastos plaza abastos, plaza de abastos
Niños jugando en la plaza niños jugando, jugando en la plaza, jugando en plaza, jugando plaza, niños plaza

Possível problema: O ginásio reconhecido é o errado e o nome está contido noutro

Isto pode ocorrer quando um ou mais ginásio têm nomes contidos um no outro. Por exemplo, em Igreja, Igreja De S. Pedro e Igreja de Santa Cruz.

Neste caso, o ginásio Igreja não pode ser distinguido para além da palavra igreja e aplicar as recomendações da secção anterior não é o suficiente. Deves proceder da seguinte forma:

  1. Eliminar o ginásio com o nome curto na folha de cálculo (neste caso Igreja).
  2. Usar o comando /refresh no bot.
  3. Adicionar, novamente, no final da folha de cálculo, o ginásio.
  4. Usar, uma segunda vez, o comando /refresh.

Desta forma, o ginásio com o nome curto será carregado com um novo identificador no final do documento. Tem cuidado, já que fazer isto pode afetar raids em curso que poderão a estar a usar este ginásio nesse momento e serão perdidos os alertas que os utilizadores terão configurados com este ginásio.

Possível problema: Há dois ginásio com o mesmo nome e o bot não os distingue.

Neste caso, não existe uma solução simples, mas podes optar por uma ou várias das seguintes opções:

Etiquetas

As etiquetas servem para marcar os ginásios com determinados emojis, que servem para indentificar melhor como potenciais acolhedores de EX raids.

As etiquetas poem-se na quinta coluna como as palavras chaves, separadas por vírgulas. As suportadas são as seguintes:

Outras etiquetas, como park ou campo, para motivos de compatibilidade também produzem os seus respetivos emojis, mas poderão ser removidas no futuro. Se quiseres adiconar emojis customizados, também podes adicionar como palavras-chave. Por exemplo:

sponsored,ex,📱
🌳,🛴

Zonas

As zonas são só usadas com o modo de criação interativo de raids, com o objetivo de encontrar facilmente os ginásios. Podem ser associados, por exemplo, a bairros, a divisões de uma cidade (Zona Norte, Zona Sul…).

As zonas estabelecem-se na sexta coluna. Podem configurar-se varias para o mesmo ginásio separadas por vírgulas. Por exemplo:

Zona Industrial, Zona Norte

Tem em conta que, se adicionares estes dados a algum ginásio, os ginásio que não têm este dado não aparecerão como opção ao criar uma raid de forma interativa, mas poderão ser selecionas por palavras chave.

Limites no número de zonas e localizações de ginásios

O número máximo de ginásios que são carregados da folha de cálculo são 3000. A partir desse número, são ignorados.

Na criação de raids com o comando /raid será mostrado no máximo 56 ginásios, ordenados do maior para menor uso nos últimos 60 dias. Se queres que mostre mais ginásios, recomenda-se criar zonas. Será mostrado no máximo 14 zonas, assim se o número de zonas for maior, as zonas como menos uso não serão exibidas.

Combina o número máximo de zonas com o número máximo de ginásios por zonas, podem ser mostrados um total de 56*14=784 ginásios.

Isto não quer dizer que seja obrigatório criar zonas se queres que mostre mais de 56 ginásios. O que acontece é que, apenas é possível selecionar os 56 mais utilizados usando o comando /raid sem argumentos, mas poderá selecionar os menos utilizados usando as palavras chave.

Modo ama

O modo ama evita que as pessoas falem no grupo, apagando todas as mensagens que sejam colocadas pelos utilizadores (excepto administradores). Deve ser ativada pela configuração.

É necessário que o bot tenha permissões de administrador no Telegram para apagar mensagens, caso contrário não poderá apagar as mensagens dos outros utilizadores.

O comando /talkgroup permite definir um grupo para falar. Se o modo ama estiver ativado, o bot irá recordar o endereço do grupo para falar cada vez que alguém fale. Por exemplo:

/talkgroup @PGSDC
/talkgroup https://t.me/joinchat/XXs3XkzYsXXxnvbtxxe11x

Para eliminar o grupo para falar, basta passar um hífen como argumento, nomeadamente:

/talkgroup -

Fuso horário

O bot reconhece a hora quando os utilizadores escrevem e faz operações com elas, pelo que é importante que a hora que utiliza o bot corresponda com a hora real do grupo.

Para estabelecer o fuso horário correto devesse utilizar o comando /timezone com o fuso horário correspondente como parametro seguindo o formato da lista de fusos horários segundo a IANA. Por exemplo:

/timezone Europe/Lisbon
/timezone Atlantic/Azores

Para consultar o fuso horáio e a hora atual, devesse utilizar o comando /timezone sem parametros.

/timezone

A região é escolhida automaticamente, tenho por base o fuso horário. Se a região não for a correta, podes mudar usando o comando /region (sem parametros) e escolher entre uma das opções disponiveis.

Idioma

Para ver os idiomas disponiveis, utiliza o comando /language.

Ao entrar num grupo pela primeira vez ou ao falar com um utilizador pela primeira vez em privado, o bot perguntará o idioma desejado. É possível alterar escolha posteriormente com o comando /language idioma. Por exemplo:

/language Portuguese

Se um utilizador interagir pela primeira vez com o bot a partir de um grupo, será selecionado automaticamente o idioma do grupo e não lhe será questionado em privado. Neste caso, o utilizador tambék pode alterar o idioma em privado com este comando.

Rankings

Há dois rankings que se podem configurar: de participação em raids e de criação de anúncios.

O bot pode exibir os rankings da semana passada (contando de segunda a domingo) e do mês passado, com os comandos /ranking raids week ou /ranking announces week e /ranking raids month ou /ranking announces month.

No ranking de participação em raids aparecem ordenados por participação o número de utilizadores, configurado no grupo ou canal. Por omissão, um TOP 10 semanal e um TOP 15 mensal. Em caso de embate em número de raids, será mostrado a mesma posição. Só se tem em conta os utilizadores que se inscrevem na raid antes da hora de inicio e carregaram no botão Estou.

Para que a participação seja contabilizada para os rankings, os treinadores têm que se inscrever antes da hora de inicio acordado e carregar em Estou a qualquer momento, de forma a confirmar que foram à raid. A configuração do caracol 🐌 não tem efeito nenhum. Além de mais, devem estar validados no momento em que é gerado o ranking.

No ranking de criação de anuncios aparecem ordenados por quantidade de anúncio criados os utilizadores, configurado no grupo ou canal. Por omissão, um TOP 10 semanal e um TOP 15 mensal. Em caso de empate em número de anúncios criados, será mostrado a mesma posição. Só se tem em conta anúncios convertidos logo em raids que não sejam cancelados ou eliminados.

Os rankins estão disponiveis a partir das 10 da noite do dia anterior do fim do correspondente período. Quer dizer, o ranking mensal estará disponivel às 10 da noite do último dia do mês.

Podem-se limitar que raids se tem em conta para cada um dos tipos de ranking segundo o nível do boss, segundo a configuração do grupo ou canal.

Outros comandos exclusivos para administradores

Para reverter o cancelamento de uma raid podes usar o comando /uncancel. Utilizasse exatamente igual que o comando /cancel, mas sobre raids canceladas.

Um administrador pode sempre cancelar raids com o comando /cancel, mesmo que sejam antigas. Normalmente, o criador da raid só pode cancelar raids que não sejam mais antigas do que três horas.

Para eliminar treinadores da raid de forma seletica, podesse usar /unlist seguido do nome do treinador. Este comando utilizasse como todos os outros da família de edição: ou respondendo à raid, ou por privado especificando o identificador da raid e o nome do treinador, por esta ordem.

Para puxar todas as raids ativas de uma vez (aquelas que ocorrem numa margem de uma hora e meia), podesse utilizar o comando /refloatactive. Também é possível puxar rodas as raids incluindo as EX que ocorrem daqui varias horas ou dias, com /refloatall, as raids que ocorrem hoje, com /refloattoday, ou as EX raids que ocorrem daqui varias horas ou dias, com /refloatex.

Podesse eliminar utilizadores do grupo com o comando /kickachu seguindo de um ou mais identificadores numéricos do Telegram. Este comando pode ser gerado a partir da lista de utilizadores inativos ou sem validação a partir da adminstração via web.

Administração via web

Em admin.detectivepik.ac está disponível uma ferramenta web que permite obter alguma informação interessante para os administradores:

A ferramenta necessita de se conectar utilizando a tua própria conta do Telegram, já que bot não pode obter por si mesmo a lista de utilizadores de um grupo ou canal.

A informação dos grupos disponiveis, a lista de utilizadores de cada grupo e o resultado de cada operação ficarão em armazenados durante 21 horas no servidor para evitar sobrecarregar a API do Telegram e o servidor e asim poder realizá-las. Em cada página, será exibido a data da última vez em que os dados foram obtidos.

Ao terminar, por segurança, é recomendado voltar á página principal e terminar sessão no Telegram cliquando no botão Logout. Mesmo que não o faças, após 30 dias as sessão são automaticamente encerradas no servidor e será apagada a informação da sessão da ferramenta.

Templates

Podem personalizadas as mensagens que aparecem nas raids e nos anúncios, modificando os templates usando os comandos /raidtemplate e /announcetemplate respetivamente.

Sem passar argumentos, informa o template atual. Para modificar o template, devesse passar como argumento, o template completo, por exemplo:

/raidtemplate <b>{Pokemon}</b> Raid {{ no dia<b>{weekday_day_month}</b> }}às {timewarn_icon_}<b>{raidtime}</b> no {gym_icon}{gym}<br>{{<em>Disponivel entre as {opentime} e {endtime}</em><br>}}<em>Organizado por </em>{organizer}{_edited_icon}{_refloated_icon}

Para voltar ao template padrão, pode passar um hifén -, da seguinte forma:

/raidtemplate -

Os textos como {gym} são variáveis que serão substituidos por informação. Podes ve a lista completa das variáveis dísponiveis com o comando /raidtemplate help.

A mensagem pode er formatada com HTML, com as restrições habituais do Telegram:

As quebras de linha devem ser indicadas com <br>. Uma quebra de linha normal na mensagem será representada como um espaço em branco.

Variáveis com HTML

As variávies que estão assinaldas com um asterisxco * na ajuda normalmente são hiperligações, e como tal contêm HTML. Quer dizer que, {pokemon_gamepress} sera normalmente traduzido assim:

<a href="https://pokemongo.gamepress.gg/raid-boss-counter/palkia-raid-counter-guide">Palkia</a>

Ao conter HTML, estas variáveis não podem colocadas dentro de outras etiquetas HTML, como <b> para colocar em negrito, por exemplo. Quer dizer, que esse excerto do template gerará um erro devido ao encapsulamento das etiquetas HTML, apesar de parecer que não há nenhum erro com o encapsulamento:

<b>{pokemon_gamepress}</b>

Nestes casos, podesse aceder ao texto com o nome da variavel acabando em _text e à hiperligação com o nome da variável acabando em _link. Quer dizer, neste caso:

Variantes das mesmas variáveis

Para ajudar a contruir melhores mensagens, há versões das variáveis com espaços no ínicio, espaços no fim, em maisculas… Estas são as variáveis disponiveis:

Expressões condicionais

Há três tipos de expressões condicionais, que são expressões entre chavetas duplas {{ }} que podem mostrar ou não a mensagem dependo das condições determinadas.

A expressão condicional mais simples, escrevesse simplesmente assim: {{texto}}. Só mostrará se todas as variáveis que são usadas estão defenidas. Tens o exemplo desta expressão condicional no template predefinido, onde só se mostra uma porção de texto se a variável weekday_day_month estiver definida e outro se estão definidas opentime e endtime.

Outro tipo de expressão condicional permite mostrar texto só se uma variável estiver definida, sem que se exiba a variável. A sintaxe [variavel]{{texto}} permitir mostrar todo o texto se exisitira a variavel. Por exemplo, para mostrar um texto só em que caso de uma raid seja EX podesse utilizar esta expressão condicional:

[expokemon_icon]{{Esta é uma raid EX!}}

Por último, podesse fazer justamente o contrário com a terceira expressão condicional: mostrar um texto se a variavel não estiver definida. A sintaxe para isto é [!variable]{{texto}}. Por exemplo, para mostrar um texto só em caso de uma raid não tiver a localização do ginásio corretamente definida:

[!gym_link]{{¡El gimnasio no se ha reconocido, avisa a un admin!}}

Rodapé das raids

As rais podem ter um texto de rodapé, que pode ser definido com /raidfootertemplate da mesma maneira que se define os outros templates. Neste caso, por defeito não há nenhum texto de rodapé, então que /raidfootertemplate - elimina o texto de rodapé.

Política de burla

É proibido, explicitamento, o uso de qualquer tipo de aplicação modificada do Pokémon GO ou aplicaçõs que podem ser utilizadas para fazer alguma burla, especialmente falsificar a localização. Aplicações que unicamente interagem com o jogo através de técnias de captura de ecrã, como a maioria de calculadores de IVs, são permitidos. Esta decisão vem ao consenso com a políticas de banimento da Niantic, que podem mudar no futuro.

Este bot, tão pouco, pode ser utilizado em grupos ou canais que permitem abertamento ou promovem o uso de fraudes no jogo, especialmente a falsificação da localização.

Métodos de banir

O bot implementa medidas anti-burla qie detetam determinados comportamento e o uso de determinadas aplicações, o que pode levar ao banimento automático do utilizar ou grupos.

Os banimento também podem ser aplicados manualmente se existirem provas suficientes, mas não se aceita qualquer tipo de evidencia. Não se avalia coisas como: comportamento em ginásios, distâncias percorridas suspeitas, acesso a lugares inacessiveis e outras evidências de dificil estudo. São aceites provas como: conversas contextualizadas onde se reconhece o uso de burlas, ou capturas de ecrã onde seja visivel aplicações não autorizadas. Acusações falsas podem ser, também, motivo de banimento para o acusador.

Apelos

Em caso de banimento, o bot não responderá a nenhum comando nem permitirá participar nas raids. Para comprovar se a tua está banida, podes usar o comando /profile em privado. O estado da tua conta será Banido. Neste caso, poderás encontrar um link para solicitar a revisão do banimento.

Duração do banimento

No caso do uso de aplicações não autorizadas ou falsificação da localização a duração do banimento é permanente, ao que poderá ser levantada após um período de seis meses, em determinados casos, partir da data do banimento, perguntando, a partir do link, a revisão do banimento.

Ações como, tentar burlar o período de banimento de qualquer forma, continuar a fazer burlas ou mostrar mal comportamento nos grupos de assitencia pode resultar em banimento permanente

Política de privacidade

Que informação recolhemos e submetemos para tratamento

Este bot recolhe a seguinte informação sobre os seus utilizadores ao interagir com eles em privado ou através de um grupo ou canal do Telegram:

O bot também armazena ficheiros não ordenados com as interações em grupos e privados (logs), incluindo arquivos e imagens que o bot detete como relevantes para o jogo, com o objetivo de poder rastrear problemas técnicos e atender a apelos de ban.

A ferramenta web dirigida a administradores utiliza cookies armazenados no navegador e variáveis armazenadas no servidor com o intuito de manter aberta a sessão do utilizar do Telegram quando necessário para manter o funcionamento da web. Estas variáveis são destruidos passados 30 dias ou quando o utilizador faz logout.

Como é utilizada a informação

A informação armazenada é utilizada para as seguintes finalidades:

A base legal para o tratamento dos dados mencionados nesta secção é a prestação do serviço que se solicita voluntariamente (artigo 6, parágrafo 1 (b) do RGPD).

Como se explica na Política de fraude, são rastreados os logs da atividade de forma automática em busca de suspeitas. A base legal para este tratamento de dados é o artigo 6, parágrafo 1 (f) do RGPD.

Quem tem acesso à informação

O nome de utilizador público do Telegram e os dados relacionados com a conta de Pokémon GO poderão ser compartilhadas em grupos ou canais em que a atividade é mantida. Este compartilhamento pode ser pública, dependendo da configuração de cada grupo ou canal.

O indentificador numérico e nome de utilizador público do Telegram e o nome do treinador do Pokémon GO poderão ser compartilhados com os administradores dos grupos ou canais em que se realize alguma atividade.

A base legar para partilhar os dados proporcionados é da prestação de serivço que se solicita voluntariamente (artigo 6, parágrafo 1 (b) do RGPD).

Duração do armazenamento

A informção é armazenada durante o tempo necessário para cumprir com os fins para as quais foram recolhidos:

Direito contemplados no RGPD

Devesse enviar uma solicitação ao grupo de Telegram habilitado para o efeito, indicando que deseja exercer alugum dos direitos: acesso, reteficação, eliminação e limitação do tratamento, portabilidade dos dados.

Em caso de exercer o direito de eliminação, o bot guardará o identificador numérico do Telegram junto com uma marca que indica esse desejo. Neste caso, não será possível utilizar o bot e o estado da conta aperecerá como banido.

Problemas frequentes

Erro: Não há informação sobre o grupo

O bot deve enviar uma saudação ao entrar num grupo. Até que o faça, não será criada a informação necessária para que funcione.

Se converteste um grupo em um supergrupo, para efeito no bot é um grupo diferente e deves eliminar-lo e voltar a colocar-lo para que volte a enviar a saudação e criar a informação necessária. Tem em conta que a conversão de um grupo em um supergrupo, perde-se todas as configurações realizadas e as raids antigas deixam de funcionar.

Nota: Eliminar o bot e voltar a colocá-lo em um grupo ou um supergrupo já configurado não faz que se elimine as configurações nem que pare de funcionar as raids.*

Erro: Não há informação sobre o canal

Nos canais, devesse configurar o bot pelo menos uma vez com /settings para que se crie a informação necessária, ja que o este não envia uma saudação para o canal.

O bot não elimina os comandos e as capturas de ecrã enviados pelos utilizadores

Para que o bot consiga eliminar os comandos ou imagens de outros utilizadores do grupo, deve ter a permissão de administrador no Telegram para eliminar mensagens, caso contrário não o fará.

Lista de comandos

Comando Descrição Utilizadores Admins Ámbito Parámetros
/alerts Lista de alertas configurados - Privado
/announce Criar um anúncio 5 Grupo pokemon hora ginasio ou pokemon ginasio horafim (opcional1)
/announcetemplate Mostra ou edita o template dos anúncios Grupo template (opcional)
/cancel Cancela uma raid Privado / Grupo2 id_raid (privado)
/clearalerts Apaga todos os alertas configurados para os ginásios - Privado
/close Fecha permanentemente uma raid Privado / Grupo2 id_raid (privado)
/endtime Muda a hora de fim de uma raid ou de um anúncio Privado / Grupo3 id_raid horafim (privado) o horafim (grupo)
/delete Apaga uma raid ou anúncio 5 Privado / Grupo3 id_raid o id_anuncio (privado)
/gym Muda o ginásio de uma raid ou anúncio Privado / Grupo3 id_raid ginasio (privado) o ginasio (grupo)
/help Mostra a ajuda Privado / Grupo
/kickachu Expulsa os utilizadores indicados Grupo id_utilizador (pode ser vários)
/language Mostra o idioma atual ou altera-o Grupo / Privado idioma (opcional)
/list Lista dos ginásios registados Grupo
/linkedbots Permite modificar as permissões de partilha de dados de registo com outros bots - Privado
/opentime Muda a hora de abertuda de uma raid ou anúncio Privado / Grupo3 id_raid horainicio (privado) o horainicio (grupo)
/pokemon Muda o ovo ou o pokémon de uma raid ou anúncio Privado / Grupo3 id_raid pokemon o id_raid ovo (privado), pokemon o ovo (grupo)
/profile Mostra a informação armazenada do treinador e estado da conta - Privado
/raid Cria uma raid 5 Grupo pokemon hora ginasio o pokemon hora ginasio horafim (opcional1)
/raids Lista de raids pendentes em grupos onde tiveste atividade no último mês - Privado
/raidfootertemplate Mostra ou edita o template para o rodapé das raids Grupo template (opcional)
/raidtemplate Mostra o edita o template para as mensagens de raids Grupo template (opcional)
/ranking Mostra um ranking de participação em raids Grupo week para ranking semanal, month para ranking mensal
/refloat Puxa uma raid ou um anúncio 6 Privado / Grupo3 id_raid (privado)
/refloatactive Puxa as raids e anúncios4 pendentes que decorrem dentro de uma hora e meia Grupo
/refloatall Puxa todas as raids e anúncios4 pendentes Grupo
/refloatex Puxa todas as raids e anúncios EX4 pendentes Grupo
/refloattoday Puxa todas as raids e anúncios4 pendentes que decorrem hoje Grupo
/refresh Carrega ou recarrega a informação dos ginásios Grupo
/region Configura a região do grupo - Grupo
/register Começa o processo de validação - Privado
/search Pesquisa um ginásio 5 Grupo ginasio
/settings Exibi o menú de configurações do grupo Grupo
/spreadsheet Configura um folha de cálculo da Google com os ginásios Grupo url
/stats Mostra as estatisticas, da última semana, do treinador - Privado
/time Muda a hora de uma raid ou o inicio de um anúncio Privado / Grupo3 id_raid hora (privado) o hora (grupo)
/timezone Mostra ou edita o fuso horário do grupo Grupo fuso horario (opcional)
/uncancel Retorna para o estado pendente uma raid cancelada Privado / Grupo2 id_raid (privado)
/unlist Elimina um utilizador da lista de participantes da raid Privado / Grupo2 id_raid @nomeutilizador o id_raid nometreinador (privado), @nomeutilizador ou nometreinador (grupo)
  1. Opcional apenas se as localizações dos ginásios estejam configuradas e ativadas.

  2. Usa-se, respondendo à mensagem de uma raid.

  3. Usa-se, respondendo à mensagem de uma raud ou anúncio.

  4. Os anúncios só serão incluidos se a opção correspondete esta ativada nas configurações.

  5. O comando está ativado por defeito, mas pode ser desativado nas configurações do grupo.

  6. O comando está desativado por defeito, mas pode ser ativado nas configurações do grupo.

Créditos

O bot é desenvolvido e mantido por Gentakojima, com ajuda de muitos voluntários. Desenvolver o bot não é uma tarefa fácil, mas mantê-lo sem todos estes voluntários seria impossivel.

Moderadores

Os moderadores são as pessoas responsáveis pela ajuda com validações, subidas de nível e troca de equipas quando o bot não é capaz de o fazer automaticamente, e muito mais. Eles podem atender dezenas de pessoas por dia, dependendo do dia.

Moderadores atuais: Eleita, BreezyChum, Diammy, SampeSamu e NatalisStark.

Ex-moderadores: Pikaping, Tabernita, Nelulita e outros.

Tradutores

Traduzir software cuja a interface com os utilizadores é a escrita é uma tarefa tediosa e demorada. As traduções necessitam de mantidas e atualizadas ao longo do tempo, também. Os tradutores para as traduções atualmente completas são:

Alemão: StefanZune, Stephi (tradutores principais)

Catalão: bicNaranjita (tradutor principal)

Chinês (tradicional): Shin (tradutor principal)

Francês: Carmenhat (tradutor principal)

Galego: Ely (tradutor principal)

Indonésio: Rio Gunadi (tradutor principal)

Inglês: Marina Dreamerina (tradutor principal); Nick1778 (documentação); Carmenhat, Pilfer, Fauri, Gentakojima (tradutores ocasionais)

Italiano: Soulrack (tradutor principal); nanoteck (documentação)

Português (Europeu): Tina Arroyo (tradutor principal); João Cardoso (documentação)

Russo: Nick (tradutor principal)

Ajudantes

Em ambos os grupos de ajuda em Inglês e Espanhol há outros utilizadores dispostos a ajudar, e eles fazem um bom trabalho. Eles sabem que são.

Patrons

Os patron ajudam com contribuições monetárias a manter os servidores operacionais. Sem essas pessoas, o custo que servidores seria inacessível nos dias de hoje. Aqueles que aceitam o seu reconhecimento, são listados no cabeçalho deste website, mas há, também, outros contribuidores anónimos.