# Travailler avec les clients et le CRM

## Travail avec les clients

<mark style="color:red;">**LÉGENDE :**</mark>

was\_in\_state() | days\_from\_last\_message() | free\_client() | assign\_to\_user() | distribute\_client()| get\_operator() | get\_operator\_name() | delete\_pended\_messages() | set\_note() | add\_unread() | clear\_unread() | unsubscribe()|block\_client() | unblock\_client() | set\_client\_name() | get\_bind\_clients() | get\_current\_pipline\_id()

<details>

<summary>Description</summary>

**was\_in\_state(message\_id)**\
vérifie si un client se trouvait dans l’état sélectionné (bloc). Vous pouvez obtenir le numéro du bloc dans l’éditeur.

<figure><img src="/files/be96357ccb982ea972d7d2eb5e88f2ef8072db51" alt=""><figcaption><p>La ligne supérieure de l’éditeur de bloc affiche le numéro du bloc.</p></figcaption></figure>

**days\_from\_last\_message()**\
détermine le nombre de jours écoulés depuis le dernier message du client. Créée pour vérifier si cela se situe dans la fenêtre de 24 heures.

Exemple : \
`d = days_from_last_message()`

{% hint style="info" %}
Si plus de 30 jours se sont écoulés depuis le dernier message du client, la fonction renverra la valeur 9999.
{% endhint %}

\
**libérer*****\_*****client()**\
désaffecte l’opérateur responsable.\r Exemple : free\_client()

**assign\_to\_user(email, only\_active)**\
attribue une discussion à un opérateur, où :

1. email - paramètre chaîne de caractères (facultatif). Si seul l’e-mail est fourni, la discussion sera attribuée à l’opérateur spécifié quel que soit son statut actuel.&#x20;
2. only\_active - Vrai ou Faux (paramètre facultatif). Si défini sur Vrai, une discussion sera attribuée à l’opérateur spécifié uniquement s’il est actuellement en service.

Exemples :

`assign_to_user()` - attribue une discussion à un opérateur aléatoire actuellement en service&#x20;

`assign_to_user('email de l’opérateur')` - attribue une discussion à l’opérateur quel que soit son statut

`assign_to_user('email de l’opérateur', True)` - attribue une discussion à l’opérateur spécifié uniquement s’il est actuellement en service

**distribute\_client()**\
attribue une discussion à l’opérateur selon les paramètres de répartition automatique. \nExemple :  `distribute_client()`

**get\_operator**()\n récupère l’e-mail de l’opérateur responsable

Exemple : `get_operator()`&#x20;

Peut être utilisé pour attribuer des tâches à un opérateur responsable ou pour vérifier s’il existe. S’il n’y a pas d’opérateur responsable, la fonction renverra None.

**get\_operator\_name**()\n récupère le nom de l’opérateur responsable

Exemple :  `get_operator_name()`&#x20;

Peut être utilisé pour afficher des informations au client. S’il n’y a pas d’opérateur responsable, la fonction renverra None. Si l’opérateur n’a pas de nom attribué, son e-mail sera renvoyé.

**delete\_pended\_messages()**\
supprime tous les messages programmés pour le client actuel. Par défaut, cela supprime aussi les messages créés par les **« Ne pas annuler »** flèches. Pour conserver les messages des **« Ne pas annuler »** flèches, passez le paramètre False : delete\_pended\_messages(False).

**set\_note(comment)**\
ajoute un commentaire à une discussion.

Exemple : **`set_note`**`('Refaire')`

**add\_unread(count)**\
marque une discussion avec un client comme non lue

Le paramètre count peut être omis ou défini sur 1 ; dans ce cas, la discussion avec le client affichera un indicateur de +1 message non lu.

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

<div data-with-frame="true"><figure><img src="/files/65fff46c3b101694d2dfc77cc1cb641e151db333" alt="" width="375"><figcaption></figcaption></figure></div>

Si tout autre nombre est passé, il sera affiché dans la **« Clients »** section comme le nombre de messages non lus d’un client.

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

**clear\_unread()**\
marque une discussion comme lue

**unsubscribe()**\
Fonction permettant de se désabonner des messages du bot. Un exemple est fourni [dans cet article.](/doc/fr/envois-commerciaux/se-desabonner-du-bot.md)
&#x20; Pour le client désabonné, un symbole apparaîtra — un message rouge avec une croix.

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

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

{% hint style="info" %}
**Important !**

Le **Le calculateur est exécuté en premier**, puis seulement le message est envoyé.

Par conséquent, si vous devez envoyer un message final comme **« Vous avez été désabonné du bot »** ou **« Vous avez été bloqué »**, vous devez utiliser un processus en deux étapes :

