Cold Leads

Ověřte leady v Make.com dřív, než se dostanou do kampaně v Instantly

Pro koho
Uživatelé Make.com, kteří posílají cold e-maily přes Instantly
Problém
Adresy, které nikdo nezkontroloval, jdou rovnou do rozesílané kampaně. Neplatné se vracejí jako nedoručitelné a každý bounce jde na vrub schránkám, ze kterých kampaň odchází.
Řešení
Mezi trigger a Instantly vložte kontrolu Cold Leads: jeden HTTP požadavek na lead, filtr, který propustí jen výsledky se stavem valid, a druhý HTTP požadavek, který lead přidá do vaší kampaně přes Instantly API v2.
Co získáte
Běžící scénář v Make: nový lead, ověření v Cold Leads, filtr, lead přidaný do kampaně v Instantly. Leady, které filtrem neprojdou, tam skončí nebo jdou do listu ke kontrole.

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.

Než začnete

  • Tajný klíč Cold Leads (sk_…) z Nastavení → API klíče. API je součástí tarifu Business.
  • API klíč Instantly v2 se scope, který umožňuje vytvářet leady (leads:create, leads:all, all:create nebo all:all). Vytvoříte ho v Instantly v Settings → Integrations → API Keys; zobrazí se jen jednou. Váš pracovní prostor v Instantly potřebuje placený tarif s přístupem k API.
  • ID kampaně v Instantly. GET https://api.instantly.ai/api/v2/campaigns vypíše kampaně s jejich ID (potřebuje scope campaigns:read).
  • List s řádkem záhlaví a sloupci email, first_name, last_name a company. Modul Watch New Rows v Make se zastaví na prázdném řádku, proto data držte bez vynechaných řádků.

Sestavte scénář

  1. Google Sheets → Watch New Rows: vyberte tabulku a list.
  2. HTTP → Make a request (aplikace HTTP, verze 4). Authentication type: API key. V Credentials přidejte klíč: Key = váš klíč sk_, API key placement = In the header, API key parameter name = x-api-key. URL: https://coldleads.app/api/v1/verify. Method: POST. Body content type: application/JSON. Body input method: JSON string. Body content: JSON níže s e-mailem namapovaným z kroku 1. Parse response: Yes. V Advanced settings nastavte Return error if HTTP request fails na Yes a Timeout na 30 sekund.
  3. Klikněte na ikonu francouzského klíče na spojnici za modulem Cold Leads a zvolte Set up a filter. Label: Jen platné. Condition: status z dat odpovědi modulu Cold Leads, Text operators: Equal to, hodnota valid.
  4. Pro Instantly znovu HTTP → Make a request. Authentication type: API key; přidejte klíč, kde Key = Bearer, mezera a váš API klíč Instantly, API key placement = In the header, API key parameter name = Authorization. URL: https://api.instantly.ai/api/v2/leads. Method: POST. Body content type: application/JSON, JSON string, Parse response: Yes, Return error if HTTP request fails: Yes.
  5. Spusťte scénář jednou s testovacím řádkem, zkontrolujte výstupy obou modulů a pak scénář naplánujte.
Modul Cold Leads, Body content
{
  "email": "{{map the e-mail field of the trigger here}}",
  "timeout_ms": 10000
}
Modul Instantly, Body content
{
  "campaign": "your-instantly-campaign-id",
  "email": "{{map email from the Cold Leads module}}",
  "first_name": "{{map from the trigger}}",
  "last_name": "{{map from the trigger}}",
  "company_name": "{{map from the trigger}}",
  "skip_if_in_workspace": true
}

Každý zástupný text nahraďte tak, že kliknete do pole a v mapovacím panelu Make vyberete položku. Používejte jen názvy polí z dokumentace Instantly; k přidání leadu do kampaně potřebuje campaign a email. skip_if_in_workspace nastavené na true přeskočí leady, které už ve vašem pracovním prostoru Instantly existují.

Zvolte, jak přísný má filtr být

