Connecter vos outils (Webhooks)

ArchiCollab peut envoyer automatiquement des notifications vers tes outils externes quand des événements se produisent sur tes projets.

À quoi ça sert ?

• Recevoir une notification Slack quand une annotation est créée
• Créer automatiquement une tâche dans ClickUp ou Todoist quand un statut change
• Synchroniser les nouveaux documents avec ton outil de gestion de projet
• Envoyer un email personnalisé quand une version est finalisée

Configurer un webhook

1. Va dans Paramètres → onglet Intégrations
2. Entre l'URL fournie par ton outil (Zapier, Make, etc.)
3. Coche les événements que tu veux recevoir
4. Clique sur Sauvegarder
5. Clique sur Tester pour vérifier la connexion

Connecter avec Zapier

Étapes

1. Dans Zapier, crée un nouveau Zap
2. Pour le trigger, cherche "Webhooks by Zapier" → "Catch Hook"
3. Zapier te donne une URL — copie-la
4. Dans ArchiCollab, va dans Paramètres → Intégrations
5. Colle l'URL dans le champ URL du webhook
6. Coche les événements souhaités et sauvegarde
7. Retourne dans Zapier et clique sur "Test trigger"
8. Clique sur Tester dans ArchiCollab pour envoyer un événement test
9. Zapier devrait recevoir l'événement test
10. Configure ton action (envoyer un message Slack, créer une tâche, etc.)

Filtrer par type d'événement dans Zapier

Le champ event du payload te permet de filtrer. Par exemple :

• Pour ne traiter que les changements de statut : ajoute un Filter avec event → equals → annotation.status_changed

Connecter avec Make (ex Integromat)

Étapes

1. Dans Make, crée un nouveau Scénario
2. Ajoute un module Webhooks → Custom webhook
3. Make te donne une URL — copie-la
4. Dans ArchiCollab, va dans Paramètres → Intégrations
5. Colle l'URL et configure les événements
6. Clique sur Tester dans ArchiCollab
7. Retourne dans Make et clique sur "Run once" pour capturer le test
8. Make détecte automatiquement la structure du payload
9. Ajoute tes modules d'action (Slack, Google Sheets, Trello, etc.)

Liste des événements

Exemple de payload

{
  "event": "annotation.status_changed",
  "timestamp": "2026-03-27T14:30:00.000Z",
  "webhookId": "abc123",
  "organization": {
    "id": "org_xxx",
    "name": "Studio Dupont"
  },
  "project": {
    "id": "proj_xxx",
    "name": "Villa Dupont"
  },
  "actor": {
    "name": "Jean Dupont",
    "email": "jean@studio-dupont.fr"
  },
  "data": {
    "annotationNumber": 42,
    "oldStatus": "PENDING",
    "newStatus": "RESOLVED",
    "documentName": "Plans RDC v3",
    "pageNumber": 3
  }
}

Sécurité

Chaque webhook est signé avec le standard Standard Webhooks. Les headers incluent :

• webhook-id — identifiant unique du message
• webhook-timestamp — horodatage (protection anti-replay)
• webhook-signature — signature HMAC-SHA256

Pour vérifier la signature, tu peux utiliser l'outil en ligne : standardwebhooks.com/verify

Limitations

• Pas de retry : si ton endpoint ne répond pas, l'événement est perdu. Zapier et Make gèrent leurs propres retries côté réception.
• 1 webhook par utilisateur : tu peux configurer une seule URL.
• Timeout de 10 secondes : si ton endpoint met plus de 10 secondes à répondre, la livraison est abandonnée.
• Projets accessibles uniquement : tu ne reçois que les événements des projets dont tu es membre.

Voir aussi

• Statuts des annotations
• Créer une annotation