# 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.

{% hint style="warning" %}
LIMITAÇÕES E RECOMENDAÇÕES

1. Você pode adicionar qualquer quantidade 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 conta nova na qual contatos já foram adicionados antes, o limite é 200.
4. Se você exceder o limite de 200 contatos, ainda poderá adicionar manualmente até 15 contatos por dia.
5. 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.
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 que sua conta será temporariamente restringida.
   {% endhint %}

<details>

<summary>MAIS SOBRE AS RESTRIÇÕES</summary>

### 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:

> &#x20;*«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.»*

{% hint style="success" %}
**Dica:** Distribua a adição de contatos ao longo de um dia inteiro para evitar restrições.
{% endhint %}

### 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.

{% hint style="warning" %}
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.
{% endhint %}

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 evoluir para um banimento 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 um banimento imediato e permanente.
5. Se suas mensagens receberem reclamações (denúncias) de outros usuários, um bloqueio também será inevitável.

</details>

## Para começar

Para conectar sua conta, primeiro obtenha seu api\_id e api\_hash. Vá para [https://my.telegram.org](https://my.telegram.org/) e faça login na sua conta.

<div data-with-frame="true"><figure><img src="/files/1fcf708de9a7c63fea63f49a9f8b6899f4624aea" alt=""><figcaption></figcaption></figure></div>

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

<div data-with-frame="true"><figure><img src="/files/b04ad4b2c69f01d4e78943762de513212af7dae1" alt=""><figcaption></figcaption></figure></div>

Em seguida, preencha os campos:

<div data-with-frame="true"><figure><img src="/files/21bb03efde4d12a149a4fa7536cbe7ad5737cb7b" alt=""><figcaption></figcaption></figure></div>

1. 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.).
2. 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.).
3. O **"URL"** o campo é um link válido para o seu site.
4. Escolha **"WEB"** no campo **"Plataforma".**
5. A descrição deve estar em **Latim**.

Depois clique em **Criar aplicativo**.&#x20;

O `[object Object]` erro em [**my.telegram.org**](https://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:

<div data-with-frame="true"><figure><img src="/files/ad1a00d84d0e982a190756af69bdb1b2edbc58ed" alt="" width="563"><figcaption></figcaption></figure></div>

## 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).

<div data-with-frame="true"><figure><img src="/files/39153a70f2827610a8400ca5acbe063e382ee8db" alt=""><figcaption></figcaption></figure></div>

Clique **"Obter código"**:

<div data-with-frame="true"><figure><img src="/files/760cda6781461c80e6ca527385742130889dbfa7" alt=""><figcaption></figcaption></figure></div>

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

<div data-with-frame="true"><figure><img src="/files/a224815d5583748c809f88107a71e7e2c7763809" alt=""><figcaption></figcaption></figure></div>

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".**

<div data-with-frame="true"><figure><img src="/files/f0e7bacd1758f699ce560ef42503e978f6e4868e" alt="" width="563"><figcaption></figcaption></figure></div>

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

<div data-with-frame="true"><figure><img src="/files/d4ac4ab6f5719670a0da6fc6b8153faca321137d" alt=""><figcaption></figcaption></figure></div>

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.

<div data-with-frame="true"><figure><img src="/files/b21f82111b79b67e948144b9897a2ca6e9e17c54" alt=""><figcaption></figcaption></figure></div>

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.

{% hint style="danger" %}
ATENÇÃO!

Considere as restrições para a criação de contatos da conta do Telegram. Saiba mais em [Importante saber ](#important-to-know)seção.&#x20;
{% endhint %}

## 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.

{% hint style="success" %}
A calculadora também suporta métodos comuns/gerais.
{% endhint %}


---

# 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.mavibot.ai/doc/pt/chatbot/mensageiros/telegram/personal.md?ask=<question>
```

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.