Importante saber

Restrições baseadas no cenário de uso podem ser aplicadas ao usar uma conta. Dados exatos não estão disponíveis, mas valores aproximados de limite podem ser encontrados em fontes abertas.

LIMITAÇÕES E RECOMENDAÇÕES

  1. Você pode adicionar qualquer número de contatos durante a primeira sincronização em uma nova conta do Telegram (recém-registrada).
  2. Contas existentes têm um limite de 200 contatos.
  3. Para uma nova conta onde contatos foram adicionados anteriormente, o limite é de 200.
  4. Se você exceder o limite de 200 contatos, ainda pode adicionar até 15 contatos manualmente por dia.
  5. Para evitar restrições adicionais, adicione contatos gradualmente ao longo do dia. Adicionar muitos de uma vez (por exemplo, 15 em 5-10 minutos) acionará limites diários mais rigorosos: 5 contatos no dia seguinte e, eventualmente, apenas 1 contato por dia se o limite inferior também for excedido.
  6. Se você adicionar 15 contatos ao longo do dia, nenhum limite será definido no dia seguinte.
  7. O limite diário é de 40 mensagens para chats diferentes, após o qual sua conta será temporariamente restrita.

Contatos

Para enviar uma mensagem para um número de telefone, você deve primeiro adicioná-lo à sua lista de contatos do Telegram.

Sincronização da lista de contatos:

a) Para uma conta recém-criada com um número nunca usado no Telegram, a primeira sincronização de contatos não tem limites de importação.

b) Para números de telefone previamente registrados no Telegram, a importação inicial de contatos é limitada a 200 contatos. Este limite também se aplica a novos números se uma ressincronização for realizada.

c) Uma vez que o limite de 200 entradas foi atingido, novos contatos devem ser adicionados manualmente.

Criação manual de contatos

Adicionar muitos contatos muito rapidamente (por exemplo, 15 em um minuto) reduzirá seu limite para 5 contatos no dia seguinte.

Adicionar mais 5 contatos rapidamente no mesmo dia reduzirá ainda mais o limite para 1 por dia. No entanto, distribuir as adições uniformemente (por exemplo, 15 ao longo do dia) preserva o limite total para o dia seguinte.

A restrição não é redefinida com o tempo.

De acordo com o Telegram:

«Para proteger nossos usuários contra spam e abuso, implementamos salvaguardas que limitam o número de contatos que podem ser importados de uma só vez. Se você exceder esses limites, sua conta será restrita de importar mais contatos. Nesses casos, você poderá adicionar manualmente até cinco novos números por dia. Quaisquer contatos adicionais adicionados além deste limite não serão reconhecidos como usuários do Telegram — mesmo que já estejam na plataforma.»

Dica: Distribua as adições de contatos ao longo de um dia inteiro para evitar restrições.

Limites de adição de nome de usuário

Se um usuário tiver um nome de usuário, você não precisa salvá-lo nos seus contatos — você pode enviar mensagens diretamente. No entanto, a busca por esses usuários é limitada a aproximadamente 200 solicitações por dia.

Sem spam permitido

O Telegram emitirá uma proibição temporária ou permanente da conta por mensagens excessivas ou envio de mensagens para muitos chats de uma só vez.

Enquanto as restrições temporárias duram minutos, horas ou dias, uma proibição permanente revoga o acesso à conta indefinidamente. Esta penalidade é tipicamente reservada para violações graves, incluindo spam em massa, fraude, compartilhamento de conteúdo proibido ou denúncias repetidas de usuários.

  1. Você pode enviar até 40 mensagens para chats diferentes por dia, após o que um bloqueio temporário será ativado.
  2. Violações repetidas do limite de mensagens resultam em bloqueios progressivamente mais longos, variando de minutos e horas a dias ou semanas, podendo escalar para uma proibição permanente da conta.
  3. Se você enviar mensagens idênticas em sequência sem pausas, um bloqueio pode ser imposto após apenas algumas tentativas.
  4. Conteúdo identificado como spam pode resultar em uma proibição imediata e permanente.
  5. Se suas mensagens receberem reclamações (denúncias) de outros usuários, um bloqueio também é inevitável.

Primeiros passos

Para conectar sua conta, primeiro obtenha seu api_id e api_hash. Acesse https://my.telegram.org e faça login na sua conta.

Após o login, vá para a seção "API development tools".

Em seguida, preencha os campos:

  1. O campo "App title" deve ser preenchido sem espaços ou quaisquer símbolos, usando apenas letras (sem underscores, vírgulas, etc.).
  2. O campo "Short name" deve ser preenchido sem espaços ou quaisquer símbolos, usando apenas letras e números (sem underscores, vírgulas, pontos, travessões, hífens, etc.).
  3. O campo "URL" é um link válido para o seu site.
  4. Escolha "WEB" na "Platform".
  5. A descrição deve estar em Latim.

Em seguida, clique em Create application.

O erro [object Object] no my.telegram.org significa que há dados inválidos. Certifique-se de que todos os campos estão corretos e que seu 'app title' e 'short name' não estão já em uso.

Se você preencheu tudo corretamente, verá os seguintes dados:

Conexão da conta

Selecione "Telegram Account" na seção "Messengers", depois insira seu número de telefone e as credenciais obtidas (api_id e api_hash).

Clique em "Get code":

Um código de verificação será enviado para sua conta do Telegram. Insira-o:

Se a autenticação de dois fatores (2FA) estiver ativada na sua conta, você também precisará inserir sua senha.

Chats em grupo

Para permitir que o bot responda em chats em grupo, defina a variável do cliente answer_on_group_chat = "1". Por padrão, este recurso está desativado.

Arquivo de chat

Chats arquivados são excluídos do processamento.

Iniciar um chat usando um número de telefone

Para iniciar um diálogo com um novo cliente, vá para a seção "Clients" e clique em "Write in Telegram".

Insira o número de telefone e o nome do cliente na janela exibida e confirme clicando em "Add".

Se o novo cliente configurou suas configurações de privacidade do Telegram para permitir a descoberta pelo número de telefone, um novo registro de cliente será gerado.

Importação de clientes de arquivo

Você pode importar clientes de um arquivo. Para fazer isso, clique em Upload a list of clients na seção Messengers do bot desejado.

Assim que a importação for concluída, perfis de cliente serão gerados para aqueles que podem ser adicionados aos contatos com base em seu número de telefone.

OBSERVE!

Considere as restrições para criação de contatos da conta do Telegram. Saiba mais na seção Importante saber.

Métodos da calculadora

create_telegram_client(phone, name, group) - adiciona o número especificado aos contatos na conta do Telegram e cria um cliente correspondente no MaviBot.

phone - telefone do cliente

name - nome do cliente

group - ID do usuário do bot alvo para vinculação do bot.

A calculadora também suporta métodos comuns/gerais.