Connecter Zapier, Make, n8n et Pipedream

Réservez des interventions et réagissez aux événements depuis les outils d’automatisation que votre équipe utilise déjà — sans code, ou presque.

Des applications Crisphive officielles pour Zapier, Make, n8n et Pipedream sont en préparation. Elles utilisent toutes la même API publique décrite ici : tout ce qu’elles font, vous pouvez déjà le faire aujourd’hui avec les étapes HTTP et webhook génériques de chaque plateforme.

Ce que font les applications

Réserver et confirmer en un seul appel

Une automatisation ne peut généralement pas dérouler tout le flux créer → planifier → choisir un créneau → confirmer. book-and-confirm fait tout en une seule requête : il crée l’intervention, la dimensionne à partir de la durée par défaut du type d’intervention (ou du job_duration_minutes que vous envoyez) et la confirme à scheduled_at, Crisphive choisissant le technicien.

curl -X POST "https://api.crisphive.com/v1/job-requests/book-and-confirm" \
  -H "Authorization: Bearer chsk_test_4eC8xQ9mZ2pL7Ka0rT" \
  -H "Idempotency-Key: form-submission-4815" \
  -H "Content-Type: application/json" \
  -d '{"customer":{"full_name":"Lamar Bakery","phone":"+16135550142"},"address":{"line":"120 Bank St","city":"Ottawa","state":"ON","postal_code":"K1P 5N1","country":"CA"},"scheduled_at":"2026-10-06T10:00:00"}'

• scheduled_at est l’heure murale locale de l’entreprise, sans décalage de fuseau horaire.
• Envoyez un customer_id, ou un objet customer : un appelant qui existe déjà (même téléphone ou e-mail) est retrouvé, jamais dupliqué.
• job_type_id est facultatif. Sans lui, le type d’intervention par défaut de l’entreprise (“General”) est utilisé ; chaque type d’intervention que l’automatisation peut réserver devrait avoir une durée par défaut.
• Une entrée invalide est rejetée avec un 4xx normal et rien n’est créé.
• Une fois l’intervention créée, elle n’est jamais supprimée. Si aucun technicien ne peut la prendre à cet horaire, l’appel répond quand même 200 avec confirmed: false et un refusal (les mêmes error_code et data que renverrait l’étape de confirmation) ; l’intervention attend dans la file du coordinateur.

Déclencheurs : s’abonner avec un webhook

Un déclencheur est un webhook que la plateforme d’automatisation crée quand vous l’activez et supprime quand vous le désactivez (un « REST hook »). La liste des événements provient de GET /v1/webhooks/event-types, si bien que les nouveaux événements Crisphive apparaissent sans mise à jour de l’application.

Qui peut connecter quoi

• Activer un déclencheur nécessite l’accès Developer (developer_manage_api_keys). Par défaut, seul le Propriétaire de l’entreprise le détient ; un Propriétaire peut accorder le module Developer à un autre groupe dans la matrice des rôles.
• Un déclencheur ne peut s’abonner qu’aux événements que le compte connecté peut lire : customer.* nécessite customers_view, technician.* nécessite team_view, job_request.* nécessite job_view. Tout le reste est refusé avec 403 WEBHOOK_EVENT_NOT_PERMITTED.
• La réservation nécessite job_create et job_manage.
• Le Propriétaire et les Administrateurs reçoivent un e-mail la première fois qu’une application ou une clé API s’abonne aux événements de l’entreprise.
• Un abonnement s’arrête de lui-même quand la clé API qui l’a créé est révoquée, quand l’application est déconnectée, ou quand le membre qui a connecté l’application part ou est suspendu.

Authentification

n8n et Pipedream se connectent avec une clé API (chsk_test_… pour essayer sur des données de bac à sable, chsk_live_… pour le travail réel). Zapier et Make se connectent avec OAuth : la personne qui connecte se connecte à Crisphive et approuve l’application, et la connexion ne peut ensuite faire que ce que cette personne est autorisée à faire dans le tableau de bord.