dealsky.ioDocs
Zur App
Integrationen

Zapier

dealsky mit über 5.000 Apps verbinden, ohne eigenen Server. Du brauchst nur einen API-Key und die Bausteine „Webhooks by Zapier“.

Ab dem Growth-Tarif. Eine eigene dealsky-App im Zapier-Verzeichnis ist in Arbeit. Bis dahin funktioniert alles über „Webhooks by Zapier“, das in jedem Zapier-Tarif enthalten ist.

Vorbereiten

  1. In der App unter Einstellungen → Integrationen → API Keys einen Key anlegen.
  2. Den Key wie ein Passwort behandeln. In Zapier gehört er nur in den Header X-API-Key, nie in die Adresse.

Trigger: wenn in dealsky etwas passiert

  1. In Zapier einen Zap mit dem Trigger Webhooks by Zapier → Catch Hook anlegen und die angezeigte Adresse kopieren.
  2. Diese Adresse in dealsky als Webhook-Endpunkt eintragen: in der App unter Einstellungen → Integrationen → Webhooks oder per POST /v1/webhooks. Dabei die gewünschten Ereignisse wählen.
  3. In Zapier „Test trigger“ klicken. Sobald das Ereignis einmal eingetreten ist, stehen alle Felder für die nächsten Schritte bereit.

Verfügbare Ereignisse:

Ereignis
landing_page.visited
booking.confirmed
landing_page.deletion_requested
linkedin.connection_accepted
linkedin.connection_declined
linkedin.replied

Inhalt jedes Ereignisses: GET /v1/webhooks/events.

Aktionen: etwas in dealsky tun

  1. Als Aktion Webhooks by Zapier → Custom Request wählen.
  2. Method und URL aus der Referenz übernehmen, die URL beginnt mit https://api.dealsky.io/functions/v1/api.
  3. Unter Headers eintragen: X-API-Key mit deinem Key und Content-Type mit application/json.
  4. Unter Data den JSON-Body wie im Beispiel der Referenz, Werte aus vorherigen Schritten lassen sich einsetzen.

Häufige Aktionen:

AktionMethodURL
Lead anlegenPOST/v1/leads
Lead per E-Mail findenGET/v1/leads?email=anna@beispiel.de
Lead ändernPATCH/v1/leads/{id}
Notiz am Lead anlegenPOST/v1/leads/{id}/notes
Ausschluss anlegenPOST/v1/exclusions
Liste anlegenPOST/v1/lists

Mit einem Test-Key (kv_test_…) lassen sich Zaps gefahrlos ausprobieren: Schreibende Aufrufe werden geprüft, aber nicht ausgeführt.

Beispiel: gebuchte Termine ins CRM

  1. Trigger: Catch Hook mit dem Ereignis booking.confirmed.
  2. Aktion: „Create Lead“ oder „Create Deal“ in Salesforce, HubSpot oder Pipedrive.

Bisherige Zapier-Anbindung

Zaps, die die bisherigen Adressen /functions/v1/actions und /functions/v1/webhooks nutzen, laufen weiter. Für neue Zaps bitte die REST-API v1 verwenden: mehr Funktionen, Test-Modus und genaue Fehlermeldungen.