Posílejte leady ze Zapieru nebo Make do Cold Leads
- Pro koho
- Týmy, které automatizují pomocí Zapieru nebo Make
- Problém
- Leady přicházejí z mnoha nástrojů: chatovacích widgetů, rezervačních stránek, pokladen e-shopů, editorů formulářů. Cold Leads nemá aplikaci v katalozích Zapieru ani Make, takže neexistuje hotová akce, kterou byste si vybrali.
- Řešení
- Použijte obecný HTTP krok, který mají obě platformy. Jeden požadavek na lead endpoint s klíčem pro web vytvoří nebo aktualizuje kontakt; v tarifu Business druhý požadavek na stage hook přesune kontakt do fáze customer, například když dorazí platba.
- Co získáte
- Zap nebo scénář v Make, který z libovolného triggeru udělá kontakt v Cold Leads se štítky a fází a volitelně později aktualizuje jeho fázi.
Adresy, identifikátory a výsledky v příkladech jsou ilustrativní. Doména example.com je vyhrazená pro dokumentaci, takže skutečná kontrola těchto adres vrátí invalid.
Ukázky kódu jsou ve všech jazycích stejné, komentáře v nich jsou anglicky.
Dva endpointy
| Endpoint | Klíč | Tarify | Co dělá |
|---|---|---|---|
| POST /api/hooks/lead | Klíč pro web (lk_…) v x-api-key | Všechny tarify | Vytvoří kontakt (nebo přidá štítky existujícímu) ve fázi subscriber nebo lead se stavem souhlasu inquiry |
| POST /api/hooks/stage | Tajný klíč (sk_…) v x-api-key nebo Authorization: Bearer | Business | Přesune existující kontakt do fáze cold, subscriber, lead, customer nebo regular |
Na lead endpoint posílejte jen lidi, kteří vás kontaktovali. Seznamy cold kontaktů patří do importu CSV, který je uloží se stavem souhlasu B2B outreach.
Zapier
- Vyberte aplikaci a událost triggeru, například novou rezervaci nebo nový záznam z formuláře.
- Přidejte akci Webhooks by Zapier → POST. Webhooks by Zapier není v bezplatném tarifu Zapieru k dispozici.
- URL: https://coldleads.app/api/hooks/lead. Payload Type: json.
- Data: email, name, company, phone a message namapované z triggeru; tag s pevnou hodnotou, například zapier; stage nastavené na lead, pokud jde o obchodní leady.
- Headers: x-api-key s vaším klíčem pro web. Otestujte krok; odpověď je {"ok":true}.
Make
- Začněte scénář modulem triggeru aplikace, která sbírá leady.
- Přidejte HTTP → Make a request s URL https://coldleads.app/api/hooks/lead a metodou POST.
- Headers: x-api-key s vaším klíčem pro web. Body type: Raw, content type JSON, obsah požadavku jako níže.
- Zapněte Parse response, abyste v dalších modulech viděli ok nebo kód chyby.
{
"email": "{{1.email}}",
"name": "{{1.name}}",
"company": "{{1.company}}",
"message": "{{1.message}}",
"tag": "make",
"stage": "lead"
}Přesun kontaktu do fáze customer (Business)
Když se obchod uzavře jinde, například zaplacením faktury, zavolejte stage hook s tajným klíčem. Tento klíč mějte jen v Zapieru nebo Make; tajný klíč nikdy nevkládejte do webové stránky.
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" }'Kontakt už musí existovat; jinak hook odpoví not_found. Neznámá fáze vrátí bad_input se seznamem platných fází.
Limity a chyby
- Lead endpoint přijímá 30 požadavků za minutu z jedné IP adresy a 500 denně na klíč pro web. Zapier a Make odesílají ze sdílených adres, takže velké hromadné doplnění starších dat může narazit na rate_limited; pošlete ho v menších dávkách nebo místo toho importujte CSV soubor.
- Stage hook přijímá 120 požadavků za minutu na tajný klíč.
- 402 contact_limit znamená, že je dosažen limit kontaktů tarifu; existující kontakty se dál aktualizují.
- Cold Leads sám Zapier ani Make nevolá: nemá odchozí webhooky, takže Zap nelze spustit novým kontaktem v Cold Leads.
Otázky
Existuje oficiální aplikace Cold Leads pro Zapier nebo Make?
Ne. Použijte Webhooks by Zapier nebo HTTP modul v Make, jak je popsáno zde.
Může se Zap spustit, když v Cold Leads vznikne kontakt?
Ne. Cold Leads nemá odchozí webhooky. REST API tarifu Business lze periodicky dotazovat, ale neexistuje proud událostí pro nové kontakty.
Potřebuji tarif Business?
Pro vytváření kontaktů ne: klíče pro web fungují v každém tarifu. Přesouvání mezi fázemi přes stage hook vyžaduje tajný klíč, který lze vytvořit jen v tarifu Business.