# Version 1 (ancienne méthode)

{% hint style="warning" %}
Cette procédure s’adresse aux personnes qui auraient déjà une application WhatsApp paramétrée. Si ce n’est pas le cas, merci de consulter la Version 2 afin de créer une nouvelle application.
{% endhint %}

## Fonctionnalités

* Ouvrez des tickets directement depuis Whatsapp
* Simplifiez vos échanges et suivez vos tickets directement depuis l'application ou un navigateur Web

## Prérequis

| GLPI     | PHP minimum | PHP recommanded |
| -------- | ----------- | --------------- |
| ≥ 11.0.3 | 8.2         | 8.4             |

{% hint style="info" %}
Une souscription [GLPI Network BASIC](https://services.glpi-network.com/#offers) (ou supérieur) est requis. Ce plugin est également disponible pour toutes les instances [Cloud de GLPI Network](https://glpi-network.cloud).
{% endhint %}

* Être en possession d’un compte WhatsApp (Méta) business actif avec un numéro de téléphone valide
* Avoir une instance GLPI disponible depuis Internet et https

{% hint style="success" %}
**RGPD - Bon à savoir**\
Pour le bon fonctionnement du plugin WhatsApp, GLPI conserve le numéro de téléphone de l’utilisateur dans sa base de données. Cette donnée est essentiel pour que le plugin WhatsApp puisse fonctionner.\
\
L’utilisation du plugin anonymize peut entrainer des comportements non désirés en cas d’anonymisation du numéro de téléphone
{% endhint %}

***

## Installer le plugin

Installer le plugin depuis le marketplace

<div align="left"><figure><img src="https://782257568-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJFKLcURHvFBybgf5dths%2Fuploads%2FyKyAh8jy65KSvwSi7RKQ%2FInstaller%20le%20plugin.png?alt=media&#x26;token=075cb522-d7e7-4a3c-8209-183d20d56f8d" alt=""><figcaption><p>Installer la plugin</p></figcaption></figure></div>

Le paramétrage du plugin se fera ensuite dans **`Configuration`** > **`Générale`** > **`Whatsapp`**

## Créer une application depuis un compte Méta

* Depuis le compte Développeur Méta <https://developers.facebook.com/apps/creation/>
* Cliquez sur Créer un ID d’application

<figure><img src="https://782257568-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJFKLcURHvFBybgf5dths%2Fuploads%2FzqOJer9DvWX4t6j7atsr%2FCr%C3%A9ez%20votre%20application.png?alt=media&#x26;token=ffb0e1ff-df66-4c01-bbb6-2b5d8b22530a" alt=""><figcaption><p>Créer votre application Méta</p></figcaption></figure>

* Nommez la, et indiquez un email de contact
* Dans l’étape suivante, indiquez quel cas d’utilisation sera lié à l’application (All > Autre)

<figure><img src="https://782257568-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJFKLcURHvFBybgf5dths%2Fuploads%2FQRE3Bp9U5XZGce5gVjhV%2FS%C3%A9lectionnez%20le%20cas%20d&#x27;usage.png?alt=media&#x26;token=75f8326a-0e31-4acf-ac1a-4946c2fc53c9" alt=""><figcaption><p>Sélectionnez le cas d'usage</p></figcaption></figure>

* Sélectionnez le type d’application (Business dans notre cas pour pouvoir envoyer/recevoir des notifications depuis WhatsApp)

<figure><img src="https://782257568-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJFKLcURHvFBybgf5dths%2Fuploads%2F3N88vP3ltuakk3D2cDgr%2FS%C3%A9lectionnez%20le%20type%20d&#x27;application.png?alt=media&#x26;token=3e61f556-dbbd-42dc-bfcc-0c125c643f63" alt=""><figcaption><p>Sélectionnez le type d'application</p></figcaption></figure>

* Cliquez sur **Créer l’application**

<figure><img src="https://782257568-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJFKLcURHvFBybgf5dths%2Fuploads%2Fjwivkui99QgFRUIeEK18%2FSauvegarder%20votre%20application.png?alt=media&#x26;token=4917181e-9676-4f86-b7ae-9f1932a3468c" alt=""><figcaption><p>Sauvegarder votre application</p></figcaption></figure>

### Ajouter et configurer des produits à votre application

Sur la page suivante, il vous sera proposé d’ajouter des produits (services) à votre application.

* Repérez WhatsApp dans la liste et cliquez sur **Configurer**

<div align="left"><figure><img src="https://782257568-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJFKLcURHvFBybgf5dths%2Fuploads%2FudURntbO7KxyP0gwxWbw%2FAjouter%20Whats%20App%20%C3%A0%20votre%20application.png?alt=media&#x26;token=dda7d143-f99c-4a1d-b8dd-0666f573ee1b" alt=""><figcaption><p>Ajouter WhatsApp à votre application</p></figcaption></figure></div>

* Cliquez sur **Configurer l’API** dans le menu de gauche et assurez-vous que le numéro de téléphone soit bien enregistré.

<figure><img src="https://782257568-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJFKLcURHvFBybgf5dths%2Fuploads%2Fy9d60pLdr8OATi5NAAIc%2FContr%C3%B4ler%20le%20num%C3%A9ro%20de%20t%C3%A9l%C3%A9phone.png?alt=media&#x26;token=60ec592c-0890-4324-9345-f678416f202b" alt=""><figcaption><p>Contrôler le numéro de téléphone</p></figcaption></figure>

* Si ce n’est pas le cas, rendez-vous à l’étape 5 et cliquez sur **Ajouter un numéro** et suiviez les étapes

<figure><img src="https://782257568-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJFKLcURHvFBybgf5dths%2Fuploads%2Fi6vwZxc6HhzxgdI2avo0%2FAjouter%20un%20num%C3%A9ro%20pour%20l&#x27;application.png?alt=media&#x26;token=85328675-910d-4a12-a286-6f97261d6fda" alt=""><figcaption><p>Ajouter un numéro pour l'application</p></figcaption></figure>

### Configurer les Webhook

* Depuis l'onglet Webhook, répercuter à nouveau l'URL et le token (disponible depuis GLPI (**`Configuration`** > **`Générale`** > **`Whatsapp`**`)`
* Cliquez sur **Vérifier et sauvegarder**

<figure><img src="https://782257568-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJFKLcURHvFBybgf5dths%2Fuploads%2FtVj66UWubAZOJ11S91J1%2FV%C3%A9rifier-sauvegarder.png?alt=media&#x26;token=e809f340-ab0b-47ba-80b5-1725e5bf3ff9" alt=""><figcaption><p>Vérifiez et sauvegardez vos informations</p></figcaption></figure>

* Dans la liste produit ,sélectionnez **Whatsapp business account**
* Cochez la case **Abonné** du champ **`message`** (il est possible qu'il faille rafraîchir la page pour accéder à cette option)

<figure><img src="https://782257568-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJFKLcURHvFBybgf5dths%2Fuploads%2FFJXp1nH8fkuNisfC0R5F%2FActiver-messages.png?alt=media&#x26;token=34ce7cac-fcc0-4748-9d47-790ed053c0e4" alt=""><figcaption><p>Activer les messages</p></figcaption></figure>

***

## Gestion d’utilisateur

Il est préférable de créer un utilisateur dédié qui aura des permissions spécifiques pour être autorisé à utiliser les webhook WhatsApp.

### Créer un utilisateur

* Depuis votre [compte Meta](https://business.facebook.com/), rendez-vous dans **Utilisateurs** > **Personnes**
* Cliquez sur **Inviter une personne**
* Entrez les informations demandées sur chaque étape :
  * adresse mail
  * Assigner des accès : sélectionnez **Contrôle total**
  * Assigner un actif : sélectionnez le compte WhatsApp souhaité et assurez vous que les options **`Messages`** et **`Message templates`** soient bien cochées

<div align="left"><figure><img src="https://782257568-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJFKLcURHvFBybgf5dths%2Fuploads%2FaJqM6IaWqZxK2hD7opY5%2Fmessages-templates.png?alt=media&#x26;token=4e1ec954-d154-418d-a9d7-77e177d1f1e4" alt=""><figcaption><p>Activez les messages et leurs modèles</p></figcaption></figure></div>

{% hint style="success" %}
Avant que l’utilisateur puisse gérer l’application, il sera nécessaire de valider l’invitation à rejoindre le compte WhatsApp. Une fois l’invitation acceptée, un délai peut être constaté avant de pouvoir lui attribuer des droits sur l’application.

![](https://782257568-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJFKLcURHvFBybgf5dths%2Fuploads%2F7jDWxCx3wHOIq7bnbjPO%2Fvalider-invitation.png?alt=media\&token=9bc9824d-9863-4457-a75e-4e480daa4541)
{% endhint %}

* Validez votre saisie pour enregistrer le compte et envoyer l’invitation.

### Assigner l’application

* Lorsque l’invitation aura été acceptée, rendez-vous dans votre compte Meta puis **Comptes** > **Applications**
* Sélectionnez l’application précédemment créée, puis **Assigner un utilisateur**
* Cochez l’utilisateur souhaité
* Assignez les autorisations nécessaires

<div align="left"><figure><img src="https://782257568-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJFKLcURHvFBybgf5dths%2Fuploads%2FirGAAl3LLy8xTxednncU%2Fajouter-utilisateur.png?alt=media&#x26;token=5685e558-f873-4a6a-9738-b4c38ff9e9f5" alt=""><figcaption><p>Assigner un utilisateur à l'application</p></figcaption></figure></div>

* Cliquez sur **Assigner**

### Création d’un compte **Utilisateur système**

Le compte utilisateur système va nous permettre de générer un token qui devra être renseigné dans GLPI afin de pouvoir valider la configuration entre WhatsApp et GLPI.

* Depuis **Utilisateurs** > **Utilisateurs système,** cliquez sur **+ Ajouter**
* Entrez un nom pour le compte
* Validez votre saisi

Une fois le compte créer :

* Cliquez sur le menu à droite, puis **Assigner actifs**

<div align="left"><figure><img src="https://782257568-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJFKLcURHvFBybgf5dths%2Fuploads%2FuYv8Wfj8yNO2DTalN1lj%2Fassigner-actif.png?alt=media&#x26;token=91c521d8-8129-4661-ba19-6ebfcc84bc2e" alt=""><figcaption><p>Assigner un actif</p></figcaption></figure></div>

* Sélectionnez l’application créé puis **Contrôle total**
* Depuis Compte WhatsApp (**`https://business.facebook.com/latest/settings/system_users`**), sélectionnez **`messages`** et **`messages_templates`**
* Cliquez sur **Assigner actifs**

<div align="left"><figure><img src="https://782257568-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJFKLcURHvFBybgf5dths%2Fuploads%2FyylcbCh9CyYXbFKF6vo1%2Fvalider-actif.png?alt=media&#x26;token=0dad846d-5c3b-4d56-b366-211b3efeb14b" alt=""><figcaption><p>Valider et assigner les actifs</p></figcaption></figure></div>

### Génération du token

* Sur cette même page, cliquez sur **Générer un token**

<figure><img src="https://782257568-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJFKLcURHvFBybgf5dths%2Fuploads%2FoR9K2t1uyPmtoSMWZIG7%2Fgenerer-token.png?alt=media&#x26;token=7fc4fd95-b49a-44bc-829f-997c1c5c7700" alt=""><figcaption><p>Génération d'un token</p></figcaption></figure>

* Sélectionnez l’application désirée
* Sélectionnez la durée d’expiration du token (60 jours ou **jamais**)

{% hint style="danger" %}
**Si vous sélectionnez 60 jours, il faudra penser à renouveler votre token pour éviter une coupure de service de votre application**
{% endhint %}

* Assigner les 3 permissions suivantes :
  * **`whatsapp_business_manage_events`**
  * **`whatsapp_business_management`**
  * **`whatsapp_business_messaging`**

<div align="left"><figure><img src="https://782257568-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJFKLcURHvFBybgf5dths%2Fuploads%2Fr2fMvU4Q177ye1OxZv5j%2Fpermissions-token.png?alt=media&#x26;token=a3d9c0bf-faee-4da4-953c-4ecf99c4e8fc" alt=""><figcaption><p>Permlissions du token</p></figcaption></figure></div>

* Puis cliquez sur **Générer le token**

{% hint style="success" %}
Conserver ce token qui doit être renseigner dans GLPI
{% endhint %}

***

## Configuration de GLPI

* Depuis votre instance GLPI, rendez-vous dans **`Configuration`** > **`Générale`** > **`Whatsapp`**
* Dans **WhatsApp Business Account ID**, indiquez l’Id du compte WhatsApp (disponible dans votre compte [Meta](https://business.facebook.com/) puis **Comptes** > **Comptes WhatsApp** **`https://business.facebook.com/latest/settings/whatsapp_account`**

<div align="left"><figure><img src="https://782257568-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJFKLcURHvFBybgf5dths%2Fuploads%2FGR6Zx0zob21s6uMdIBQL%2FId-application.png?alt=media&#x26;token=cc1c4fb4-02df-49e7-9978-be4419fa6ddc" alt=""><figcaption><p>Récupérer l'ID d'application Méta</p></figcaption></figure></div>

* Dans **Token d’accès**, indiquez le token généré précédemment
* Sauvegardez votre saisie.

Si tout est ok, un message vous informant que votre configuration est valide apparaîtra

<figure><img src="https://782257568-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJFKLcURHvFBybgf5dths%2Fuploads%2FHjg3r8XATQDyldXQjSUG%2Fcoller-id-application.png?alt=media&#x26;token=a512cf57-f11a-4e49-af56-fcb43b7ec1df" alt=""><figcaption></figcaption></figure>

***

## Configuration des templates de notifications

Vous n’avez rien de particulier à faire côté Template. Ceux-ci sont générés directement par le plugin et sont visibles depuis la partie message templates de la configuration du plugin Whats app sur GLPI.

<figure><img src="https://782257568-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJFKLcURHvFBybgf5dths%2Fuploads%2Fsm8V5cz6620V1p8VliHl%2Ftemplate-GLPI.png?alt=media&#x26;token=53b2f142-cb7a-423a-91da-e4fa7995593f" alt=""><figcaption><p>Modèles de message GLPI</p></figcaption></figure>

Le bouton **`refresh`** permet de resynchroniser les templates avec WhatsApp dans le cas ou ceux-ci ne seraient pas **APPROVED** (ou lors de l'ajout de nouvelle langues par le plugin).

***

## Avant d’activer votre application

### Politique de confidentialité et logo

Avant d’activer votre application, il vous faudra indiquez une URL pour la politique de confidentialité.

* Depuis **`Configuration d’application`** > **`Basique`** indiquez l’URL appropriée
* Ajouter également un **logo** (celui qui apparaîtra de façon publique sur le contact WhatsApp)

<figure><img src="https://782257568-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJFKLcURHvFBybgf5dths%2Fuploads%2FUT6GLtDLQAGCavDGseMp%2Favant-publication.png?alt=media&#x26;token=e5159b0c-4809-46ea-8485-f8a6298f9b96" alt=""><figcaption><p>Informations obligatoire avant publication</p></figcaption></figure>

***

### Moyen de paiement

Un moyen de paiement doit être activé auquel cas les message templates ne pourrons être envoyé

* Depuis votre [compte Meta](https://business.facebook.com/), rendez vous **`Accounts`** > **`WhatsApp accounts`**
* Sélectionnez le compte souhaité
* Cliquez sur **Payment settings** et suivez les étapes

<figure><img src="https://782257568-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJFKLcURHvFBybgf5dths%2Fuploads%2FHDJIPe3UcKbDb3FfGFFQ%2FMoyen-paiement.png?alt=media&#x26;token=56d2d916-eee4-4f59-afdc-fb288d503d28" alt=""><figcaption></figcaption></figure>

***

## Activer l’application

Vous pouvez maintenant activer votre application

<div align="left"><figure><img src="https://782257568-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJFKLcURHvFBybgf5dths%2Fuploads%2FdeB15EEEE6aIkj50zZ4i%2Fpublication.png?alt=media&#x26;token=4ee4d5f7-6109-4284-98f8-31f9545c743f" alt=""><figcaption><p>Publier votre application</p></figcaption></figure></div>

***

## Configuration du ticket

### Accès anonyme

Vous pouvez autorisé ou non l’accès aux anonymes (utilisateurs non présents dans la base de données)

<figure><img src="https://782257568-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJFKLcURHvFBybgf5dths%2Fuploads%2FtESwFgS6OvLBMpX0zSeR%2Facces-anonyme.png?alt=media&#x26;token=988517e9-e543-4c2d-8444-210b3a0b728c" alt=""><figcaption><p>Accès anonyme</p></figcaption></figure>

### Modèle de titre de ticket

Vous pouvez ajouter des variables et/ou du texte qui seront retranscrits dans le titre du ticket.

<div align="left"><figure><img src="https://782257568-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJFKLcURHvFBybgf5dths%2Fuploads%2F5s64VK2ImuVy0dswl16C%2Fmod%C3%A8le-titre.png?alt=media&#x26;token=986e2b78-65f1-4cb3-8386-d4b31fe576ef" alt=""><figcaption><p>Exemple de modèle de titre de ticket</p></figcaption></figure></div>

### Règle métiers

Afin de personnaliser le comportement du plugin, vous pouvez ajouter des règles métiers. Le moteur fonctionne comme le moteur de règles de GLPI.

La gestion des règles se trouvent dans **`Administration`** > **`Règles`** > **`WhatsApp - Règles des tickets`**

<figure><img src="https://782257568-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJFKLcURHvFBybgf5dths%2Fuploads%2FXU68NHWYshkucm1IPA8L%2Fregles-metiers.png?alt=media&#x26;token=b511916e-c4cf-4e7c-a921-31d0e0ed1c37" alt=""><figcaption></figcaption></figure>

Les critères concernent soit les utilisateurs anonymes soit les numéro WhatsApp et auront pour action, par exemple, l’envoie de message suite réception d’un ticket, la mise à jour de l’entité, de la catégorie, de l’urgence, etc.

***

## Limitations actuelles

* Seules les mises à jour des suivis de ticket et les solutions sont envoyés à l’utilisateur. Les tâches et les enquêtes de satisfaction ne sont pas compatibles.