de
Integrationen›Zapier, Make, n8n und Pipedream verbinden

Zapier, Make, n8n und Pipedream verbinden

Buchen Sie Jobs und reagieren Sie auf Ereignisse aus den Automatisierungstools, die Ihr Team bereits nutzt — ganz ohne oder mit sehr wenig Code.

Offizielle Crisphive-Apps für Zapier, Make, n8n und Pipedream sind in Arbeit. Sie nutzen alle dieselbe hier beschriebene öffentliche API — alles, was sie tun, können Sie also schon heute mit den generischen HTTP- und Webhook-Schritten der jeweiligen Plattform umsetzen.

Was die Apps können

ArtSchrittCrisphive-API
AktionJob buchen und bestätigenPOST /v1/job-requests/book-and-confirm
SucheKunden per Telefonnummer findenGET /v1/customers?phone=+16135550142
AktionKunden anlegenPOST /v1/customers
AktionJob abrufenGET /v1/job-requests/{id}
TriggerNeues Ereignis (Job abgeschlossen, Kunde angelegt, …)POST /v1/webhooks beim Aktivieren, DELETE /v1/webhooks/{id} beim Deaktivieren

Buchen und bestätigen in einem Aufruf

Eine Automatisierung kann den vollständigen Ablauf Anlegen → Einplanen → Zeitfenster wählen → Bestätigen meist nicht durchlaufen. book-and-confirm erledigt alles in einer Anfrage: Es legt den Job an, bemisst ihn nach der Standarddauer des Job-Typs (oder nach den von Ihnen gesendeten job_duration_minutes) und bestätigt ihn zu scheduled_at, wobei Crisphive den Techniker auswählt.

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 ist die lokale Uhrzeit des Unternehmens, ohne Zeitzonen-Offset.
  • Senden Sie customer_id oder ein customer-Objekt: Ein bereits vorhandener Anrufer (gleiche Telefonnummer oder E-Mail) wird zugeordnet, nie doppelt angelegt.
  • job_type_id ist optional. Ohne ihn wird der Standard-Job-Typ des Unternehmens („General“) verwendet; jeder Job-Typ, den die Automatisierung buchen darf, sollte eine Standarddauer haben.
  • Ungültige Eingaben werden mit einem normalen 4xx abgelehnt, und es wird nichts angelegt.
  • Sobald der Job existiert, wird er nie verworfen. Kann zu diesem Zeitpunkt kein Techniker ihn übernehmen, antwortet der Aufruf trotzdem mit 200, confirmed: false und einer refusal (mit demselben error_code und denselben data, die der Bestätigungsschritt liefern würde); der Job wartet in der Warteschlange des Disponenten.
Senden Sie immer einen Idempotency-Key, der aus dem auslösenden Datensatz abgeleitet ist (eine Formular-Übermittlungs-ID, eine Zeilen-ID). Eine Wiederholung mit demselben Schlüssel liefert die erste Antwort erneut; ein neuer Schlüssel bucht einen zweiten Job.

Trigger: mit einem Webhook abonnieren

Ein Trigger ist ein Webhook, den die Automatisierungsplattform anlegt, wenn Sie ihn einschalten, und löscht, wenn Sie ihn ausschalten (ein „REST Hook“). Die Liste der Ereignisse stammt aus GET /v1/webhooks/event-types, sodass neue Crisphive-Ereignisse ohne App-Update erscheinen.

1
Abonnieren

Rufen Sie POST /v1/webhooks mit der Empfangs-URL der Plattform, den gewünschten event_types und expires_in_days: 365 auf, damit der Trigger nicht nach den standardmäßigen 30 Tagen stoppt. Speichern Sie das secret aus der Antwort — es wird nur einmal angezeigt.

2
Den Ping beantworten

Crisphive sendet sofort ein signiertes ping-Ereignis. Antworten Sie mit 2xx, und das Abonnement ist aktiv. Starten Sie den Workflow niemals für einen ping.

3
Jede Zustellung verifizieren

Prüfen Sie den Crisphive-Signature-Header gegen das Secret, bevor Sie der Nutzlast vertrauen — den genauen Algorithmus finden Sie unter Webhooks.

4
Abonnement beenden

Rufen Sie DELETE /v1/webhooks/{id} auf, wenn der Trigger ausgeschaltet wird. Das gibt den Platz frei — ein Unternehmen kann höchstens 25 aktive Endpunkte pro Umgebung haben.

Wer was verbinden darf

  • Das Einschalten eines Triggers erfordert Developer-Zugriff (developer_manage_api_keys). Standardmäßig hat ihn nur der Inhaber des Unternehmens; ein Inhaber kann das Developer-Modul in der Rollenmatrix einer anderen Gruppe gewähren.
  • Ein Trigger kann nur Ereignisse abonnieren, die das verbundene Konto lesen darf: customer.* erfordert customers_view, technician.* erfordert team_view, job_request.* erfordert job_view. Alles andere wird mit 403 WEBHOOK_EVENT_NOT_PERMITTED abgelehnt.
  • Das Buchen erfordert job_create und job_manage.
  • Der Inhaber und die Administratoren werden per E-Mail benachrichtigt, wenn eine App oder ein API-Schlüssel zum ersten Mal Ereignisse für das Unternehmen abonniert.
  • Ein Abonnement endet von selbst, wenn der API-Schlüssel, der es angelegt hat, widerrufen wird, wenn die App getrennt wird oder wenn das Mitglied, das die App verbunden hat, das Unternehmen verlässt oder gesperrt wird.

Authentifizierung

n8n und Pipedream verbinden sich mit einem API-Schlüssel (chsk_test_… zum Ausprobieren mit Sandbox-Daten, chsk_live_… für echte Arbeit). Zapier und Make verbinden sich über OAuth: Die verbindende Person meldet sich bei Crisphive an und genehmigt die App, und die Verbindung kann danach nur das tun, was diese Person im Dashboard tun darf.

Testen Sie zuerst mit einem chsk_test_-Schlüssel: Sandbox-Jobs erreichen nie einen echten Kunden, und Sandbox-Trigger empfangen nur Sandbox-Ereignisse.