# Chatbot pour un compte Telegram personnel

## Important à savoir

Des restrictions basées sur le scénario d'utilisation peuvent être appliquées lors de l'utilisation d'un compte. Les données exactes ne sont pas disponibles, mais des valeurs limites approximatives peuvent être trouvées dans des sources ouvertes.

{% hint style="warning" %}
LIMITATIONS ET RECOMMANDATIONS

1. Vous pouvez ajouter n'importe quel nombre de contacts lors de la première synchronisation sur un nouveau compte Telegram (tout juste créé).
2. Les comptes existants ont une limite de 200 contacts.
3. Pour un nouveau compte auquel des contacts ont déjà été ajoutés, la limite est de 200.
4. Si vous dépassez la limite de 200 contacts, vous pouvez toujours ajouter manuellement jusqu'à 15 contacts par jour.
5. Pour éviter d'autres restrictions, ajoutez les contacts progressivement tout au long de la journée. En ajouter trop d'un coup (par exemple, 15 en 5 à 10 minutes) déclenchera des limites journalières plus strictes : 5 contacts le lendemain, puis éventuellement seulement 1 contact par jour si la limite inférieure est également dépassée.
6. Si vous ajoutez 15 contacts tout au long de la journée, aucune limite ne sera définie le lendemain.
7. La limite quotidienne est de 40 messages vers différents chats, après quoi votre compte sera temporairement restreint.
   {% endhint %}

<details>

<summary>PLUS D'INFORMATIONS SUR LES RESTRICTIONS</summary>

### Contacts

Pour envoyer un message à un numéro de téléphone, vous devez d'abord l'ajouter à votre liste de contacts Telegram.

**Synchronisation de la liste de contacts :**

a) Pour un compte nouvellement créé avec un numéro jamais utilisé sur Telegram, la première synchronisation des contacts n'a pas de limite d'importation.

b) Pour les numéros de téléphone déjà enregistrés avec Telegram, l'importation initiale des contacts est limitée à 200 contacts. Cette limite s'applique également aux nouveaux numéros si une resynchronisation est effectuée.

c) Une fois la limite de 200 entrées atteinte, les nouveaux contacts doivent être ajoutés *manuellement*.

#### Création manuelle de contacts

Ajouter trop de contacts trop rapidement (par exemple, 15 en une minute) réduira votre limite à 5 contacts le lendemain.

Ajouter 5 contacts supplémentaires rapidement le même jour réduira encore la limite à 1 par jour. En revanche, répartir les ajouts de manière uniforme (par exemple, 15 tout au long de la journée) préserve la limite complète pour le lendemain.

La restriction ne se réinitialise pas avec le temps.

Selon Telegram :

> &#x20;*« Pour protéger nos utilisateurs contre le spam et les abus, nous avons mis en place des mesures de protection qui limitent le nombre de contacts pouvant être importés en une seule fois. Si vous dépassez ces limites, votre compte sera restreint et ne pourra plus importer de contacts. Dans ce cas, vous pourrez ajouter manuellement jusqu'à cinq nouveaux numéros par jour. Tout contact supplémentaire ajouté au-delà de cette limite ne sera pas reconnu comme utilisateur Telegram — même s'il est déjà sur la plateforme. »*

{% hint style="success" %}
**Conseil :** Répartissez les ajouts de contacts sur une journée entière afin d'éviter les restrictions.
{% endhint %}

### Limites d'ajout par nom d'utilisateur

Si un utilisateur a un nom d'utilisateur, vous n'avez pas besoin de l'enregistrer dans vos contacts — vous pouvez lui envoyer un message directement. Cependant, la recherche de ces utilisateurs est limitée à environ 200 requêtes par jour.

### Aucun spam autorisé

Telegram prononcera une suspension temporaire ou permanente du compte en cas d'envoi excessif de messages ou d'envoi de messages à trop de chats à la fois.

{% hint style="warning" %}
Alors que les restrictions temporaires durent quelques minutes, heures ou jours, une suspension permanente révoque l'accès au compte indéfiniment. Cette sanction est généralement réservée aux violations graves, notamment le spam de masse, la fraude, le partage de contenu interdit ou les signalements répétés d'utilisateurs.
{% endhint %}