1. **Tout d’abord, envoyez un bloc** contenant le message final.
2. **Ensuite, envoyez un bloc vide** contenant la fonction de désabonnement/de blocage.

**Si vous essayez de faire les deux dans un seul bloc, le message ne sera pas envoyé.**
{% endhint %}

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

Si vous placez la `unsubscribe()` fonction dans le calculateur du même bloc que votre message, le message ne sera **pas envoyé**, et le système affichera une erreur.

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

**block\_client()**\
bloque un client afin qu’il ne puisse plus envoyer de messages au bot. Les messages du bot déjà programmés seront également annulés. Cependant, il restera possible d’écrire directement au client depuis la discussion dans la **« Clients »** section

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

Un client bloqué aura un marqueur — une icône de cadenas rouge.

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

**unblock\_client()**\
débloque le client. Le client pourra à nouveau interagir avec le bot et suivre les chaînes de messages.

**set\_client\_name(name)**\
modifie le nom du client. Passez le nom du client sous forme de chaîne entre guillemets doubles. Vous pouvez également utiliser une variable contenant le nom du client, par exemple : set\_client\_name("John Smith")

**get\_bind\_clients()**\
fonction sans paramètre qui renvoie un tableau des identifiants des clients liés au client actuel.

**get\_current\_pipline\_id()**\
fonction sans paramètre qui renvoie l’ID du tunnel dans lequel se trouve actuellement le client.

Si l’affaire du client se trouve à l’étape « non traitée », la fonction renvoie None.

</details>

## Travail avec les tâches&#x20;

{% hint style="success" %}
Les fonctions qui travaillent avec les tâches renvoient l’état de l’opération comme **True ou l’ID de la tâche en cas de succès. En cas d’échec, elles renvoient False ou None.**
{% endhint %}

{% hint style="info" %}
MaviBot utilise le format de date **"jj.mm.aaaa"** et le format d’heure **"HH:MM"**.
{% endhint %}

create\_task() | update\_task() | done\_task() | delete\_task()

<details>

<summary>Description</summary>

**create\_task(email, name, date\_srok, description, time\_srok)** – crée une tâche

Paramètres :\ <mark style="color:red;">**!**</mark>**&#x20;e-mail** - e-mail de la personne responsable\ <mark style="color:red;">**!**</mark>**&#x20;name** - nom de la tâche\ <mark style="color:red;">**!**</mark>**&#x20;date\_srok** - date d’échéance, date\ <mark style="color:red;">**!**</mark>**&#x20;description** - description de la tâche\
**time\_srok** - heure d’échéance, heure

**update\_task(task\_id,email, name, date\_srok, description, time\_srok)** - met à jour une tâche

Paramètres :\ <mark style="color:red;">**!**</mark>**&#x20;task\_id**- ID de la tâche\ <mark style="color:red;">**!**</mark>**&#x20;e-mail** - e-mail de la personne responsable\ <mark style="color:red;">**!**</mark>**&#x20;name** - nom de la tâche\ <mark style="color:red;">**!**</mark>**&#x20;date\_srok** - date d’échéance, date\ <mark style="color:red;">**!**</mark>**&#x20;description** - description de la tâche\
**time\_srok** - heure d’échéance, heure

**done\_task(task\_id)**- marque une tâche comme terminée

Paramètres :\ <mark style="color:red;">**!**</mark>**&#x20;task\_id**- ID de la tâche

**delete\_task(task\_id)** – supprime une tâche

Paramètres :\ <mark style="color:red;">**!**</mark>**&#x20;task\_id**- ID de la tâche

</details>

<details>

<summary>Exemples</summary>

Créons une tâche pour l’opérateur :

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

Mettez à jour la date d’échéance et la description.

<div data-with-frame="true"><figure><img src="/files/a0f5cf9b1dfe47d6d050e695cb13d705a05c8e27" alt="" width="563"><figcaption><p>Mise à jour de la tâche</p></figcaption></figure></div>

Marquer la tâche comme terminée.

<div data-with-frame="true"><figure><img src="/files/cf0617f7effe597ecd079d03e28d997f5b82e7f2" alt="" width="563"><figcaption><p>Marquage de la tâche comme terminée</p></figcaption></figure></div>

Suppression de la tâche

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

</details>

<details>

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

`task_id=create_task('admin@mavibot.ai', 'Test', '22.01.2023', 'tâche de test', '08:00') status=delete_task(task_id)`

</details>

## Travail avec les affaires

