Leads aus Zapier oder Make an Cold Leads senden
- Für wen
- Teams, die mit Zapier oder Make automatisieren
- Das Problem
- Leads kommen aus vielen Tools: Chat-Widgets, Buchungsseiten, E-Commerce-Checkouts, Formular-Buildern. Cold Leads hat keine App in den Verzeichnissen von Zapier oder Make, daher gibt es keine fertige Aktion zur Auswahl.
- Die Lösung
- Nutzen Sie den generischen HTTP-Schritt, den beide Plattformen haben. Eine Anfrage an den Lead-Endpunkt mit einem Website-Schlüssel legt einen Kontakt an oder aktualisiert ihn; im Business-Tarif verschiebt eine zweite Anfrage an den Phasen-Hook einen Kontakt nach customer, zum Beispiel wenn eine Zahlung eingeht.
- Was Sie bekommen
- Ein Zap oder Make-Szenario, das jeden Trigger in einen Cold-Leads-Kontakt mit Tags und Phase verwandelt und die Phase optional später aktualisiert.
Adressen, IDs und Ergebnisse in den Beispielen sind illustrativ. example.com ist für Dokumentation reserviert, eine echte Prüfung dieser Adressen liefert daher invalid.
Die Codebeispiele sind in allen Sprachen gleich, ihre Kommentare sind auf Englisch.
Zwei Endpunkte
| Endpunkt | Schlüssel | Tarife | Was er tut |
|---|---|---|---|
| POST /api/hooks/lead | Website-Schlüssel (lk_…) in x-api-key | Alle Tarife | Legt einen Kontakt an (oder ergänzt Tags bei einem bestehenden) mit Phase subscriber oder lead und Einwilligungsstatus inquiry |
| POST /api/hooks/stage | Geheimer Schlüssel (sk_…) in x-api-key oder Authorization: Bearer | Business | Verschiebt einen bestehenden Kontakt nach cold, subscriber, lead, customer oder regular |
Senden Sie nur Personen an den Lead-Endpunkt, die sich bei Ihnen gemeldet haben. Kalte Interessentenlisten gehören in einen CSV-Import, der sie mit dem Einwilligungsstatus B2B outreach speichert.
Zapier
- Wählen Sie die Trigger-App und das Ereignis, zum Beispiel eine neue Buchung oder einen neuen Formulareintrag.
- Fügen Sie die Aktion Webhooks by Zapier → POST hinzu. Webhooks by Zapier ist im kostenlosen Zapier-Tarif nicht verfügbar.
- URL: https://coldleads.app/api/hooks/lead. Payload Type: json.
- Data: email, name, company, phone und message aus dem Trigger zugeordnet; tag mit einem festen Wert wie zapier; stage auf lead gesetzt, wenn es sich um Vertriebs-Leads handelt.
- Headers: x-api-key mit Ihrem Website-Schlüssel. Testen Sie den Schritt; die Antwort lautet {"ok":true}.
Make
- Starten Sie das Szenario mit dem Trigger-Modul der App, die Leads sammelt.
- Fügen Sie HTTP → Make a request mit der URL https://coldleads.app/api/hooks/lead und der Methode POST hinzu.
- Headers: x-api-key mit Ihrem Website-Schlüssel. Body type: Raw, Content type JSON, Request content wie unten.
- Aktivieren Sie Parse response, um ok oder den Fehlercode in späteren Modulen zu sehen.
{
"email": "{{1.email}}",
"name": "{{1.name}}",
"company": "{{1.company}}",
"message": "{{1.message}}",
"tag": "make",
"stage": "lead"
}Kontakt nach customer verschieben (Business)
Wenn anderswo ein Abschluss zustande kommt, zum Beispiel eine bezahlte Rechnung, rufen Sie den Phasen-Hook mit einem geheimen Schlüssel auf. Bewahren Sie diesen Schlüssel nur in Zapier oder Make auf; fügen Sie einen geheimen Schlüssel niemals in eine Webseite ein.
curl -X POST https://coldleads.app/api/hooks/stage \
-H "Content-Type: application/json" \
-H "x-api-key: sk_your_secret_key" \
-d '{ "email": "jane@example.com", "stage": "customer" }'Der Kontakt muss bereits existieren; andernfalls antwortet der Hook mit not_found. Eine unbekannte Phase liefert bad_input mit der Liste der gültigen Phasen.
Limits und Fehler
- Der Lead-Endpunkt akzeptiert 30 Anfragen pro Minute und IP-Adresse sowie 500 pro Tag und Website-Schlüssel. Zapier und Make senden von gemeinsam genutzten Adressen, daher kann ein großer Nachimport rate_limited auslösen; senden Sie ihn in kleineren Paketen oder importieren Sie stattdessen eine CSV-Datei.
- Der Phasen-Hook akzeptiert 120 Anfragen pro Minute und geheimem Schlüssel.
- 402 contact_limit bedeutet, dass das Kontaktlimit des Tarifs erreicht ist; bestehende Kontakte werden weiterhin aktualisiert.
- Cold Leads ruft Zapier oder Make nicht von sich aus auf: Es gibt keine ausgehenden Webhooks, ein Zap kann also nicht durch einen neuen Cold-Leads-Kontakt ausgelöst werden.
FAQ
Gibt es eine offizielle Cold-Leads-App für Zapier oder Make?
Nein. Verwenden Sie Webhooks by Zapier oder das HTTP-Modul von Make wie hier beschrieben.
Kann ein Zap starten, wenn in Cold Leads ein Kontakt angelegt wird?
Nein. Cold Leads hat keine ausgehenden Webhooks. Die REST-API des Business-Tarifs kann abgefragt werden, aber es gibt keinen Ereignis-Feed für neue Kontakte.
Brauche ich den Business-Tarif?
Nicht zum Anlegen von Kontakten: Website-Schlüssel funktionieren in jedem Tarif. Das Verschieben von Phasen mit dem Phasen-Hook erfordert einen geheimen Schlüssel, den nur der Business-Tarif erstellen kann.