Робочі рецепти для розробників і тих, хто будує автоматизації. Кожен допис містить конкретну конфігурацію, воркфлоу або скрипт для API Cold Leads і вказує ліміти та вартість у кредитах. Для API потрібен секретний ключ тарифу Business.
Адреси, ідентифікатори та результати в прикладах ілюстративні. Домен example.com зарезервовано для документації, тож реальна перевірка цих адрес поверне invalid.
Розробники, які користуються AI-асистентами в Cursor, Claude Desktop або Windsurf5 хв читання
Копіювати адреси між асистентом, CRM та інструментом перевірки довго, і легко помилитися, а асистент, якого просять знайти контакти, охоче вигадає їх сам.
Підключений асистент керує вашими контактами, імпортує структуровані рядки, читає синхронізовані розмови, редагує шаблони й чернетки кампаній та створює веб-форми. Надсилання потребує явного підтвердження користувача та підлягає перевіркам згоди, відписки, DNC і лімітів Cold Leads.
Що ви отримаєте: Асистент, підключений до ваших контактів, пошти й чернеток кампаній через MCP або Node SDK.
Викликати API перевірки окремо для кожного рядка повільно, і так швидко впираєшся в ліміти запитів, а масовому API потрібні завдання, цикл опитування та надійний спосіб зіставити результати з потрібними рядками.
Один workflow бере до 5 000 рядків, які ще не мають результату, надсилає їхні унікальні адреси одним масовим завданням Cold Leads, опитує завдання кожні 5 секунд, отримує результати, спрямовує кожен рядок за статусом і записує в таблицю статус, оцінку, причину та наступний крок. Запустіть його знову для наступних 5 000.
Що ви отримаєте: Чотири заповнені колонки в кожному рядку (verify_status, verify_score, verify_reason, next_step) і workflow, який можна запускати знову, доки не буде оброблено всю таблицю.
Адреси, яких ніхто не перевіряв, потрапляють просто в кампанію розсилки. Невалідні повертаються з відмовою, а відмови шкодять скринькам, з яких надсилається кампанія.
Додайте перевірку Cold Leads між тригером і Instantly: один HTTP-запит на ліда, фільтр, який пропускає лише результати valid, і другий HTTP-запит, що додає ліда у вашу кампанію через Instantly API v2.
Що ви отримаєте: Робочий сценарій Make: новий лід, перевірка Cold Leads, фільтр, лід доданий у кампанію Instantly. Ліди, що не пройшли фільтр, зупиняються на ньому або потрапляють в аркуш для перегляду.
Модуль Cold Leads, Body content
{
"email": "{{map the e-mail field of the trigger here}}",
"timeout_ms": 10000
}
Перевіряти по одній адресі за запит повільно, і так ви впираєтеся в ліміт запитів. Наївний масовий цикл може відкрити більше завдань, ніж дозволяє акаунт, заплатити двічі після збою або непомітно загубити рядки, результати яких так і не повернулися.
Нормалізуйте колонку й приберіть дублікати, надсилайте масові завдання до 5 000 адрес, тримайте відкритими не більше п’яти, опитуйте кожне завдання до кінця, перечікуйте ліміти запитів, коректно зупиняйтеся, коли закінчуються кредити, і зберігайте id завдань, щоб повторний запуск продовжував роботу, а не платив знову.
Що ви отримаєте: Ваш CSV із трьома новими колонками (verify_status, verify_score, verify_reason) і невеликий файл .jobs.json, завдяки якому запуск можна продовжити.
verify_csv.py
"""Verify a large CSV with the Cold Leads bulk API (Python 3.9+, httpx).
pip install httpx
export COLDLEADS_API_KEY=sk_...
python verify_csv.py leads.csv leads_verified.csv --column email
Addresses are normalised and de-duplicated, sent in jobs of up to 5,000 with at most
5 jobs open at a time, and every job is polled until it is done. The output is the
input CSV plus verify_status, verify_score and verify_reason. Job ids are saved next
to the output file, so a second run resumes the same jobs instead of paying twice.
Код перевірки повний параметрів і значень статусу, специфічних для постачальника. Якщо замінити ендпоінт, не зіставивши їх, непомітно зміниться те, на які адреси надсилає ваш конвеєр.
Зіставте кожен параметр і поле відповіді з відповідником у Cold Leads, залиште на місці те, чого Cold Leads не замінює (дані про людей, пошук за доменом), і скористайтеся невеликим адаптером, щоб наявний код зберіг свою форму.
Що ви отримаєте: Зіставлення поле за полем, Python-адаптер, який повертає поля в стилі Hunter із даних Cold Leads, і таблиця вартості Cold Leads для 1 000, 10 000 і 50 000 перевірок на місяць.
hunter_adapter.py
# pip install httpx
# Drop-in helpers for code written against Hunter's email-verifier and email-finder.
# They call Cold Leads and return Hunter-style fields, plus the raw Cold Leads answer.
import os
import httpx
cold = httpx.Client(
base_url="https://coldleads.app/api/v1",
headers={"x-api-key": os.environ["COLDLEADS_API_KEY"]}, # the key goes in a header, never in the URL
Агент, якому потрібна перевірка e-mail, ніколи не повинен мати платіжної картки чи оформлювати підписку сам. Якщо відправити людину реєструватися, обирати тариф і копіювати ключ, завдання переривається, а ключі, вставлені в чат, витікають.
Агент викликає один ендпоінт без ключа й отримує посилання Stripe Checkout для свого власника та секретний claim-токен. Власник переглядає тариф і ухвалює рішення. Після оплати агент рівно один раз отримує API-ключ за claim-токеном — через опитування або після підписаного callback-запиту.
Що ви отримаєте: Робочий секретний API-ключ для нового акаунта Business власника, переданий агентові один раз, і лист власникові з посиланням, яке відкриває веб-застосунок Cold Leads.
Деякі поштові сервери приймають пошту для будь-якої адреси на своєму домені, тож перевірка скриньки не відрізнить справжню людину від вигаданого імені. Інші сервери дають лише тимчасові відповіді або взагалі недосяжні, а сама мітка valid може приховати те, що скриньку так і не перевірили.
Розберіться, який SMTP-діалог веде сервіс перевірки і що означає кожна відповідь, а потім читайте статус, оцінку й коди причин, які повертає Cold Leads, зокрема у випадках, коли перевірка скриньки не виконувалася.
Що ви отримаєте: Таблиця рішень, що зіставляє кожен код причини Cold Leads із дією, і скрипт, який застосовує її до однієї адреси.
Дві SMTP-сесії (ілюстрація)
# Session 1: is the address accepted?
S: 220 mx1.example.com ESMTP
C: EHLO verifier.example.net
S: 250-mx1.example.com
S: 250 SIZE 52428800
C: MAIL FROM:<check@verifier.example.net>
S: 250 2.1.0 Sender OK
C: RCPT TO:<anna@example.com>
S: 250 2.1.5 Recipient OK <- accepted (a 550 here would mean: rejected)
C: QUIT <- no DATA command: nothing is delivered
У цьому рецепті
SMTP-діалог, що стоїть за перевіркою скриньки
Коди відповідей і висновки, які з них можна зробити
Перевірка accept-all, грейлістинг та інші обмеження
Що повертає Cold Leads і коли перевірка не виконувалася
Контакти надходять із форм, імпортів і ручного введення з помилками, мертвими доменами або взагалі без адреси, і ніхто їх не перевіряє, доки кампанія не почне отримувати відмови.
Перевіряйте кожен контакт у момент створення: дією Custom code у workflow HubSpot або невеликим приймачем вебхуків для Pipedrive. Контакт з e-mail перевіряється; контакт без нього, але з іменем і сайтом компанії, отримує запропоновану адресу, чітко позначену як припущення.
Що ви отримаєте: Властивості контакту в HubSpot або поля особи в Pipedrive, які показують статус, оцінку й причину від Cold Leads або запропоновану адресу з її методом і впевненістю.
Custom code (Node.js)
// HubSpot workflow, Custom code action (Node.js)
// Secret: COLDLEADS_API_KEY (your Cold Leads secret key, sk_...)
// Properties to include in code: email, firstname, lastname, website
// Data outputs (add them in the action): verify_status, verify_reason, suggested_email, find_method (String);
// verify_score, find_confidence (Number); mailbox_checked (Boolean)
const axios = require("axios");
const coldleads = axios.create({
baseURL: "https://coldleads.app/api/v1",
headers: { "x-api-key": process.env.COLDLEADS_API_KEY },
Агент, якого просять знайти контактні дані, вгадуватиме, а вгадана адреса виглядає точнісінько як справжня. Без інструмента перевірки ні агент, ні людина, яка читає його відповідь, не відрізнить одну від іншої.
Дайте агентові три вузькі інструменти на основі API Cold Leads: пошук у власній CRM користувача, перевірку адреси та припущення адреси за іменем і доменом із чесною позначкою методу. Помилки повертаються як дані, тож агент може на них реагувати, а не падати.
Що ви отримаєте: Спільний API-клієнт, класи інструментів для CrewAI та LangChain і мінімальні crew та агент, які ними користуються.
coldleads_tools.py
# coldleads_tools.py - shared by the CrewAI and LangChain examples (pip install httpx)
import json
import os
import httpx
VERIFY_DESC = (
"Verify one e-mail address with Cold Leads (costs 1 credit). Returns status valid, risky or invalid, "
"a score from 0 to 100 and reason codes. The last reason says what was checked: ok means a mail server "
"accepted the mailbox, smtp_unreachable means the mailbox itself was not checked, catch_all means the "
Експортувати аркуш в інструмент перевірки й вставляти результати назад — клопітно. Наївна користувацька функція знову викликає API і знову витрачає кредит щоразу, коли Sheets повторно виконує формулу.
Дві користувацькі функції викликають API Cold Leads через UrlFetchApp, читають ключ із властивостей скрипту й зберігають кожну відповідь у кеші скрипту до шести годин, тож повторне виконання тієї самої формули не витрачає ще один кредит на ті самі вхідні дані.
Що ви отримаєте: Три клітинки з результатом у кожному рядку: статус, оцінка й причина від =VERIFY_EMAIL або адреса, метод і впевненість від =FIND_EMAIL.
Code.gs
// Cold Leads custom functions for Google Sheets (Extensions → Apps Script, paste into Code.gs).
// Key: Project Settings → Script Properties → Add script property COLDLEADS_API_KEY = sk_...
const COLDLEADS_API = 'https://coldleads.app/api/v1';
const CACHE_SECONDS = 21600; // 6 hours, the longest CacheService keeps an entry
/**
* Verifies an e-mail address with Cold Leads. Fills three cells: status, score, last reason code.
* Costs 1 Cold Leads credit unless the same address was answered from this script's cache.
*
* @param {string} email The address, for example A2.
HubSpot — типова відповідь на питання «яку CRM обрати?», але команді з одного–десяти людей здебільшого потрібно ловити заявки з сайту, надсилати персональний outreach і відповідати на листи, а платні тарифи HubSpot рахуються за місце, і на старших редакціях є плата за онбординг.
Порівняйте обидва інструменти за тим, що мала команда робить щодня: збирає заявки, надсилає outreach з власної скриньки, читає відповіді й веде воронку. Cold Leads має фіксовану ціну за акаунт і всі ці частини вбудовано; HubSpot — набагато більша платформа, яка додає послідовності, маркетингову автоматизацію та звітність у старших редакціях.
Що ви отримаєте: Чітке розуміння, де сильніший кожен інструмент, моделі ціни поруч і спосіб використовувати Cold Leads разом із HubSpot, якщо ви залишаєте обидва.
Lemlist і Cold Leads обидва надсилають холодні листи, але розв’язують різні задачі: Lemlist — платформа sales engagement для багатоканального пошуку клієнтів, яка синхронізується з CRM, а Cold Leads — це сама CRM, де заявки з сайту, кампанії й відповіді зібрано в одному місці.
Порівнюйте їх за задачею, яку потрібно виконати. Якщо вам потрібні кроки в LinkedIn, дзвінки, вбудована база лідів і прогрів, Lemlist створено саме для цього. Якщо потрібно збирати заявки, запускати персональні кампанії з власної скриньки й опрацьовувати кожну відповідь в одній CRM — для цього створено Cold Leads.
Що ви отримаєте: Порівняння каналів, даних, цін і функцій CRM поруч, а також налаштування для команд, які використовують Lemlist для пошуку клієнтів, а Cold Leads — для вхідних заявок.
Створення контакту з будь-якого інструмента (JSON)
curl -X POST https://coldleads.app/api/hooks/lead \
-H "Content-Type: application/json" \
-H "x-api-key: lk_your_website_key" \
-d '{
"email": "jane@example.com",
"name": "Jane Example",
"company": "Example Ltd",
"message": "Asked for a demo on the pricing page",
"tag": "demo-request",
"stage": "lead"
Заявки з контактної форми зазвичай потрапляють у чиюсь скриньку, отримують відповідь пізно або взагалі не отримують і так і не стають видимою воронкою. Більшість CRM можуть їх зберігати, але деталі, від яких залежить, чи отримає лід відповідь, легко пропустити під час порівняння інструментів.
Оцініть кожну CRM за коротким чек-листом: чи приймає вона форму, яка у вас уже є, чи зупиняє ботів без капчі, чи тримає заявки окремо від холодних контактів, чи збирає розмову в одному місці й чи підказує, кому відповісти сьогодні. А потім налаштуйте її менш ніж за годину.
Що ви отримаєте: Чек-лист, який можна застосувати до будь-якої CRM, і робоче налаштування заявок у Cold Leads: форма, теги, стадія, необов’язкова автоматична кампанія-відповідь і черга «Сьогодні».
Контактна форма з fetch, що зберігає ваше власне повідомлення про успіх
На вашому сайті вже є контактна форма, але надіслані дані потрапляють у скриньку або в базу даних плагіна, а не туди, де ви працюєте з наступними кроками. Перебудова форми всередині CRM змінила б ваш дизайн.
Залиште форму й надсилайте її поля на ендпоінт лідів Cold Leads із публічним ключем сайту: безпосередньо з HTML, через аддон WPForms Webhooks, кількома рядками PHP для Contact Form 7 або як власну дію форми у Webflow.
Що ви отримаєте: Кожне надсилання стає контактом у Cold Leads з іменем, компанією, телефоном, повідомленням, тегами й стадією, а відвідувач потрапляє на вашу сторінку подяки.
Конструктори форм зберігають відповіді у власних панелях. Ви хочете, щоб кожна відповідь ставала контактом у CRM, якому можна відповісти, але Typeform і Tally надсилають вебхуки у власному вкладеному форматі, а Google Forms вебхуків не має взагалі.
Використайте маршрут, що доставляє пласкі поля на ендпоінт лідів Cold Leads: короткий тригер Apps Script для Google Forms і сценарій Make або Zap для Typeform і Tally, який зіставляє відповіді з полями email, name, company та message.
Що ви отримаєте: Кожна нова відповідь форми стає контактом у Cold Leads зі статусом згоди inquiry, вашими тегами й обраною стадією.
Apps Script, прив’язаний до форми
const COLDLEADS_KEY = "lk_your_website_key";
// Form question title → Cold Leads field
const FIELDS = { "Work e-mail": "email", "Name": "name", "Company": "company", "What do you need?": "message" };
function sendToColdLeads(e) {
const lead = { tag: "google-forms" };
// If the form collects e-mail addresses automatically, use that address.
const respondent = e.response.getRespondentEmail();
if (respondent) lead.email = respondent;
for (const item of e.response.getItemResponses()) {
Ліди приходять із багатьох інструментів: чат-віджетів, сторінок бронювання, кошиків інтернет-магазинів, конструкторів форм. Cold Leads не має застосунку в каталогах Zapier чи Make, тож готової дії, яку можна обрати, немає.
Використайте загальний HTTP-крок, який є в обох платформах. Один запит на ендпоінт лідів із ключем сайту створює або оновлює контакт; у тарифі Business другий запит на хук стадій переводить контакт на стадію customer, наприклад коли надходить оплата.
Що ви отримаєте: Zap або сценарій Make, який перетворює будь-який тригер на контакт у Cold Leads з тегами й стадією та за бажанням пізніше оновлює стадію.
Switching between an AI chat and a CRM means copying names, addresses and replies back and forth, and an assistant without access to your data guesses instead of checking.
Add the hosted Cold Leads MCP server (https://coldleads.app/api/mcp) to ChatGPT or Claude and sign in with your Cold Leads account. The assistant can then read your follow-up queue, verify addresses, look up a lead's history, import contacts, and prepare templates and campaign drafts in your workspace. Sending a message or launching a campaign needs your explicit approval.
Що ви отримаєте: A chat that works on your own Cold Leads workspace: answers based on real contacts and conversations, drafts you approve before anything is sent, and an audit log of every call.
Claude Code
claude mcp add --transport http coldleads https://coldleads.app/api/mcp
# then, inside Claude Code: /mcp → coldleads → Authenticate