# Travailler dans les messageries

## Vérification de l’abonnement Instagram

check\_insta\_subscription()

<details>

<summary>Description</summary>

<mark style="background-color:blue;">**Pour vérifier l’abonnement à un compte Instagram**</mark>

**check\_insta\_subscription()**

Paramètres : aucun

La fonction renvoie un booléen **True** si l’utilisateur est abonné au compte, **Faux** sinon.

</details>

<details>

<summary>Exemples</summary>

<figure><img src="/files/a25db2d2ee5e539d875674c7c2d504d4c16ef07e" alt="" width="375"><figcaption></figcaption></figure>

</details>

<details>

<summary>Exemple de code à copier</summary>

`r=check_insta_subscription()`

</details>

## Travailler avec WhatsApp&#x20;

check\_whatsapp() | get\_whatsapp\_bot\_id\_by\_phone()

<details>

<summary>Description</summary>

{% hint style="warning" %}
Les fonctions fonctionnent si un bot WhatsApp est connecté à un projet.
{% endhint %}

<mark style="background-color:blue;">**Pour vérifier si un numéro de téléphone a WhatsApp**</mark>

**check\_whatsapp(phone\_number)**\
méthode permettant de vérifier si WhatsApp est connecté au numéro de téléphone donné

Paramètres :\
**phone\_number** - numéro de téléphone au format 79999999999 ou 89999999999

La fonction renvoie un booléen **True** si le numéro est enregistré dans WhatsApp, **Faux** sinon.

<mark style="background-color:blue;">**Pour obtenir l’identifiant du bot WhatsApp par numéro de téléphone**</mark>

**get\_whatsapp\_bot\_id\_by\_phone(bot\_phone)**\
fonction permettant de trouver l’identifiant du bot WhatsApp par numéro de téléphone

</details>

<details>

<summary>Exemples</summary>

Voyons si WhatsApp est connecté à un numéro de téléphone :

<figure><img src="/files/f274b7cc1fe7a14387ce4590b7bd60a2946403c5" alt="" width="375"><figcaption><p>Exemple d’utilisation de la fonction check_whatsapp()</p></figcaption></figure>

</details>

<details>

<summary>Exemple de code à copier</summary>

```
rs=check_whatsapp(79999999999)
```

</details>

## Suppression du dernier message

last\_message\_id() | remove\_last\_message()

<details>

<summary>Description</summary>

**last\_message\_id()**- pour obtenir le numéro du dernier message du bot

{% hint style="info" %}
Si une image et du texte ont été envoyés, les numéros des messages sont séparés par un underscore (\_).
{% endhint %}

{% hint style="warning" %}
Pour obtenir correctement le numéro du dernier message du bot, le message doit être enregistré dans l’historique de dialogue du client.

Cela signifie que, dans un bloc de tunnel, l’enregistrement de l’historique des messages doit être activé si l’envoi est effectué via le tunnel, ou, lors de l’envoi d’une diffusion, l’option « enregistrer le message dans l’historique du dialogue » doit être activée.
{% endhint %}

**remove\_last\_message()** – pour supprimer le dernier message du bot

{% hint style="danger" %}
Cela fonctionne uniquement dans Telegram et Facebook.
{% endhint %}

Si le **« Enregistrer dans l’historique du dialogue »** si l’option est activée, alors pour Telegram et FB, vous pouvez supprimer le dernier message via un envoi depuis un bloc. Utilisez simplement la fonction **remove\_last\_message()** dans le calculateur. Cette fonction supprime le dernier message envoyé par le bot, mais uniquement si ce message est enregistré dans l’historique du dialogue.

</details>

<details>

<summary>Exemple</summary>

Exemple :

1. Créer un bloc de diffusion :

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

{% hint style="success" %}
Configurez les paramètres d’envoi comme vous le souhaitez, puis allez à **« Envoi »** .
{% endhint %}

&#x20;2\. Activez la case à cocher **« Enregistrer la diffusion dans l’historique du dialogue du client »** dans le **« Envoi »** :

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

Vous pouvez maintenant envoyer la diffusion.

Si vous souhaitez supprimer le dernier message (par exemple, un message contenant une erreur), vous pouvez le faire dans un seul bloc à l’aide de la fonction **remove\_last\_message()**.

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

Ensuite, envoyez la diffusion avec la fonction de suppression du dernier message.

{% hint style="warning" %}
IMPORTANT ! Le dernier message ne peut pas être supprimé après un certain temps !
{% endhint %}

Exemple d’obtention de l’ID du dernier message.

<figure><img src="/files/41e483f9261164a4c61ae0c659d982ef392d8b12" alt="" width="375"><figcaption></figcaption></figure>

</details>

<details>

<summary>Exemple de code à copier</summary>

```
soob = last_message_id()
status = remove_last_message()
```

</details>

## Mise en pause de l’activité du bot

\| pause\_bot(minutes)

<details>

<summary>Description</summary>

pause\_bot(minutes) - met en pause l’activité du bot pendant le nombre de minutes spécifié.

minutes - paramètre obligatoire représentant le nombre de minutes. Il peut être transmis soit comme un entier, soit comme un nombre décimal.

La fonction fonctionne comme un clic sur le bouton **« Pause »** dans un dialogue client, mais vous permet de spécifier la durée de pause du bot. Elle renvoie **True** en cas d’exécution réussie.

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

</details>

## Suppression des messages planifiés

\| delete\_pended\_messages\_from\_list(message\_id\_list, with\_not\_delete)

<details>

<summary>Description</summary>

delete\_pended\_messages\_from\_list(message\_id\_list, with\_not\_delete)

La fonction aide à supprimer des messages spécifiques parmi ceux planifiés.

<mark style="color:red;">!</mark> message\_id\_list - paramètre obligatoire ; une liste de blocs dont les messages doivent être supprimés parmi les messages planifiés.

with\_not\_delete - paramètre facultatif ; supprime les messages marqués comme **« Ne pas supprimer. »** Toute valeur peut être transmise à ce paramètre.

La valeur de retour **« wrong message\_id\_list »** apparaît si message\_id\_list n’est pas fourni ou n’est pas un tableau.

Comment transmettre des paramètres :

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

Où obtenir le paramètre requis :

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

</details>

## Vérification du statut de l’opérateur

\| check\_operator\_status(email, with\_pause)

<details>

<summary>Description</summary>

check\_operator\_status(email, with\_pause) - vérifie si l’opérateur est en service. Renvoie **True** si l’opérateur est en service, et **Faux** sinon.

<mark style="color:red;">**!**</mark> email - paramètre obligatoire ; l’adresse e-mail d’un employé

with\_pause - paramètre facultatif avec les valeurs 1 ou 0. Si la valeur 1 est définie, la fonction renvoie un résultat positif lorsque le statut de l’opérateur est soit **« En service »** ou **« En pause. »** Si la valeur 0 est définie, elle renvoie un résultat positif uniquement lorsque le statut de l’opérateur est **« En service. »**
&#x20;Valeur par défaut : 1.

</details>


---

# 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/functions/calculatrice/messengers.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.