1. Vous pouvez envoyer jusqu'à 40 messages vers différents chats par jour, après quoi un blocage temporaire sera activé.
2. Les violations répétées de la limite d'envoi de messages entraînent des blocages de plus en plus longs, allant de quelques minutes et heures à des jours ou des semaines, pouvant aller jusqu'à une suspension permanente du compte.
3. Si vous envoyez des messages identiques à la suite sans pause, un blocage peut être imposé après seulement quelques tentatives.
4. Le contenu identifié comme spam peut entraîner une suspension immédiate et permanente.
5. Si vos messages reçoivent des plaintes (signalements) d'autres utilisateurs, un blocage est également inévitable.

</details>

## Pour commencer

Pour connecter votre compte, obtenez d'abord votre api\_id et votre api\_hash. Rendez-vous sur [https://my.telegram.org](https://my.telegram.org/) et connectez-vous à votre compte.

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

Après la connexion, accédez à la section **"API development tools"** section.

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

Puis remplissez les champs :

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

1. Le **"App title"** le champ doit être rempli sans espaces ni symboles, en utilisant uniquement des lettres (pas de tirets bas, virgules, etc.).
2. Le **"Short name"** le champ doit être rempli sans espaces ni symboles, en utilisant uniquement des lettres et des chiffres (pas de tirets bas, virgules, points, tirets, traits d'union, etc.).
3. Le **"URL"** le champ correspond à un lien valide vers votre site web.
4. Choisissez **"WEB"** dans le **"Plateforme".**
5. La description doit être en **Latin**.

Puis cliquez sur **Créer l'application**.&#x20;

Le `[object Object]` l'erreur sur [**my.telegram.org**](https://my.telegram.org/) signifie qu'il y a des données invalides. Assurez-vous que tous les champs sont corrects et que votre **'app title'** et **'short name'** ne sont pas déjà pris.

Si vous avez tout rempli correctement, vous verrez les données suivantes :

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

## Connexion du compte

Sélectionnez "Telegram Account" dans la section "Messengers", puis saisissez votre numéro de téléphone et les identifiants obtenus (api\_id et api\_hash).

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

Cliquez **"Get code"**:

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

Un code de vérification sera envoyé à votre compte Telegram. Saisissez-le :

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

Si l'authentification à deux facteurs (2FA) est activée sur votre compte, vous devrez également saisir votre mot de passe.

## Chats de groupe

Pour permettre au bot de répondre dans les chats de groupe, définissez la variable client answer\_on\_group\_chat = "1". Par défaut, cette fonctionnalité est désactivée.

## Archive de chats

Les chats archivés sont exclus du traitement.

## Démarrer une discussion à l'aide d'un numéro de téléphone

Pour démarrer une conversation avec un nouveau client, allez à la **« Clients »** section et cliquez sur **"Écrire sur Telegram".**

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

Saisissez le numéro de téléphone et le nom du client dans la fenêtre affichée, puis confirmez en cliquant sur **"Ajouter"**.

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

Si le nouveau client a configuré ses paramètres de confidentialité Telegram pour permettre la découverte par numéro de téléphone, une nouvelle fiche client sera générée.

## Importation de clients depuis un fichier

Vous pouvez importer des clients depuis un fichier. Pour cela, cliquez sur **Télécharger une liste de clients** dans le **Messageries** section du bot souhaité.

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

Une fois l'importation terminée, des profils clients seront générés pour ceux qui peuvent être ajoutés aux contacts sur la base de leur numéro de téléphone.

{% hint style="danger" %}
VEUILLEZ NOTER !

Tenez compte des restrictions de Telegram concernant la création de contacts de compte. En savoir plus dans les [Important à savoir ](#important-to-know)section.&#x20;
{% endhint %}

## Méthodes du calculateur

create\_telegram\_client(phone, name, group) - ajoute le numéro spécifié aux contacts du compte Telegram et crée un client correspondant dans MaviBot.

phone - téléphone du client

name - nom du client

group - identifiant de l'utilisateur du bot cible pour la liaison au bot.

{% hint style="success" %}
Le calculateur prend également en charge les méthodes courantes/générales.
{% 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/fr/chatbot/messageries/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.