get\_order\_id() | create\_order() | set\_order\_name() | set\_order\_budget() | get\_active\_orders\_ids() | get\_success\_orders\_ids() | get\_fail\_orders\_ids() | get\_order\_var() | get\_order\_vars() | set\_order\_var() | set\_order\_vars() | move\_order\_to\_next\_state() | set\_order\_status\_success() | set\_order\_status\_fail(order\_id)| get\_state\_id() | change\_state() | get\_order\_id\_by\_var\_value() | latest\_order\_datetime() | count\_client\_orders(), get\_count\_orders() | delete\_order(order\_id)

<details>

<summary>Description</summary>

<mark style="background-color:blue;">**Récupération de l’ID de l’affaire en cours**</mark>

**get\_order\_id()** - renvoie l’état de l’affaire.

<mark style="background-color:blue;">**Création d’une nouvelle affaire**</mark>

**create\_order(name, budget, description, client\_name, phone, email, state\_id)**\
L’affaire actuellement active dans le pipeline, ainsi que ses variables, ne seront disponibles que dans les fonctions liées aux affaires et dans le CRM.\
\
**Paramètres de la fonction :** \ <mark style="color:red;">**!**</mark>**&#x20;name** - (facultatif), le nom de l’affaire. S’il n’est pas fourni, la fonction s’applique à l’affaire active actuelle du client.

<mark style="color:red;">**!**</mark>**&#x20; budget** - (facultatif) la valeur de l’affaire. Si elle n’est pas fournie, s’applique à l’affaire active actuelle.\nSi **budget** n’est pas un nombre, la fonction renverra : **le budget doit être un nombre**

**description** - (facultatif), la description de l’affaire.

Paramètres supplémentaires pour la création du client :

**client\_name** - (facultatif) chaîne, nom d’un nouveau client

**phone** - (facultatif) chaîne, numéro de téléphone d’un nouveau client.

**e-mail** - (facultatif) chaîne, adresse e-mail d’un nouveau client.

Pour créer un client, il faut fournir au moins un téléphone ou un e-mail. Si un téléphone est fourni et qu’aucun client avec ce numéro n’existe dans le projet, un nouveau client sera créé.

Si un e-mail est fourni sans téléphone et qu’aucun client avec cet e-mail n’existe, un nouveau client sera créé.

Paramètre supplémentaire :

**state\_id** - nombre, permet de définir l’état initial de l’affaire lors de sa création

<mark style="background-color:blue;">**Définir ou mettre à jour le nom de l’affaire**</mark>

**set\_order\_name(name, order\_id)**

**name** - ❗obligatoire, chaîne ; le nom de l’affaire

**order\_id** - (facultatif) ID de l’affaire. S’il n’est pas fourni, la modification s’applique à l’affaire active actuelle du client.

<mark style="background-color:blue;">**Définir ou mettre à jour le budget de l’affaire**</mark>

**set\_order\_budget(budget, order\_id)**

**budget** -❗obligatoire, nombre ; la valeur de l’affaire

**order\_id** - (facultatif) ID de l’affaire. S’il n’est pas fourni, s’applique à l’affaire active actuelle du client.

Pour utiliser order\_id correctement :

1. Vous pouvez le spécifier manuellement — récupérez l’ID de l’affaire et passez-le en paramètre de la fonction si vous souhaitez cibler une affaire précise.

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

<div data-with-frame="true"><figure><img src="/files/68b514f8f4ba77ed0bc1fe57140ed109a5dffea6" alt="" width="375"><figcaption></figcaption></figure></div>

1. Récupérez-le à l’aide de la fonction get\_order\_id(), car la variable intégrée order\_id renvoie la valeur au format {client\_id}-{order\_id}, ce qui peut entraîner un comportement incorrect.

<mark style="background-color:blue;">**Récupération des listes d’affaires**</mark> \
((à l’exclusion des affaires archivées, réussies ou échouées))

**get\_active\_orders\_ids()**&#x20;

<mark style="background-color:blue;">**Obtenir la liste des ID des affaires réussies**</mark>

**get\_success\_orders\_ids()**&#x20;

<mark style="background-color:blue;">**Obtenir la liste des ID des affaires échouées**</mark>

**get\_fail\_orders\_ids()**

<mark style="background-color:blue;">**Récupération de la valeur d’une variable d’affaire**</mark>

**get\_order\_var(order\_id, variable)**&#x20;

Paramètres :

<mark style="color:red;">**!**</mark>**&#x20;order\_id** - ID de l’affaire&#x20;

<mark style="color:red;">**!**</mark>**&#x20;variable** - nom de la variable dont vous souhaitez récupérer la valeur

<mark style="background-color:blue;">**Récupération des données de l’affaire**</mark>

