Надсилайте лідів із Zapier або Make у Cold Leads
- Для кого
- Команди, які автоматизують процеси в Zapier або Make
- Проблема
- Ліди приходять із багатьох інструментів: чат-віджетів, сторінок бронювання, кошиків інтернет-магазинів, конструкторів форм. Cold Leads не має застосунку в каталогах Zapier чи Make, тож готової дії, яку можна обрати, немає.
- Рішення
- Використайте загальний HTTP-крок, який є в обох платформах. Один запит на ендпоінт лідів із ключем сайту створює або оновлює контакт; у тарифі Business другий запит на хук стадій переводить контакт на стадію customer, наприклад коли надходить оплата.
- Що ви отримаєте
- Zap або сценарій Make, який перетворює будь-який тригер на контакт у Cold Leads з тегами й стадією та за бажанням пізніше оновлює стадію.
Адреси, ідентифікатори та результати в прикладах ілюстративні. Домен example.com зарезервовано для документації, тож реальна перевірка цих адрес поверне invalid.
Приклади коду однакові для всіх мов, коментарі в них — англійською.
Два ендпоінти
| Ендпоінт | Ключ | Тарифи | Що робить |
|---|---|---|---|
| POST /api/hooks/lead | Ключ сайту (lk_…) у x-api-key | Усі тарифи | Створює контакт (або додає теги до наявного) зі стадією subscriber чи lead і статусом згоди inquiry |
| POST /api/hooks/stage | Секретний ключ (sk_…) у x-api-key або Authorization: Bearer | Business | Переводить наявний контакт на стадію cold, subscriber, lead, customer чи regular |
Надсилайте на ендпоінт лідів лише людей, які самі зв’язалися з вами. Холодним спискам потенційних клієнтів місце в CSV-імпорті, який зберігає їх зі статусом згоди B2B outreach.
Zapier
- Оберіть застосунок і подію тригера, наприклад нове бронювання чи новий запис форми.
- Додайте дію Webhooks by Zapier → POST. Webhooks by Zapier недоступні на безкоштовному тарифі Zapier.
- URL: https://coldleads.app/api/hooks/lead. Payload Type: json.
- Data: email, name, company, phone і message, зіставлені з тригера; tag із фіксованим значенням, наприклад zapier; stage зі значенням lead, якщо це ліди продажів.
- Headers: x-api-key з вашим ключем сайту. Протестуйте крок; відповідь — {"ok":true}.
Make
- Почніть сценарій із модуля-тригера застосунку, який збирає лідів.
- Додайте HTTP → Make a request з URL https://coldleads.app/api/hooks/lead і методом POST.
- Headers: x-api-key з вашим ключем сайту. Тип тіла: Raw, тип вмісту JSON, вміст запиту — як нижче.
- Увімкніть Parse response, щоб бачити ok або код помилки в наступних модулях.
{
"email": "{{1.email}}",
"name": "{{1.name}}",
"company": "{{1.company}}",
"message": "{{1.message}}",
"tag": "make",
"stage": "lead"
}Переведіть контакт на стадію customer (Business)
Коли угода закривається деінде, наприклад оплачено рахунок, викличте хук стадій із секретним ключем. Зберігайте цей ключ лише в Zapier або Make; ніколи не розміщуйте секретний ключ на вебсторінці.
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" }'Контакт уже має існувати; інакше хук відповідає not_found. Невідома стадія повертає bad_input зі списком допустимих стадій.
Ліміти й помилки
- Ендпоінт лідів приймає 30 запитів на хвилину з однієї IP-адреси й 500 на день на один ключ сайту. Zapier і Make надсилають запити зі спільних адрес, тож велике дозавантаження старих даних може натрапити на rate_limited; надсилайте його меншими партіями або натомість імпортуйте CSV-файл.
- Хук стадій приймає 120 запитів на хвилину на один секретний ключ.
- 402 contact_limit означає, що досягнуто ліміту контактів тарифу; наявні контакти все одно оновлюються.
- Cold Leads сам не викликає Zapier чи Make: вихідних вебхуків немає, тож Zap не може запускатися новим контактом у Cold Leads.
Питання
Чи є офіційний застосунок Cold Leads для Zapier або Make?
Ні. Використовуйте Webhooks by Zapier або модуль HTTP у Make, як описано тут.
Чи може Zap запускатися, коли в Cold Leads створюється контакт?
Ні. У Cold Leads немає вихідних вебхуків. REST API тарифу Business можна опитувати, але потоку подій про нові контакти немає.
Чи потрібен мені тариф Business?
Не для створення контактів: ключі сайту працюють на кожному тарифі. Для зміни стадій через хук стадій потрібен секретний ключ, який можна створити лише в тарифі Business.