CRM 및 영업
HubSpot을 자율 AI 에이전트에 연결하기
HubSpot에 연결된 Atako 에이전트는 연락처, 회사, 딜, 티켓을 읽고 업데이트할 수 있지만, grant가 다루는 객체와 액션으로만 범위가 제한됩니다.
가능한 워크플로우
신규 리드 보강 및 검증
연락처가 CRM에 새로 들어오면 에이전트는 get_contact로 이를 가져와 사용 가능한 정보를 대조하고, 속성을 업데이트한 뒤(update_contact), 검증 노트를 기록하고(create_note), 담당 영업 사원을 위한 후속 조치 태스크를 생성합니다(create_task). 통화나 이메일은 여전히 영업 사원의 몫이지만, 에이전트는 첫 유효 접촉 이전에 보통 필요한 입력과 사전 조사를 대신해 줍니다. 이는 하루 중 시간이 없어 뒤로 미뤄지기 쉬운 작업입니다.
파이프라인에서 정체된 딜 재조명
에이전트는 일정 기간 움직임이 없는 딜을 찾고(search_deals, 단계 확인을 위한 list_pipelines), list_owners로 확인한 딜 담당자를 위한 후속 태스크를 생성하며, 명확한 규칙이 있으면 상태를 업데이트할 수도 있습니다(update_deal). 무엇이 바뀌든 CRM에서 확인 가능한 기록이 남으며, 이는 아무도 실제로 챙기지 않는 유령 딜로 파이프라인이 부풀어 오르는 것을 막습니다.
계정과 연결된 지원 티켓 생성
이메일이나 Slack으로 받은 신호를 바탕으로 에이전트는 티켓을 생성하고(create_ticket), 올바른 연락처와 회사에 연결한 뒤(create_association), 대화가 진행되는 동안 진행 상황을 추적하고 업데이트합니다(update_ticket). 티켓은 다른 티켓과 마찬가지로 지원팀이 확인하고 수정할 수 있는 상태로 남으며, 생성 시점부터 이미 계정의 전체 이력이 연결되어 있습니다.
커넥터 작업
get_contact (읽기)
식별자로 CRM 연락처를 가져옵니다.
search_contacts (읽기)
텍스트나 속성 필터로 연락처를 검색합니다.
get_deal (읽기)
식별자로 CRM 딜을 가져옵니다.
list_deals (읽기)
CRM 딜 목록을 페이지네이션으로 조회합니다.
list_pipelines (읽기)
파이프라인과 그 단계(딜 또는 티켓)를 조회합니다.
list_owners (읽기)
CRM 담당자 목록을 이메일로 필터링해 조회합니다.
create_contact (쓰기)
CRM 연락처를 생성합니다.
update_contact (쓰기)
연락처의 속성을 업데이트합니다.
create_deal (쓰기)
CRM 딜을 생성합니다.
update_deal (쓰기)
딜(단계, 금액)을 업데이트합니다.
create_ticket (쓰기)
지원 티켓을 생성합니다.
create_task (쓰기)
CRM 태스크(후속 연락, 통화)를 생성합니다.
create_note (쓰기)
레코드에 연결할 노트를 기록합니다.
create_association (쓰기)
두 CRM 레코드를 서로 연결합니다.
사전 요구 사항
- private app을 생성하려면 슈퍼 관리자 권한이 있는 HubSpot 계정이 필요합니다.
- Settings, Integrations, Private Apps에서 private app을 생성해야 합니다.
- 필요한 스코프(연락처, 회사, 딜, 티켓, 담당자의 읽기/쓰기)를 선택해야 합니다.
- 생성 후 표시되는 액세스 토큰(pat- 접두사)을 복사해야 합니다.
- Atako에서 에이전트에 grant를 부여하려면 연동 관리 권한이 필요합니다.
연결 방법
- 1
HubSpot private app 생성
Settings, Integrations, Private Apps에서 앱을 생성하고 이름을 지정한 뒤, 전용 탭에서 스코프를 선택합니다.
- 2
토큰 생성 및 복사
앱 생성 후 액세스 토큰(pat-...)이 표시되며, 단 한 번만 표시되므로 바로 복사해야 합니다.
- 3
Atako에서 HubSpot 연결
설정, 연동에서 액세스 토큰을 붙여넣습니다.
- 4
에이전트에 grant 부여
에이전트 페이지나 연결 화면에서 허용할 정확한 액션과 그 범위(읽기 전용 또는 읽기와 쓰기)를 선택합니다.
자율 AI 에이전트를 HubSpot에 연결해야 하는 이유
HubSpot은 영업팀이나 지원팀의 연락처, 딜, 티켓을 한곳에 모아 둡니다. 그와 함께 오는 반복 작업, 즉 정보 보강, 정체된 딜 재조명, 후속 태스크 생성 같은 일은 대개 누군가 생각날 때마다 그때그때 처리됩니다. 툴 콜링을 통해 HubSpot에 연결된 Atako 에이전트는 영업 담당자가 아침 태스크 목록을 열기를 기다리지 않고 자체 환경에서 이 작업을 지속적으로 처리합니다.
일반적인 자동화 시나리오와의 차이는 이렇습니다. 에이전트는 계속 작동하며 단순히 고립된 행동 하나가 아니라 판단을 내립니다. 이메일이나 Slack으로 신호를 받으면 HubSpot에서 관련 연락처나 딜을 찾고, 태스크를 만들지 속성을 업데이트할지 판단한 뒤, 부여받은 정확한 액션 범위 안에서 이를 실행합니다.
Atako 문서에 따르면 HubSpot 커넥터는 37개 액션(읽기 17개, 쓰기 20개)을 다루며, 연락처 검색부터 커스텀 속성 생성까지 포함합니다. 가장 직접적인 활용 사례는 레브옵스 자동화 에이전트입니다. 지속적인 수동 개입 없이 파이프라인을 감시하고, 리드를 보강하고, 데이터 이상을 알립니다.
한계와 모범 사례
HubSpot API는 기업의 HubSpot 구독에 따라 달라지는 요청 속도 제한(10초 구간당 요청 수, 하루 요청 수)을 적용하며, 검색 엔드포인트에는 더 엄격한 기준이 적용됩니다. 대량의 연락처를 처리하는 에이전트는 한 번에 모든 요청을 몰아넣기보다 호출을 분산해야 합니다.
delete_contact나 delete_deal 같은 일부 쓰기 액션은 HubSpot 쪽에서 실행되면 되돌릴 수 없습니다. 이런 액션은 에이전트의 grant가 명시적으로 허용하는 경우에만 사용할 수 있으며, 실제로 이런 종류의 액션이 부여되는 경우는 드뭅니다.
다른 Atako 연동과 마찬가지로 연결 자체만으로는 아무 접근 권한도 주어지지 않습니다. 정확한 grant(에이전트, 액션, 범위)가 필요합니다. CRM에 에이전트를 연결하기 전에 이 범위를 설계하려면 권한 모델과 플랜을 참고하세요.
관련 사용 사례
관련 통합
자주 묻는 질문
에이전트가 HubSpot에서 마케팅 이메일을 발송할 수 있나요?
해당 스코프가 부여되면 마케팅 이메일 초안(create_marketing_email)을 생성할 수 있지만, 팀이 검증한 발송 액션 없이는 아무것도 나가지 않습니다. 이 커넥터에는 마케팅 이메일을 직접 발송하는 액션이 없습니다.
API를 연결하려면 유료 HubSpot 플랜이 필요한가요?
표준 객체의 경우 API와 private app은 HubSpot의 무료 플랜에서도 사용할 수 있습니다. 커스텀 속성 생성 같은 일부 고급 스코프는 가입한 요금제에 따라 달라질 수 있습니다.
에이전트의 HubSpot 접근 권한을 어떻게 철회하나요?
HubSpot 쪽에서 private app을 삭제하거나 비활성화하거나, Atako 쪽에서 연결을 철회하세요. 두 경우 모두 이를 사용하던 모든 에이전트의 접근이 즉시 영구적으로 차단됩니다.
에이전트가 CRM에서 연락처를 삭제할 수 있나요?
가능합니다. delete_contact 액션이 존재하지만, 에이전트의 grant가 쓰기 범위로 이를 명시적으로 허용하는 경우에만 사용할 수 있습니다. 기본적으로는 어떤 액션도 부여되어 있지 않으며, 삭제를 에이전트의 범위에 포함할지는 사용자가 결정합니다.
다음으로 읽을거리
출처
- HubSpot Developer Docs, Private apps · 접속일 2026년 9월 4일
- HubSpot Developer Docs, API usage guidelines and limits · 접속일 2026년 9월 4일
Atako CTO
이 콘텐츠는 Atako의 AI 에이전트가 작성한 후, Atako CTO인 Romain Laodicina가 검토, 수정 및 승인했습니다.