Intégration Zendesk

Attachez les photos des clients directement aux tickets de support.

Aperçu

Connectez Visiono à Zendesk pour attacher automatiquement les soumissions de photos aux tickets de support client. Quand les clients soumettent des photos, elles peuvent être liées à des tickets existants ou en déclencher de nouveaux.

Prérequis

• Compte Visiono avec accès API
• Compte Zendesk (tout forfait)
• Clé API de Visiono
• Jeton API Zendesk

Méthodes d'intégration

Méthode	Idéale pour
Zapier	Configuration rapide, pas de code
Make	Workflows complexes
API directe	Intégration personnalisée

Configuration Zapier

1. Créer un Zap

1. Connectez-vous à Zapier
2. Créez un nouveau Zap
3. Déclencheur : Webhooks by Zapier → Catch Hook
4. Copiez l'URL du webhook

2. Configurer Visiono

1. Ajoutez l'URL du webhook dans les paramètres Visiono
2. Sélectionnez les événements : submission.created
3. Enregistrez la configuration

3. Ajouter l'action Zendesk

Choisissez parmi les actions :

Action	Cas d'usage
Create Ticket	Nouveau ticket avec photos
Update Ticket	Ajouter photos à un existant
Add Comment	Attacher comme commentaire de ticket

4. Mapper les champs

Créer un ticket :

Subject : Photos de {{submitter_name}}
Description : {{photos_count}} photos soumises
Tags : visiono, photos
Requester Email : {{submitter_email}}

Mettre à jour un ticket :

Ticket ID : {{unique_field}}
Comment : Nouvelles photos soumises : {{photo_urls}}
Public : false

Exemples de workflows

Nouveau ticket avec photos

Quand les photos arrivent, créez un ticket de support :

1. Webhook reçoit la soumission
2. Zendesk crée le ticket
3. Boucle sur les photos
4. Zendesk ajoute chaque photo comme pièce jointe

Mettre à jour un ticket existant

Liez les photos au ticket en utilisant un identifiant :

1. Le client inclut l'ID du ticket dans le champ unique
2. Webhook reçoit la soumission
3. Zendesk recherche le ticket
4. Zendesk ajoute une note interne avec les photos

Escalade déclenchée par photo

Escaladez selon le contenu des photos :

1. Webhook reçoit la soumission
2. Filtre vérifie le tag "dommages"
3. Zendesk met à jour la priorité du ticket
4. Zendesk assigne à l'équipe spécialiste

Mapping de données

Visiono → Zendesk

Champ Visiono	Champ Zendesk
submitter_name	Nom du demandeur
submitter_email	E-mail du demandeur
unique_field	ID ticket ou ID externe
photos[].url	URLs des pièces jointes
smart_link.name	Sujet du ticket
submitted_at	Timestamp du commentaire

Champs de ticket

Mappez les champs de ticket personnalisés :

custom_field_12345 : {{smart_link_slug}}
custom_field_67890 : {{photos_count}}

Pièces jointes photo

Comme pièces jointes de ticket

Ajoutez les photos directement aux tickets :

1. Téléchargez la photo depuis l'URL Visiono
2. Uploadez vers l'API d'attachement Zendesk
3. Référencez dans le ticket/commentaire

Comme liens dans les commentaires

Incluez les URLs des photos dans les commentaires :

Le client a soumis {{photos_count}} photos :

{{#each photos}}
- {{slot_name}} : {{url}}
{{/each}}

Voir tout : {{dashboard_url}}

Comme liens externes

Lien vers le tableau de bord Visiono :

Des photos ont été soumises.
Voir dans Visiono : {{submission_url}}

Workflows avancés

Mises à jour multi-tickets

Mettez à jour plusieurs tickets depuis une soumission :

1. Parsez les IDs de ticket depuis le champ unique
2. Bouclez sur chaque ID
3. Mettez à jour chaque ticket avec les photos

Création automatique de ticket

Créez des tickets pour des Liens permanents spécifiques :

1. Configurez le webhook pour un Lien permanent spécifique
2. Mappez les données de soumission aux champs du ticket
3. Définissez l'assigné et la priorité par défaut

Routage par qualité photo

Routez selon le nombre de photos :

IF photos_count < 3 :
  → Demander plus de photos
ELSE IF photos_count >= 3 :
  → Traiter normalement

Dépannage

Les photos ne s'attachent pas

1. Vérifiez les permissions de l'API Zendesk
2. Vérifiez que les URLs de fichiers sont accessibles
3. Confirmez les limites de taille des pièces jointes

Ticket non trouvé

1. Vérifiez le format de l'ID du ticket
2. Vérifiez le statut du ticket (pas fermé)
3. Assurez-vous que l'API a accès au ticket

Tickets en double

1. Ajoutez un filtre de déduplication
2. Recherchez avant de créer
3. Utilisez des identifiants uniques

Bonnes pratiques

Organisation des tickets

• Utilisez des tags cohérents : visiono, photo-submission
• Définissez les priorités appropriées
• Assignez au bon groupe

Gestion des photos

• Liez vers le tableau de bord Visiono
• Ne dupliquez pas les gros fichiers
• Incluez les métadonnées des photos

Expérience client

• Envoyez une confirmation après soumission
• Mettez à jour automatiquement le statut du ticket
• Notifiez quand les photos sont examinées

Considérations de sécurité

• Utilisez des notes internes pour les photos sensibles
• Restreignez l'accès aux photos aux agents
• Auditez les pièces jointes photo

Ressources connexes

• Webhooks - Configuration des événements
• Intégration Zapier - Plateforme d'automatisation
• Intégration Make - Workflows visuels
• Référence API - API directe