게시 연동
HubSpot
최종 업데이트:
Private App 액세스 토큰으로 HubSpot을 연결하고, 아티클을 게시하기 전에 블로그에 필요한 것을 안내해요.
Clodix는 Private App 액세스 토큰을 사용해 아티클을 HubSpot CMS 블로그에 바로 게시해요.
Private App 만들기
- HubSpot에서 Settings → Integrations → Private Apps로 이동하세요.
- 새 private app을 만드세요.
- content 스코프를 부여하세요.
- 생성된 액세스 토큰을 복사하세요.
Clodix에서 연결하기
- Settings → Publishing integrations를 열고 HubSpot을 클릭하세요.
- Access token을 붙여 넣으세요.
- Connect를 클릭하세요. Clodix가 토큰을 실시간으로 확인하고, 블로그를 찾고, 포스트의 작성자로 표시할 author를 찾아요.
게시된 포스트는 이렇게 보여요
- 아티클이 HubSpot 블로그 포스트로 만들어져 바로 게시되며, 제목, 본문, URL 슬러그, 메타 설명이 함께 들어가요.
- 커버 이미지는 포스트의 대표 이미지(featured image)로 설정돼요.
- 나중에 아티클을 수정하고 다시 게시하면 같은 HubSpot 포스트가 업데이트돼요. Clodix는 사본을 따로 만들지 않아요.
- Unpublish를 하면 HubSpot에서 포스트가 Draft로 되돌아가요. 삭제되는 것은 없어요.
블로그에는 author가 필요해요
HubSpot은 author가 지정되지 않은 포스트는 게시하지 않아요. Clodix는 연결할 때 자동으로 author를 찾고, 찾지 못했다면 게시할 때 다시 찾아요. 그러니 블로그에 아직 author가 없다면 HubSpot에서(블로그의 Settings → Authors) 하나 추가하세요. 다시 연결하지 않아도 다음 게시부터 반영돼요.
자주 발생하는 문제
| 메시지 | 의미 | 해결 방법 |
|---|---|---|
| "HubSpot rejected the token — check it has the content scope" | 토큰이 잘못되었거나 폐기되었거나, Private App에 content 스코프가 없어요. | HubSpot의 Private App에서 스코프를 다시 확인하거나 새 토큰을 생성하세요. |
| "No blog found on this HubSpot account" | 게시할 블로그가 없어요. | HubSpot에서 블로그를 만든 다음 다시 연결하세요. |
| "HubSpot needs a blog author to publish this post" | 블로그에 아직 author가 지정되지 않았어요. | HubSpot의 블로그 Settings → Authors에서 하나 추가한 다음 다시 게시하세요. 다시 연결할 필요는 없어요. |
FAQ
"content" 스코프로 Clodix가 HubSpot에서 무엇을 할 수 있나요?
블로그 포스트를 만들고, 읽고, 업데이트할 수 있어요. 그 외에는 아무것도 할 수 없어요. Clodix는 연락처, 거래, 이메일 등 HubSpot 계정의 다른 부분을 보거나 건드릴 수 없어요.
나중에 접근 권한을 취소할 수 있나요?
네. Clodix에서 Settings → Publishing integrations → HubSpot → Manage → Disconnect로 연결을 해제할 수 있고, HubSpot에서 Private App을 직접 삭제하는 것도 언제든 가능해요.