Форма на вашем собственном сайте — скачивание материалов, запрос демо, страница контактов — может создавать лиды в AB Sales напрямую; то же может делать ваш бэкенд или инструмент автоматизации. И то и другое использует один ключ приёма из настроек CRM. Ничему на вашем сайте не нужно входить в систему, а обычной HTML-форме не нужен даже JavaScript.
Где находится ключ
Откройте рабочее пространство → Настройки → карточка Веб-форма и API. Когда владелец или администратор открывает её впервые, ключ создаётся; участники видят тот же ключ только для чтения. На карточке показаны ключ с кнопкой Копировать, готовый к вставке сниппет HTML-форма, пример API и кнопка Создать новый ключ.
Два пути внутрь
Обычная HTML-форма
Ваша существующая форма отправляет данные прямо в AB Sales и перенаправляет посетителя на вашу страницу благодарности. Лучший вариант для формы скачивания или обратной связи на сайте, где нет разработчика под рукой.
JSON API
Ваш бэкенд, Zapier, Power Automate или любой инструмент, умеющий делать веб-запросы, отправляет те же поля в формате JSON (простой текстовый формат для структурированных данных), передавая ключ как bearer-токен.
1. Направьте HTML-форму в AB Sales
- Скопируйте сниппет. На карточке Веб-форма и API нажмите Копировать рядом с подписью HTML-форма. Ваш ключ в нём уже подставлен.
- Замените адрес страницы благодарности. Скрытое поле
redirect— это то, куда попадает посетитель после отправки: ваша страница скачивания или благодарности, полным адресом сhttps://. - Оставьте скрытые поля, добавьте свои.
keyиredirectделают всю работу;ab_hp— это ловушка (поле, которое люди никогда не видят, поэтому бот, заполняющий каждое найденное поле, выдаёт себя, и его отправка отбрасывается). Добавьтеcompany,phone,websiteилиmessageкак дополнительные поля ввода ровно с такими именами. - Отправьте форму один раз сами. Лид появится в списке «Лиды» через мгновение, с источником Website.
<form method="post" action="https://blz.actionbridge.io/api/crm/leads/form">
<input type="hidden" name="key" value="lk_…your key…">
<input type="hidden" name="redirect" value="https://www.example.com/thank-you">
<input type="text" name="ab_hp" value="" tabindex="-1" autocomplete="off" style="display:none">
<input name="name" placeholder="Your name">
<input name="company" placeholder="Company">
<input name="email" type="email" required placeholder="Work email">
<button type="submit">Download</button>
</form>message со значением вроде Downloaded: Pricing guide попадает в поле Заметки лида, так что тот, кто его возьмёт, понимает, зачем этот человек пришёл — а исследование с помощью ИИ тоже читает заметки.Поля
Обязательно только поле email — по нему распознаётся повторная отправка и по нему же с лидом связываются. Всё остальное необязательно.
| Поле формы | Поле API | Куда попадает |
|---|---|---|
email обязательно | email | Эл. почта |
name | name | Имя контакта — или Название лида, если компания не указана |
company | company | Название. Если оно указано, name становится контактным лицом — так же, как это делает бот в Teams |
phone, website, industry | те же | Телефон, Сайт, Отрасль |
source | source | Источник. По умолчанию Website; список «Лиды» фильтруется по нему, поэтому ограничьтесь несколькими значениями |
message | message | Заметки, до 4 000 символов |
country, language, timezone | countryCode, preferredLanguage, timeZone | Страна (JP), предпочитаемый язык (ja-JP), часовой пояс (Asia/Tokyo). Значение, не являющееся допустимым кодом, отклоняется, так что в лиде никогда не окажется того, что ничто дальше по цепочке не сможет прочитать |
Текстовые поля ограничены 200 символами. Если отправка отклонена, в ответе названо поле.
2. JSON API
Те же поля в camelCase, с ключом в виде bearer-токена (передаётся в заголовке Authorization). Для инструмента, который не может задать этот заголовок, ключ передаётся в заголовке X-AB-Key.
curl -X POST https://blz.actionbridge.io/api/crm/leads \
-H "Authorization: Bearer lk_…your key…" \
-H "Content-Type: application/json" \
-d '{"name":"Aoi Sato","company":"Contoso","email":"aoi@contoso.com","message":"Downloaded the pricing guide"}'| Статус | Значение |
|---|---|
| 201 | Новый лид. В теле ответа — его leadId. |
200 existing: true | Повтор: вместо нового лида к существующему добавлена заметка (см. ниже). |
| 400 | Какое-то поле неверно. В ошибке сказано, какое. |
| 401 | Неизвестный ключ — опечатка, или ключ с тех пор пересоздан. |
| 429 | Рабочее пространство превысило лимит лидов, или с одного адреса приходит больше 60 запросов в минуту. |
Повторные отправки не создают дубликатов
Вторая отправка с адреса, который уже принадлежит действующему лиду в рабочем пространстве, не создаёт ещё один лид. К существующему добавляется заметка — «Повторно отправлено через форму на сайте» плюс всё, что написал человек, — так что команда видит возобновившийся интерес там, где уже работает, а лимит не тратится дважды на одного человека. При сопоставлении регистр букв не учитывается; архивированный лид не считается, так что тот, кто вернулся после архивации, начинает с чистого листа.
Что видит ваш посетитель
При заданном redirect — всегда вашу страницу благодарности, в том числе когда отправка оказалась повтором или ботом, или рабочее пространство превысило лимит лидов. Лимит вашего плана — ваше дело, а не вашего посетителя. Без перенаправления (форма, отправленная через JavaScript) конечная точка отвечает JSON из таблицы выше.
Если ключом злоупотребляют
Злоупотребление стоит вам спам-лидов и лимита, и ничего больше. Нажмите Создать новый ключ на карточке, подтвердите — и старый ключ сразу перестаёт работать; затем вставьте новый ключ в каждую форму и интеграцию, которые его использовали. Запросы также ограничены по частоте для каждого вызывающего адреса, так что скрапер упрётся в стену, которой настоящая страница никогда не увидит.
Форма на вашем сайте — просто ещё один способ, которым приходит лид: тот же лид, та же воронка, тот же лимит — исчез только ручной ввод.