**get\_order\_vars(order\_id, names)**&#x20;

Paramètres :

<mark style="color:red;">**!**</mark>**&#x20;order\_id** - ID de l’affaire

**names** - un tableau de noms de variables à récupérer. S’il est omis, la fonction renvoie toutes les variables de l’affaire spécifiée

La fonction renvoie un dictionnaire contenant les variables répertoriées dans le **names** tableau pour l’affaire identifiée par **order\_id**. Si **names** n’est pas fourni, elle renvoie un dictionnaire avec toutes les variables de l’affaire spécifiée.

<mark style="background-color:blue;">**Ajout d’une variable d’affaire**</mark>

**set\_order\_var(order\_id, variable, value)**

Paramètres :

<mark style="color:red;">**!**</mark>**&#x20;order\_id** - ID de l’affaire

<mark style="color:red;">**!**</mark>**&#x20;variable** - le nom de la variable à ajouter ou mettre à jour dans une affaire

{% hint style="warning" %}
Si vous souhaitez modifier les paramètres de l’affaire « name » ou « description », utilisez respectivement les noms de variable « name » ou « description ».
{% endhint %}

<mark style="color:red;">**!**</mark>**&#x20;value** - valeur de la variable

<mark style="background-color:blue;">**Ajout de plusieurs variables d’affaire**</mark>

**set\_order\_vars(order\_id, variables\_dict)**&#x20;

Paramètres :

<mark style="color:red;">**!**</mark>**&#x20;order\_id** - ID de l’affaire.&#x20;

<mark style="color:red;">**!**</mark>**&#x20;variables\_dict** - un dictionnaire de variables

<mark style="background-color:blue;">**Passage à l’état suivant du tunnel**</mark>

**move\_order\_to\_next\_state(order\_id)**&#x20;

Paramètres :\
**order\_id** - ID de l’affaire. S’il n’est pas spécifié, l’affaire active actuelle sera déplacée.\nL’ordre des états d’affaire est défini selon la séquence configurée dans MavibotCRM.

<mark style="background-color:blue;">**Récupération de l’étape du tunnel dans MavibotCRM**</mark>

**get\_state\_id(client\_id, order\_id)** \
Vous pouvez également copier directement l’ID de l’état du pipeline depuis les **« Paramètres d’état »**.

Paramètres :

**order\_id -** ID de l’affaire du client

Vous pouvez appeler la fonction avec ou sans le **order\_id** paramètre. Si order\_id est omis, la fonction renverra l’ID de l’état du pipeline pour l’affaire active actuelle.

Pour utiliser correctement order\_id :

1. Vous pouvez le spécifier manuellement en obtenant l’ID de l’affaire et en le passant comme paramètre de la fonction lorsque vous souhaitez cibler une affaire précise.
2. Récupérez-le à l’aide de la fonction get\_order\_id(), car la variable intégrée order\_id renvoie une valeur au format {client\_id}-{order\_id}, ce qui peut provoquer un comportement incorrect.

<mark style="background-color:blue;">**Déplacement d’un lead dans le tunnel MavibotCRM par ID d’état**</mark>

**change\_state(state\_id, order\_id)**&#x20;

Paramètres :\ <mark style="color:red;">**!**</mark> **state\_id -** ID de l’état du tunnel\
**order\_id (** facultatif) - l’ID de l’affaire à déplacer dans le pipeline. S’il est omis, l’affaire active actuelle sera déplacée.

<mark style="background-color:blue;">**Obtention de l’ID d’une affaire par nom et valeur de variable**</mark>

get\_order\_id\_by\_var\_value(var\_name, var\_value, client\_id)

Paramètres :\ <mark style="color:red;">!</mark> var\_name - nom de la variable\ <mark style="color:red;">!</mark> var\_value - valeur de la variable ;\nclient\_id - (facultatif) ID de l’affaire du client ; par défaut, l’ID du client dans le bot

<mark style="background-color:blue;">**Obtention de la date et de l’heure de la dernière affaire**</mark>

latest\_order\_datetime(client\_id, dt\_fmt)

Paramètres :\nclient\_id - (facultatif) l’ID de l’affaire du client ; par défaut, l’ID du client dans le bot ;\ndf\_fmt - (facultatif) format pour la date et l’heure renvoyées ; la valeur par défaut est "%d.%m.%y %H:%M"

<mark style="background-color:blue;">**Obtention du nombre d’affaires du client**</mark>

count\_client\_orders(client\_id, state\_id, get\_all, active)

