여러분 자신의 웹사이트에 있는 폼 — 백서 다운로드, 데모 신청, 문의 페이지 — 에서 AB Sales에 바로 리드를 만들 수 있고, 백엔드나 자동화 도구에서도 만들 수 있습니다. 둘 다 CRM 설정의 접수 키 하나를 씁니다. 사이트 쪽에서는 아무것도 로그인할 필요가 없으며, 일반 HTML 폼이라면 JavaScript도 전혀 필요하지 않습니다.
키가 있는 곳
워크스페이스를 열고 설정 → 웹사이트 폼과 API 카드로 갑니다. 소유자나 관리자가 이 카드를 처음 열 때 키가 만들어지며, 멤버에게는 같은 키가 읽기 전용으로 보입니다. 카드에는 키와 복사 버튼, 바로 붙여 넣을 수 있는 HTML 폼 스니펫, API 예시, 그리고 키 다시 생성 버튼이 있습니다.
들어오는 길 두 가지
일반 HTML 폼
기존 폼이 AB Sales로 바로 전송하고, 방문자는 감사 페이지로 넘어갑니다. 곁에 개발자가 없는 사이트의 다운로드 폼이나 문의 폼에 가장 알맞습니다.
JSON API
백엔드, Zapier, Power Automate 등 웹 요청을 보낼 수 있는 어떤 도구든 같은 필드를 JSON(구조화된 데이터를 담는 평문 형식)으로 보내며, 키는 bearer 토큰으로 전달합니다.
1. HTML 폼을 AB Sales로 향하게 하기
- 스니펫을 복사합니다. 웹사이트 폼과 API 카드에서 HTML 폼 옆의 복사를 클릭합니다. 키는 이미 들어가 있습니다.
- 감사 페이지 URL을 바꿉니다. 숨김 필드
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>Downloaded: Pricing guide처럼 숨김 message 필드를 넣으면 리드의 메모에 남아, 이 리드를 맡는 사람이 이 사람이 왜 왔는지 바로 알 수 있습니다. AI 조사도 메모를 읽습니다.필드
필수는 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 | 워크스페이스가 리드 허용량을 넘었거나, 한 주소에서 1분에 60건이 넘는 요청을 보내고 있습니다. |
재제출은 중복을 만들지 않습니다
워크스페이스에 살아 있는 리드가 이미 가진 이메일로 다시 제출해도 리드가 또 만들어지지는 않습니다. 대신 기존 리드에 메모가 추가됩니다 — “Submitted again through the website form.”(웹사이트 폼으로 다시 제출함)과 그 사람이 적은 내용입니다 — 그래서 팀은 이미 일하고 있는 자리에서 다시 생긴 관심을 볼 수 있고, 한 사람 때문에 허용량이 두 번 쓰이지도 않습니다. 매칭은 대소문자를 구분하지 않으며, 보관된 리드는 세지 않으므로 보관된 뒤 다시 찾아온 사람은 새 리드로 시작합니다.
방문자에게 보이는 것
redirect가 있으면 언제나 여러분의 감사 페이지입니다. 재제출이든, 봇이든, 워크스페이스가 리드 허용량을 넘었든 마찬가지입니다. 플랜 한도는 여러분의 사정이지 방문자의 사정이 아니기 때문입니다. redirect가 없으면(JavaScript로 제출한 폼) 엔드포인트는 위 표의 JSON으로 응답합니다.
키가 악용된다면
악용으로 잃는 것은 스팸 리드와 허용량이며, 그 밖에는 없습니다. 카드에서 키 다시 생성을 클릭하고 확인하면 이전 키는 즉시 멈춥니다. 그다음 새 키를 그 키를 쓰던 모든 폼과 연동에 붙여 넣으세요. 요청은 호출하는 주소별로도 제한되므로, 스크레이퍼는 실제 페이지라면 결코 닿지 않을 벽에 부딪힙니다.
웹사이트 폼은 리드가 들어오는 또 하나의 길일 뿐입니다. 같은 리드, 같은 퍼널, 같은 허용량 — 직접 입력하는 일만 사라집니다.