Freescout¶
Catégorie : Ticketing | Version : 1.0.0 | Connexion : directe ou via Proxy
À quoi sert ce module ?¶
Le module Freescout connecte votre helpdesk Freescout à Tevyra. Il synchronise vos tickets, mailboxes, agents et clients. Vous pouvez aussi créer, assigner et gérer des tickets directement depuis Tevyra.
Avant de commencer¶
Pour configurer ce module, vous aurez besoin de :
- L'URL de votre instance Freescout (HTTPS recommandé)
- Une clé API Freescout (voir guide ci-dessous)
Configuration¶
Paramètres requis¶
| Paramètre | Type | Description |
|---|---|---|
url | url | URL de l'instance Freescout |
api_key | secret | Clé API Freescout (Manage > API Keys) |
Paramètres optionnels¶
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
verify_ssl | boolean | True | Vérifie les certificats SSL |
sync_closed_tickets | boolean | False | Synchronise aussi les tickets fermés |
sync_days_back | integer | 30 | Nombre de jours de tickets à synchroniser |
Exemple de configuration¶
{
"url": "https://support.company.com",
"api_key": "votre-cle-api-freescout",
"verify_ssl": true,
"sync_closed_tickets": false,
"sync_days_back": 30
}
Obtenir la clé API¶
- Connectez-vous à votre instance Freescout en tant qu'administrateur
- Allez dans Manage > API Keys
- Cliquez sur New API Key
- Copiez la clé générée et collez-la dans la configuration du module
Données collectées¶
Une fois activé, le module synchronise automatiquement les données suivantes :
| Type d'asset | Description |
|---|---|
freescout_ticket | Tickets de support |
freescout_mailbox | Boîtes mail de support |
freescout_user | Agents / utilisateurs Freescout |
freescout_customer | Clients / contacts |
Intervalle de synchronisation par defaut : 5 minutes
Actions disponibles¶
Depuis l'interface Tevyra, vous pouvez executer les actions suivantes :
| Action | Description |
|---|---|
freescout.create_ticket | Crée un nouveau ticket de support |
freescout.update_ticket | Met à jour un ticket existant |
freescout.assign_ticket | Assigne un ticket à un agent |
freescout.close_ticket | Ferme un ticket |
freescout.add_note | Ajoute une note interne à un ticket |
freescout.add_reply | Envoie une réponse au client |
Indicateurs¶
Le tableau de bord affiche les indicateurs suivants :
| Indicateur | Description |
|---|---|
tickets_open | Nombre de tickets ouverts |
tickets_pending | Nombre de tickets en attente |
tickets_closed_today | Tickets fermes aujourd'hui |
avg_response_time | Temps de reponse moyen |