Webhooks sortants

Les webhooks te permettent de connecter Fotostudio à des outils externes comme Make, Zapier, n8n ou ton propre backend. À chaque événement important (nouveau contact, facture payée, contrat signé...), Fotostudio envoie automatiquement les données vers l'URL de ton choix.

Configurer un webhook

Les webhooks sont un module à activer, disponible dans toutes les formules. Va dans Modules > Tous les modules, catégorie Avancé, et active le module Webhooks. Si tu avais déjà créé un webhook, le module est déjà activé pour toi.

Rends-toi ensuite dans Modules > Webhooks sortants et clique sur Ajouter un webhook.

Remplis les champs suivants :

Une clé secrète HMAC est générée automatiquement à la création. Copie-la immédiatement : elle ne sera plus affichée de cette façon ensuite. Elle sert à vérifier que les appels viennent bien de Fotostudio.

Événements disponibles

Format des données envoyées

Chaque appel est un POST en JSON avec la structure suivante :

{
  "event": "invoice.paid",
  "timestamp": "2026-06-12T10:30:00Z",
  "data": {
    ...
  }
}

En-têtes HTTP

Vérifier la signature

La signature dans X-FS-Signature est calculée ainsi :

HMAC-SHA256(secret, body_json)

En Node.js par exemple :

const crypto = require('crypto')
const sig = 'sha256=' + crypto.createHmac('sha256', SECRET).update(rawBody).digest('hex')
if (sig !== req.headers['x-fs-signature']) throw new Error('Signature invalide')

Détail des données par événement

contact.created / contact.updated

{
  "id": 123,
  "firstname": "Marie",
  "lastname": "Dupont",
  "email": "marie@example.com",
  "phone": "+33 6 12 34 56 78",
  "company": "Studio Photo",
  "street": "12 rue de la Paix",
  "zipcode": "75001",
  "city": "Paris",
  "country": "France",
  "created_at": "2026-01-15T09:00:00Z",
  "url": "https://www.fotostudio.io/app/contacts/123"
}

project.created / project.status_changed / project.confirmed

{
  "id": 456,
  "name": "Mariage Dupont",
  "start_time": "2026-07-20T14:00:00Z",
  "end_time": "2026-07-20T18:00:00Z",
  "project_type": "Mariage",
  "status": "Confirmé",
  "validated": true,
  "location": "Château de Versailles",
  "contact_id": 123,
  "created_at": "2026-01-15T09:00:00Z",
  "url": "https://www.fotostudio.io/app/projects/456"
}

invoice.created / invoice.paid

{
  "id": 789,
  "numero": "F2026-042",
  "title": "Mariage Dupont",
  "invoice_date": "2026-06-01",
  "total_price": 1500.00,
  "amount_to_pay": 750.00,
  "paid": false,
  "draft": false,
  "contact_id": 123,
  "project_id": 456,
  "created_at": "2026-06-01T10:00:00Z",
  "url": "https://www.fotostudio.io/app/invoices/789"
}

amount_to_pay est le solde restant à payer (total - paiements déjà reçus).

payment.created

{
  "id": 101,
  "amount": 750.00,
  "payment_date": "2026-06-10",
  "payment_type": "Virement",
  "invoice_id": 789,
  "contact_id": 123,
  "created_at": "2026-06-10T14:00:00Z"
}

estimate.accepted / estimate.refused

{
  "id": 202,
  "numero": "D2026-018",
  "title": "Mariage Dupont",
  "total_price": 1500.00,
  "accepted": true,
  "refused": false,
  "accepted_at": "2026-06-05T16:00:00Z",
  "contact_id": 123,
  "project_id": 456,
  "created_at": "2026-05-20T09:00:00Z",
  "url": "https://www.fotostudio.io/app/estimates/202"
}

contract.signed

{
  "id": 303,
  "title": "Contrat Mariage Dupont",
  "signed_at": "2026-06-08T11:30:00Z",
  "project_id": 456,
  "contact_id": 123,
  "created_at": "2026-05-25T10:00:00Z",
  "url": "https://www.fotostudio.io/app/contracts/303"
}

Historique des livraisons

Dans la liste des webhooks, ouvre le menu Actions d'un webhook puis Dernières livraisons (50). Tu y vois l'historique des appels avec :

• la date et l'heure
• l'événement déclenché
• le statut (Livré, Échec ou En attente)
• le nombre de tentatives
• le code HTTP de réponse
• le message d'erreur en cas d'échec

En cas d'échec, Fotostudio réessaie automatiquement jusqu'à 3 fois avec un délai exponentiel. Tu peux aussi relancer manuellement un appel avec le bouton Réessayer.

Utiliser avec Make

1. Dans Make, crée un nouveau scénario et ajoute un module Webhooks → Custom webhook
2. Copie l'URL générée par Make
3. Dans Fotostudio, crée un webhook avec cette URL et sélectionne les événements souhaités
4. Déclenche un événement test depuis Fotostudio (crée un contact, par exemple)
5. Make reçoit les données. Tu peux ensuite construire ton automatisation

Utiliser avec Zapier

1. Dans Zapier, crée un nouveau Zap et choisis Webhooks by Zapier → Catch Hook comme déclencheur
2. Copie l'URL fournie par Zapier
3. Dans Fotostudio, crée un webhook avec cette URL
4. Déclenche un événement test. Zapier détecte automatiquement la structure des données
5. Configure ton action (Google Sheets, Notion, Slack...)

FAQ

Que se passe-t-il si mon serveur est indisponible ?
Fotostudio réessaie 3 fois avec un délai croissant. Après 3 tentatives, la livraison est marquée en échec mais reste dans l'historique. Tu peux la relancer manuellement.

Mon webhook doit-il répondre en moins de combien de temps ?
Ton endpoint doit répondre dans les 10 secondes. Au-delà, la requête est considérée comme en échec.

Puis-je avoir plusieurs webhooks ?
Oui, tu peux créer autant de webhooks que tu veux, chacun avec ses propres événements et son URL.

Comment désactiver temporairement un webhook ?
Dans la liste, ouvre le menu Actions du webhook et choisis Inactif (ou Actif pour le relancer) : il est mis en pause sans être supprimé.

Que se passe-t-il si je désactive le module Webhooks ?
Tes webhooks sont conservés, mais plus aucun appel n'est envoyé et l'entrée Webhooks sortants disparaît du menu. Réactive le module pour reprendre les envois.

Mis à jour le : 23/10/2026