Intégration Zapier
Connectez Visiono à plus de 5 000 apps avec la plateforme d'automatisation no-code de Zapier.
Aperçu
Zapier vous permet de créer des workflows automatisés (Zaps) qui se déclenchent quand des photos sont soumises à Visiono. Connectez-vous aux CRM, outils de gestion de projet, plateformes de communication, et plus encore.
Prérequis
- Compte Visiono avec accès API
- Compte Zapier (gratuit ou payant)
- Clé API de Visiono
Étapes de configuration
1. Créer un nouveau Zap
- Connectez-vous à Zapier
- Cliquez sur Create Zap
- Recherchez Webhooks by Zapier
- Sélectionnez Catch Hook comme déclencheur
2. Configurer le Webhook
- Zapier génère une URL webhook unique
- Copiez cette URL (ressemble à
https://hooks.zapier.com/hooks/catch/...) - Gardez l'onglet Zapier ouvert
3. Ajouter le Webhook à Visiono
- Allez dans Paramètres de l'espace de travail → Webhooks
- Cliquez sur Ajouter un Webhook
- Collez l'URL webhook Zapier
- Sélectionnez les événements à déclencher :
photo_request.submitted- Quand toutes les photos sont soumisesphoto_submission.created- Quand une nouvelle soumission arrive
- Enregistrez le webhook
4. Tester la connexion
- Dans Zapier, cliquez sur Test trigger
- Soumettez une photo de test dans Visiono
- Zapier devrait recevoir les données du webhook
- Cliquez sur Continue une fois les données reçues
5. Ajouter des actions
Ajoutez maintenant ce qui se passe quand les photos arrivent :
| Actions populaires | Cas d'usage |
|---|---|
| Gmail | Envoyer un e-mail avec les liens des photos |
| Slack | Notifier le canal de l'équipe |
| Google Sheets | Enregistrer les soumissions dans un tableur |
| Trello | Créer une carte avec les photos |
| Salesforce | Mettre à jour l'enregistrement du contact |
| HubSpot | Ajouter à la timeline du contact |
Exemples de Zaps
Photos vers Google Sheets
Enregistrez chaque soumission dans un tableur :
- Déclencheur : Webhooks by Zapier (Catch Hook)
- Action : Google Sheets → Create Spreadsheet Row
Mappez les champs :
| Colonne du tableur | Données du Webhook |
|---|---|
| Date | {{submitted_at}} |
| Lien permanent | {{smart_link_slug}} |
| Nombre de photos | {{photos_count}} |
| URL première photo | {{photos__1__url}} |
Notifier Slack lors d'une soumission
Envoyez une notification à l'équipe :
- Déclencheur : Webhooks by Zapier
- Action : Slack → Send Channel Message
Modèle de message :
📸 Nouvelles photos reçues !
Lien permanent : {{smart_link_name}}
Photos : {{photos_count}}
Voir : {{dashboard_url}}Créer une carte Trello
Ajoutez la soumission au tableau de projet :
- Déclencheur : Webhooks by Zapier
- Action : Trello → Create Card
Paramètres de la carte :
- Nom :
Photos de {{submitter_name}} - Description : URLs des photos et métadonnées
- Étiquettes : Basées sur les tags
Payload du Webhook
Zapier reçoit cette structure de données :
json
{
"event": "submission.created",
"timestamp": "2024-01-15T10:30:00Z",
"data": {
"submission_id": "sub_abc123",
"smart_link": {
"id": "pl_xyz789",
"slug": "inspection-vehicule",
"name": "Inspection Véhicule"
},
"photos": [
{
"id": "photo_001",
"url": "https://...",
"slot": 1,
"slot_name": "Vue de face"
}
],
"metadata": {
"unique_field": "ABC-123",
"full_name": "Jean Dupont",
"submitted_at": "2024-01-15T10:30:00Z"
}
}
}Zaps multi-étapes
Enchaînez plusieurs actions :
- Étape 1 : Recevoir le webhook
- Étape 2 : Télécharger les photos (Formatter)
- Étape 3 : Uploader vers Google Drive
- Étape 4 : Envoyer un e-mail avec les liens Drive
- Étape 5 : Mettre à jour l'enregistrement CRM
Filtrage
Ajoutez des filtres pour exécuter les actions conditionnellement :
| Filtre | Condition | Exemple |
|---|---|---|
| Nombre de photos | Supérieur à | Seulement si 5+ photos |
| Lien permanent | Contient | Seulement demandes "dommages" |
| Tag | Égal à | Seulement tagué "urgent" |
Dépannage
Le Webhook ne reçoit pas de données
- Vérifiez que l'URL du webhook est correcte dans Visiono
- Vérifiez que le webhook est activé (statut vert)
- Testez avec une nouvelle soumission
- Vérifiez l'historique des tâches Zapier pour les erreurs
Champs de données manquants
- Assurez-vous d'avoir testé avec des données réelles
- Re-testez le déclencheur dans Zapier
- Vérifiez que le mapping des champs utilise les bons chemins
Le Zap ne s'exécute pas
- Vérifiez que le Zap est activé (ON)
- Vérifiez les limites du forfait Zapier
- Consultez l'historique des tâches pour les erreurs
- Assurez-vous que les événements webhook correspondent au déclencheur
Bonnes pratiques
Convention de nommage
Nommez les Zaps de manière descriptive :
- ✓
Visiono → Slack : Nouvelles photos de dommages - ✓
Photos véhicule → Google Drive + Email - ✗
Mon Zap 1
Gestion des erreurs
- Activez les notifications d'erreur Zapier
- Ajoutez des étapes Formatter pour le nettoyage des données
- Utilisez les Paths pour la logique conditionnelle
- Testez avec des cas limites
Performance
- Utilisez les Filtres pour réduire les exécutions inutiles
- Regroupez les actions quand c'est possible
- Tenez compte des limites de tâches du forfait Zapier
Ressources connexes
- Webhooks - Configuration des événements
- Référence API - Accès direct à l'API
- Intégration Make - Automatisation alternative
- Intégration n8n - Option auto-hébergée