FiltrCo projdeKompromis
status Equal to validAdresy, které poštovní server přijal (důvod ok), a adresy, jejichž doména přijímá poštu, ale schránka se nekontrolovala (důvod smtp_unreachable)Projde víc leadů; některé nejsou potvrzené.
status Equal to valid a score greater than or equal to 80 (číselný operátor)Jen adresy, které poštovní server přijal: výsledky valid mají skóre 97, u rolových adres 80, když byla schránka potvrzena, a 75 nebo 65, když se nekontrolovalaMéně leadů; dokud u domény nemůže proběhnout krok SMTP, neprojde nic.

Chcete-li rizikové leady ponechat místo zahození, přidejte za modul Cold Leads Router: jedna trasa s filtrem výše vede do Instantly, druhá trasa se status Equal to risky vede do Google Sheets → Add a Row v listu ke kontrole.

Vyzkoušejte oba požadavky z terminálu

Když modul selže, pošlete stejný požadavek přes curl. Ukáže přesnou odpověď včetně chybových kódů Cold Leads, jako jsou bad_api_key, api_not_in_plan nebo no_credits.

bash
# 1) the Cold Leads request the first HTTP module sends (1 credit)
curl -s https://coldleads.app/api/v1/verify \
  -H "x-api-key: $COLDLEADS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"email":"anna@example.com","timeout_ms":10000}'

# 2) the Instantly request the second HTTP module sends, for a lead that passed the filter
curl -s https://api.instantly.ai/api/v2/leads \
  -H "Authorization: Bearer $INSTANTLY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"campaign":"your-instantly-campaign-id","email":"anna@example.com","first_name":"Anna","last_name":"Novak","company_name":"Acme","skip_if_in_workspace":true}'

Chyby a opakování

  • S volbou Return error if HTTP request fails nastavenou na Yes zastaví 401 nebo 403 (klíč nebo tarif), 402 no_credits nebo 429 běh u modulu, místo aby se tělo chyby předalo dalšímu kroku.
  • Cold Leads povoluje 120 požadavků za minutu na klíč a při překročení odpoví 429 rate_limited s Retry-After: 60. Pokud klíč sdílejí i jiné nástroje, zapněte v nastavení scénáře Store incomplete executions a k modulu Cold Leads přidejte error handler Retry (pravým tlačítkem na modul, Add error handler).
  • Make 26. května 2026 přejmenoval své error handlery: z Break je Retry a z Ignore je Skip. Kompletní sada je Skip, Retry, Resume, Commit a Rollback.
  • Instantly povoluje až 100 požadavků za sekundu a 6 000 za minutu na pracovní prostor, sdílené všemi API klíči, a nad tento limit odpovídá 429.

Limity a náklady

  • 1 kredit Cold Leads za každý zkontrolovaný lead bez ohledu na výsledek, i u výsledků z 30denní cache.
  • timeout_ms 10000 drží každou kontrolu zhruba pod 10 sekundami; když limit vyprší, výsledek je risky s důvodem timeout, takže se zastaví na filtru.
  • Tarif Business stojí $99 měsíčně a zahrnuje API a 10 000 kreditů měsíčně; další balíčky po 1 000 kreditech stojí $5.
  • Make a Instantly si své využití účtují samy podle vašich tarifů u nich.

Otázky

Existuje vestavěná integrace Cold Leads pro Make nebo Instantly?

Ne. Scénář posílá dva obyčejné HTTP požadavky s vašimi vlastními klíči: jeden na API Cold Leads a jeden na API Instantly. Mezi oběma službami se nesdílí nic kromě toho, co scénář odešle.

Co se stane s leady, které filtrem neprojdou?

Zastaví se na filtru a do Instantly se nikdy nedostanou. Pokud chcete rizikové nebo neplatné leady zapisovat do listu ke kontrole, přidejte Router s druhou trasou.

Můžu použít starší (legacy) modul HTTP?

Ano. Starší Make a request (HTTP verze 3) přijímá stejné hodnoty: v polích URL, Method a Headers (x-api-key nebo Authorization), v surovém JSON těle a v poli Parse response.

Proč má platný lead důvod smtp_unreachable?

Adresa prošla kontrolou syntaxe a MX, ale Cold Leads se přes SMTP nedokázal spojit s poštovním serverem příjemce, takže samotná schránka se nekontrolovala. Pokud chcete jen potvrzené schránky, použijte přísnější filtr.