# Configuration du collecteur et des tickets

Le principe est simple : utiliser les emails pour créer des tickets ou ajouter des suivis à des tickets déjà existants.

Une tâche interne GLPI se connectera à une boîte mail et récupérera les messages pour les transformer.

Afin d'y parvenir nous devons utiliser les outils GLPI : **Collecteurs** et **Actions Automatiques**.

Nous explorerons ce sujet dans l'ordre suivant :

* Collecteurs
* Actions Automatiques
* Spécificités selon les fournisseurs

## Collecteurs

Commençons par définir un collecteur.

Un collecteur permet d'importer un email depuis une boîte mail et de le transformer en ticket dans GLPI. Un mécanisme de routage permet de l'assigner à une entité de destination.

* Les collecteurs se configurent depuis le menu **`setup`** > **`Receivers`**
* Ajoutez un nouveau collecteur en cliquant sur **`add`**

![Alt text](https://1227510999-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FqmRzI15ndDbFHGd5BnM4%2Fuploads%2Fgit-blob-498f3689876811dde4af8c047ac94c8c3444bc3b%2Fcollecteur-2.png?alt=media)

***

### Explication des champs :

* **Name (Email)**\
  Le nom du collecteur doit être l'adresse email complète -> <mon@adresse.mail>
* **Active**\
  Champ classique GLPI, permet d'activer ou désactiver le collecteur.
* **Server**\
  Ce champ doit contenir le FQDN ou l'adresse IP de votre serveur.
* **Connection options**\
  Ces différentes listes permettent de définir les paramètres de connexion à votre serveur (IMAP ou POP, SSL, TLS, validation de certificat, etc.)
* **Incoming mail folder (optional, often INBOX)**\
  Si vous avez des messages que vous souhaitez collecter dans un dossier spécifique de la boîte mail, c'est ici qu'il faut l'indiquer.
* **Port (optional)**\
  Indiquez ici si votre serveur mail nécessite un port spécifique pour établir la connexion.
* **Connection string**\
  Ce champ n'est pas disponible lors de la création du collecteur
* **Login**\
  Ici vous devrez saisir l'identifiant de la boîte mail. Souvent ce sera le préfixe de l'adresse email (tout ce qui est avant **@)** mais il est préférable de saisir l'adresse email complète.
* **Password**\
  Insérez le mot de passe associé à la boîte mail concernée par le collecteur.
* **Accepted mail archive folder (optional)**\
  Ce champ est optionnel, il permet d'indiquer un fichier d'archivage pour les emails acceptés du collecteur.
* **Refused mail archive folder (optional)**\
  Ce champ est optionnel, il permet d'indiquer un dossier d'archive pour les emails refusés du collecteur
* **Maximum size of each file imported by the mails receiver**\
  Ce champ permet de modifier la taille des fichiers importés. Il permet également de désactiver l'import en plaçant le champ sur "No import"
* **Use mail date, instead of collect one**\
  Ce champ va affecter l'heure de création des tickets ! Il est important de le prendre en compte, notamment lors de la mise en place de SLA.
* **Use Reply-To as requester (when available)**\
  Ce champ permet de changer le demandeur du ticket généré par le mail selon le champ "Reply to mail".
* **Add CC users as observer**\
  Ce champ permet d'ajouter les utilisateurs CC (mail) comme observateur dans le ticket généré.
* **Collect only unread mail**\
  Ce champ permet de ne générer des tickets qu'à partir de mails non lus.
* **Comments**\
  Simple champ texte dans lequel vous pouvez saisir du contenu à titre informatif. Il n'influence pas la configuration.

## Règles de collecte

Une fois le collecteur mis en place, il est nécessaire de mettre en place une règle de collecteur, disponible à cet endroit:

<figure><img src="https://1227510999-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FqmRzI15ndDbFHGd5BnM4%2Fuploads%2FP9wEKAUGA3teqLEAnVBU%2Fimage.png?alt=media&#x26;token=d691164c-6467-456a-9f79-9d2054f07a73" alt=""><figcaption></figcaption></figure>

Cette règle doit, au minimum, avoir en critère le collecteur lui même:

<figure><img src="https://1227510999-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FqmRzI15ndDbFHGd5BnM4%2Fuploads%2FC9kF4hVVLhGXFsiMQa19%2Fimage.png?alt=media&#x26;token=20a942d0-93b5-4f1f-b558-c8cf91be8951" alt=""><figcaption></figcaption></figure>

Et en Actions, l'entité dans laquelle les tickets générés par ce collecteur doivent être créés:

<figure><img src="https://1227510999-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FqmRzI15ndDbFHGd5BnM4%2Fuploads%2FeYHT74ORw2rPnsyooSw8%2Fimage.png?alt=media&#x26;token=33dc31b4-a418-435d-83b8-5a42437679e7" alt=""><figcaption></figcaption></figure>

## Actions Automatiques

Une fois le collecteur configuré, il est nécessaire de configurer ou vérifier l'action automatique de GLPI concernant les collecteurs, **`mailgate`**.

Les actions automatiques se configurent depuis le menu **`Configuration`** > **`Automatic actions`**

* Sélectionnez l'action mailgate.

![Alt text](https://1227510999-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FqmRzI15ndDbFHGd5BnM4%2Fuploads%2Fgit-blob-188943e1ac2ae6db2ee5fe0aea7a4cd093e0bb8a%2Fcollecteur-3.png?alt=media)

***

### Explication des champs :

* **Run frequency**\
  Cette liste permet de définir la période d'exécution de l'action automatique. Elle va de la minute au mois.

{% hint style="danger" %}
**Attention**

Ce paramètre doit correspondre à vos SLA possibles.**Status**\
Ce champ sert à définir si l'action automatique doit être lancée ou non.
{% endhint %}

* **Run mode**\
  Ce champ permet de définir le mode de lancement de l'action :
  1. **`GLPI`** : (non recommandé) l'activité de la plateforme qui déclenche les actions
  2. **`CLI`** : (mode recommandé) l'exécution des tâches est gérée via le système Cloud (toutes les 15 minutes en mode payant)
* **Run period**\
  Deux champs horaires pour définir la plage d'exécution
* **Number of days this action logs are stored (in days)**\
  Ici vous pouvez sélectionner le nombre de jours de logs stockés
* **Number of emails to retrieve**\
  Ce champ permet de définir le nombre maximum d'emails à récupérer lors du déclenchement de l'action.
* **Comments**\
  Champ texte classique permettant de saisir des indications, remarques, etc. Il n'affecte pas la configuration.

Avec la configuration de votre collecteur et de l'action automatique, vos emails seront maintenant transformés en tickets GLPI.

## Spécificités selon les fournisseurs

Suivez ces articles pour mettre les bons paramètres selon les fournisseurs :

* [Gmail](https://help.glpi-project.org/tutorials/fr/receivers/collect_mails_from_gmail)
* [Office365](https://help.glpi-project.org/tutorials/fr/receivers/receiver_office365)
* [iCloud](https://help.glpi-project.org/tutorials/fr/receivers/receiver_icloud)