Paramètres :\nclient\_id -  (facultatif) l’ID de l’affaire du client ; par défaut, l’ID du client dans le bot ;\nstate\_id - (facultatif) l’ID de l’état de l’affaire dans le pipeline ;\nget\_all - (facultatif) indicateur de filtre pour le paramètre active ; la valeur par défaut est 1 (le filtrage par actif est désactivé) ;\nactive - utilisé uniquement lorsque get\_all est 0 ; filtre les affaires actives ; la valeur par défaut est 1 (ne renvoie que les affaires actives) ;

<mark style="background-color:blue;">**Obtenir le nombre d’affaires dans un état d’affaire spécifique**</mark>

get\_count\_orders(id) - renvoie le nombre d’affaires actuellement dans un état de pipeline spécifique selon l’ID d’état.

La fonction prend un seul paramètre :

<mark style="color:red;">**!**</mark> id - l’ID de l’état de l’affaire.&#x20;

Exemple d’utilisation de la fonction :

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

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

L’ID de l’étape peut être trouvé dans les paramètres.

Ensuite, vous devez saisir la fonction dans le calculateur comme suit :

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

Lors des tests du bot, la réponse du bot consistera en le nombre d’affaires dans l’état spécifié par la valeur transmise à la fonction.

<mark style="background-color:blue;">**Suppression d’une affaire**</mark>

delete\_order(order\_id) — supprime une affaire dans **MaviBotCRM**.

order\_id - (facultatif) l’ID de l’affaire à supprimer. S’il est omis, l’affaire la plus récente sera supprimée.&#x20;

</details>

<details>

<summary>Exemples</summary>

Toutes les fonctions sont simples à utiliser.\r\nPar exemple, créons une nouvelle affaire et envoyons son numéro au client :

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

<div data-with-frame="true"><figure><img src="/files/e7e5240ba05844d83363d9d96180114f96f8c8a3" alt="" width="563"><figcaption><p>Enregistrement de la demande du client</p></figcaption></figure></div>

Vous pouvez obtenir l’ID de l’affaire active actuelle du client à l’aide de la fonction get\_order\_id(), ou récupérer la liste complète des affaires du client à l’aide de get\_active\_orders\_ids().

<div data-with-frame="true"><figure><img src="/files/23e177f76d8aa32f2ad1713fccefbbcafc073dc5" alt="" width="563"><figcaption><p>Récupération de l’ID de l’affaire active actuelle</p></figcaption></figure></div>

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

<div data-with-frame="true"><figure><img src="/files/16664d8f8bfb3aeb1aeeee3885bbeec4908a6898" alt="" width="563"><figcaption><p>Récupération de la liste des affaires actives</p></figcaption></figure></div>

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

</details>

<details>

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

<pre><code><strong>/* Créer une nouvelle affaire */
</strong>oid = create_order()

/*Récupérer l’ID de l’affaire active du client*/
oid = get_order_id()

/*Récupérer la liste des affaires actives*/
res = get_active_orders_ids()

/*Ajouter ou mettre à jour une variable unique dans l’affaire*/
res = set_order_var('40630', 'обновлено', '#{current_date}')

vars = {"VAR1": "V111", "VAR2": "V222"}
res2 = set_order_vars('40630', vars)

ovar = get_order_vars('40630')
</code></pre>

</details>

### <mark style="background-color:blue;">**Définition d’un tag d’affaire réussie**</mark>

set\_order\_status\_success()

{% tabs %}
{% tab title="Description" %}
**set\_order\_status\_success(order\_id)**&#x20;

Paramètres :

**order\_id** - l’ID de l’affaire. Si le paramètre n’est pas spécifié, le tag sera défini pour l’affaire active actuelle.
{% endtab %}
{% endtabs %}

### <mark style="background-color:blue;">**Définition d’un tag d’affaire échouée**</mark>&#x20;

set\_order\_status\_fail()

{% tabs %}
{% tab title="Description" %}
**set\_order\_status\_fail(order\_id)**&#x20;

Paramètres :

**order\_id** - l’ID de l’affaire. Si le paramètre n’est pas spécifié, le tag sera défini pour l’affaire active actuelle.
{% endtab %}
{% endtabs %}

### <mark style="background-color:blue;">**Définition d’un tag d’affaire archivée**</mark> &#x20;

set\_order\_status\_archive()

{% tabs %}
{% tab title="Description" %}
**set\_order\_status\_archive(order\_id)**&#x20;

Paramètres :

**order\_id** - l’ID de l’affaire. Si le paramètre n’est pas spécifié, le tag sera défini pour l’affaire active actuelle.
{% endtab %}

{% tab title="Exemples" %}
/\*Archiver l’affaire active actuelle\*/

`res_arh = set_order_status_archive()`
{% endtab %}
{% endtabs %}


---

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