Ce guide explique comment configurer un webhook pour être notifié lorsqu'un utilisateur termine une visite technique dans l'application Argile.

Prérequis

• Un endpoint HTTP/HTTPS accessible publiquement pour recevoir les notifications
• Authentification sur la plateforme Argile en tant que responsable d’une filiale (ou plus)

Configuration du webhook

1. Accéder à l'interface de gestion des webhooks

Connectez-vous à l'interface d'administration et naviguez vers la section de gestion des webhooks de votre filiale.

2. Créer un nouveau webhook

Cliquez sur "Ajouter un webhook" et remplissez les informations suivantes :

• Événement : sélectionnez TECHNICAL_VISIT_DONE dans la liste déroulante
• URL de callback : l'URL de votre endpoint qui recevra les notifications (ex: https://votre-domaine.com/api/webhooks/argile)
• Statut : Activé

3. Alternative : utiliser un tag

Si vous préférez utiliser un système de tags plutôt qu'un webhook direct :

1. Configurez un tag spécifique pour l'événement TECHNICAL_VISIT_DONE
2. Créez un webhook qui se déclenche sur l'ajout de ce tag au lead

Structure des données reçues

Lorsqu'une visite technique est terminée et que l'utilisateur clique sur le bouton de synchronisation, votre endpoint recevra une requête POST avec le payload suivant :

{
  "lead_id": "550e8400-e29b-41d4-a716-446655440000",
  "answer_id": "660e8400-e29b-41d4-a716-446655440001"
}

Description des champs