Chatbot para uma conta pessoal do Telegram
Importante saber
Restrições com base no cenário de uso podem ser aplicadas ao usar uma conta. Os dados exatos não estão disponíveis, mas valores aproximados de limites podem ser encontrados em fontes abertas.
LIMITAÇÕES E RECOMENDAÇÕES
Você pode adicionar qualquer quantidade de contatos durante a primeira sincronização em uma nova conta do Telegram (recém-registrada).
Contas existentes têm um limite de 200 contatos.
Para uma conta nova na qual contatos já foram adicionados antes, o limite é 200.
Se você exceder o limite de 200 contatos, ainda poderá adicionar manualmente até 15 contatos por dia.
Para evitar outras restrições, adicione contatos gradualmente ao longo do dia. Adicionar muitos de uma vez (por exemplo, 15 em 5 a 10 minutos) acionará limites diários mais rígidos: 5 contatos no dia seguinte e, eventualmente, apenas 1 contato por dia se o limite menor também for excedido.
Se você adicionar 15 contatos ao longo do dia, nenhum limite será definido no dia seguinte.
O limite diário é de 40 mensagens para chats diferentes, após o que sua conta será temporariamente restringida.
MAIS SOBRE AS RESTRIÇÕES
Contatos
Para enviar uma mensagem para um número de telefone, primeiro você deve 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 registrados anteriormente no Telegram, a importação inicial de contatos é limitada a 200 contatos. Esse limite também se aplica a novos números se uma reinsincronização for realizada.
c) Uma vez atingido o limite de 200 entradas, 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 de forma uniforme (por exemplo, 15 ao longo do dia) preserva o limite total para o dia seguinte.
A restrição não é redefinida com o tempo.
Segundo o Telegram:
«Para proteger nossos usuários de spam e abuso, implementamos mecanismos de segurança que limitam o número de contatos que podem ser importados de uma vez. Se você exceder esses limites, sua conta será impedida de importar mais contatos. Nesses casos, você poderá adicionar manualmente até cinco novos números por dia. Quaisquer contatos adicionais adicionados além desse limite não serão reconhecidos como usuários do Telegram — mesmo que já estejam na plataforma.»
Dica: Distribua a adição de contatos ao longo de um dia inteiro para evitar restrições.
Limites para adição por nome de usuário
Se um usuário tiver um nome de usuário, você não precisa salvá-lo nos seus contatos — pode enviar uma mensagem diretamente para ele. No entanto, a busca por esses usuários é limitada a aproximadamente 200 solicitações por dia.
Spam não é permitido
O Telegram emitirá um bloqueio temporário ou permanente da conta por envio excessivo de mensagens ou por enviar mensagens para muitos chats de uma só vez.
Enquanto as restrições temporárias duram minutos, horas ou dias, um banimento permanente revoga o acesso à conta indefinidamente. Essa penalidade normalmente é reservada para violações graves, incluindo spam em massa, fraude, compartilhamento de conteúdo proibido ou denúncias repetidas de usuários.
Você pode enviar até 40 mensagens para chats diferentes por dia, após o que um bloqueio temporário será ativado.
Violações repetidas do limite de mensagens resultam em bloqueios progressivamente mais longos, variando de minutos e horas a dias ou semanas, podendo evoluir para um banimento permanente da conta.
Se você enviar mensagens idênticas em sequência sem pausas, um bloqueio pode ser imposto após apenas algumas tentativas.
Conteúdo identificado como spam pode resultar em um banimento imediato e permanente.
Se suas mensagens receberem reclamações (denúncias) de outros usuários, um bloqueio também será inevitável.
Para começar
Para conectar sua conta, primeiro obtenha seu api_id e api_hash. Vá para https://my.telegram.org e faça login na sua conta.

Depois de fazer login, prossiga para as "Ferramentas de desenvolvimento da API" seção.

Em seguida, preencha os campos:

O "Título do app" o campo deve ser preenchido sem espaços ou quaisquer símbolos, usando apenas letras (sem sublinhados, vírgulas etc.).
O "Nome curto" o campo deve ser preenchido sem espaços ou quaisquer símbolos, usando apenas letras e números (sem sublinhados, vírgulas, pontos, travessões, hífens etc.).
O "URL" o campo é um link válido para o seu site.
Escolha "WEB" no campo "Plataforma".
A descrição deve estar em Latim.
Depois clique em Criar aplicativo.
O [object Object] erro em my.telegram.org significa que há dados inválidos. Certifique-se de que todos os campos estejam corretos e que seu 'título do app' e 'nome curto' não estejam já em uso.
Se você tiver preenchido tudo corretamente, verá os seguintes dados:

Conexão da conta
Selecione "Conta do Telegram" na seção "Mensageiros" e, em seguida, insira seu número de telefone e as credenciais obtidas (api_id e api_hash).

Clique "Obter código":

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

Se a autenticação em duas etapas (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, esse recurso está desativado.
Arquivo de chats
Chats arquivados são excluídos do processamento.
Iniciando um chat usando um número de telefone
Para iniciar uma conversa com um novo cliente, vá para a "Clientes" seção e clique em "Escrever no Telegram".

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

Se o novo cliente tiver configurado suas preferências de privacidade do Telegram para permitir a descoberta por número de telefone, um novo registro de cliente será gerado.
Importação de cliente de arquivo
Você pode importar clientes de um arquivo. Para isso, clique em Carregar uma lista de clientes no campo Mensageiros seção do bot desejado.

Quando a importação terminar, perfis de clientes serão gerados para aqueles que puderem ser adicionados aos contatos com base no número de telefone.
ATENÇÃO!
Considere as restrições para a criação de contatos da conta do Telegram. Saiba mais em Importante saber seção.
Métodos da calculadora
create_telegram_client(phone, name, group) - adiciona o número especificado aos contatos da 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 de destino para vinculação do bot.
A calculadora também suporta métodos comuns/gerais.
Atualizado