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
| Art | Schritt | Crisphive-API |
|---|---|---|
| Aktion | Job buchen und bestätigen | POST /v1/job-requests/book-and-confirm |
| Suche | Kunden per Telefonnummer finden | GET /v1/customers?phone=+16135550142 |
| Aktion | Kunden anlegen | POST /v1/customers |
| Aktion | Job abrufen | GET /v1/job-requests/{id} |
| Trigger | Neues 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_atist die lokale Uhrzeit des Unternehmens, ohne Zeitzonen-Offset.- Senden Sie
customer_idoder eincustomer-Objekt: Ein bereits vorhandener Anrufer (gleiche Telefonnummer oder E-Mail) wird zugeordnet, nie doppelt angelegt. job_type_idist 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
4xxabgelehnt, 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: falseund einerrefusal(mit demselbenerror_codeund denselbendata, die der Bestätigungsschritt liefern würde); der Job wartet in der Warteschlange des Disponenten.
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.
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.
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.
Prüfen Sie den Crisphive-Signature-Header gegen das Secret, bevor Sie der Nutzlast vertrauen — den genauen Algorithmus finden Sie unter Webhooks.
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.*erfordertcustomers_view,technician.*erfordertteam_view,job_request.*erfordertjob_view. Alles andere wird mit403 WEBHOOK_EVENT_NOT_PERMITTEDabgelehnt. - Das Buchen erfordert
job_createundjob_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.
chsk_test_-Schlüssel: Sandbox-Jobs erreichen nie einen echten Kunden, und Sandbox-Trigger empfangen nur Sandbox-Ereignisse.