1AI 글쓰기 설정 — Claude API Key

AI가 게시글을 써 주고, 상품 상세설명에서 정보를 뽑아 주는 기능에 쓰입니다. 키는 비밀번호처럼 다뤄야 하며, 사용한 만큼 비용이 발생합니다.

A. Anthropic 계정 만들기

1. console.anthropic.com에 접속합니다. (Claude 앱 주소가 아니라 console이 들어간 주소입니다.)
2. 이메일 또는 구글 계정으로 가입/로그인합니다. 이메일 인증 메일이 오면 링크를 눌러 인증합니다.
3. 이름·조직(개인이면 본인 이름이나 사이트명)을 입력하고 약관에 동의합니다.

B. 결제 수단 등록과 크레딧 충전

1. 왼쪽(또는 상단) 메뉴에서 Settings → Billing(결제)으로 이동합니다.
2. 신용/체크카드를 등록하고 크레딧을 충전합니다. 처음에는 소액(몇 달러)으로 시작해도 충분합니다. 최소 충전 금액은 화면에 표시됩니다.
3. 선택: 월 사용 한도를 설정해 두면 예상치 못한 과금을 막을 수 있습니다.

C. API 키 발급

1. API Keys 메뉴(주소: console.anthropic.com/account/keys)로 이동합니다.
2. Create Key 버튼을 누르고, 알아보기 쉬운 이름(예: myoc-사이트이름)을 입력합니다.
3. 화면에 sk-ant-api03-…으로 시작하는 긴 키가 나타납니다. 복사 버튼으로 복사하세요.

D. 우리 사이트 환경설정에 등록

1. 관리자 화면에서 환경설정 → AI / API 설정 탭을 엽니다.
2. 맨 위 "AI 글쓰기 버튼 표시 및 기능 활성화"를 체크합니다.
3. Claude API Key 칸에 복사한 키를 붙여넣습니다. (눈 모양 버튼을 누르면 입력한 내용을 확인할 수 있습니다.)
4. 연결 테스트 버튼을 누릅니다. 초록색 성공 메시지가 나오면 정상입니다.
5. 맨 아래 AI / API 설정 저장을 누릅니다.

문제가 생기면

2Gemini API Key — 썸네일 · 인포그래픽 생성

AI 글쓰기에서 "썸네일 생성 / 인포그래픽 생성"을 체크하거나, 게시물 수정 화면의 생성 버튼을 누를 때 쓰입니다. 글쓰기(텍스트)는 Claude, 이미지는 Gemini가 맡습니다.

A. 키 발급

1. aistudio.google.com/apikey에 접속해 구글 계정으로 로그인합니다.
2. 처음이면 이용약관 동의 창이 뜹니다. 동의하고 계속합니다.
3. API 키 만들기(Create API key) 버튼을 누릅니다.
4. 프로젝트를 고르라는 창이 나오면 기존 프로젝트를 선택하거나 새 프로젝트를 만듭니다. (잘 모르면 새로 만들기를 선택하세요.)
5. AIza…로 시작하는 키가 생성됩니다. 복사합니다. 목록에서 언제든 다시 볼 수 있습니다.

B. 환경설정에 등록

1. 환경설정 → AI / API 설정 탭에서 Gemini API Key 카드를 찾습니다.
2. 키를 붙여넣고 연결 테스트를 누릅니다. 성공 메시지가 나오면 정상입니다.
3. 선택: 인포그래픽 스타일 칸에 원하는 글꼴/색 느낌을 적을 수 있습니다. 비워 두면 기본값(명조체 계열)이 쓰입니다. {primary_color}라고 적으면 사이트 기본 색상으로 자동 치환됩니다.
4. AI / API 설정 저장을 누릅니다.

문제가 생기면

SNS 연동 공통 안내 (3~7번 공통)

SNS 연동은 같은 화면, 같은 방식입니다.

1. 환경설정 → AI / API 설정 탭 맨 아래 "SNS 간편 연동" 카드로 이동합니다.
2. 연결할 서비스 줄 오른쪽의 연동하기 버튼을 누릅니다.
3. 해당 서비스의 로그인/승인 화면으로 이동합니다. 본인 계정으로 로그인하고 허용(계속)을 누릅니다.
4. 자동으로 우리 사이트로 돌아오고 "연동이 완료되었습니다." 메시지와 함께 계정 이름이 초록색으로 표시됩니다.

연동 후 글 올리는 방법

1. 게시물 상세 화면의 SNS 버튼(서비스별)을 누릅니다.
2. 창에서 내용(문구·제목 등)을 입력하고 올리기를 누릅니다.
3. Instagram 카드뉴스는 글 수정 화면에서 카드뉴스 이미지를 먼저 첨부해야 하고, 릴스·YouTube·TikTok은 영상을 먼저 첨부해야 합니다.

3Facebook 페이지

게시는 개인 프로필이 아니라 "페이지"에 올라갑니다. 페이지가 없다면 먼저 만들어야 합니다.

A. Facebook 계정과 페이지 만들기

1. facebook.com에서 개인 계정을 만들고 로그인합니다. (이미 있으면 건너뜁니다.)
2. facebook.com/pages/create로 이동하거나, 홈에서 메뉴(⋯) → 페이지 → 새 페이지 만들기를 누릅니다.
3. 페이지 이름(상호나 사이트명), 카테고리(예: 쇼핑 및 소매, 비영리 단체 등), 소개를 입력하고 페이지 만들기를 누릅니다.
4. 프로필 사진과 커버 사진을 올립니다. (필수는 아니지만 신뢰도에 도움이 됩니다.)

B. 우리 사이트에 연동

1. 환경설정 → AI / API 설정 → SNS 간편 연동 → Facebook 페이지 → 연동하기
2. Facebook 로그인 창이 열리면 로그인합니다.
3. "~로 계속" 화면이 나오면 연결할 페이지를 선택하고(여러 개면 사용할 페이지에 체크), 요청되는 권한을 모두 허용합니다.
4. 사이트로 돌아오면 연결할 페이지가 여러 개인 경우 페이지 선택 화면이 나옵니다. 사용할 페이지를 골라 선택합니다.

문제가 생기면

4Instagram 비즈니스 계정

Instagram은 별도의 [연동하기] 버튼이 없습니다. 인스타그램 계정이 Facebook 페이지에 연결되어 있으면, 3번 Facebook 연동 때 자동으로 함께 연동됩니다. 릴스 등록도 같은 연동을 씁니다.

A. 인스타그램 계정 만들기

1. 휴대폰에서 Instagram 앱을 설치하고 가입합니다. 이미 계정이 있으면 건너뜁니다.
2. 사용자 이름(아이디)과 프로필 사진을 설정합니다.

B. 프로페셔널(비즈니스) 계정으로 전환

1. 앱에서 프로필 → ≡ 메뉴 → 설정 및 활동으로 이동합니다.
2. 계정 유형 및 도구(또는 프로페셔널 계정으로 전환)를 누릅니다.
3. 비즈니스를 선택하고 카테고리를 고른 뒤 안내에 따라 완료합니다. (크리에이터 계정으로도 표시될 수 있으나 비즈니스를 권장합니다.)

C. Facebook 페이지와 연결

1. Instagram 앱 프로필 → 프로필 편집 → 페이지(또는 공개 비즈니스 정보 → 페이지)를 누릅니다.
2. 기존 페이지 연결을 선택해 3번에서 만든 페이지를 고릅니다. 페이지가 없다면 새 페이지 만들기를 선택해도 됩니다.
3. 이때 로그인하는 Facebook 계정은 그 페이지의 관리자여야 합니다.

D. 연동

1. 위 A~C가 끝난 뒤 3번 Facebook 연동을 진행합니다. 이미 연동해 두었다면 연동 해제 → 다시 연동하기를 한 번 하세요. (연결 순서가 뒤바뀌면 인스타그램이 인식되지 않을 수 있습니다.)
2. 승인 화면에서 Instagram 계정 관련 권한도 허용합니다.

올리기 전에 알아 둘 점

• 카드뉴스(사진): 글 수정 화면에서 카드뉴스 이미지를 먼저 첨부해야 합니다.
• 릴스(영상): 글 수정 화면에서 영상을 먼저 첨부해야 하며, 처리 시간이 걸릴 수 있습니다.
• 개인(일반) 계정은 API로 게시할 수 없습니다. 반드시 위 B단계의 프로페셔널 계정이어야 합니다.

문제가 생기면

5Threads

Threads는 Instagram 계정으로 가입합니다. 연동 방식은 Facebook과 별개이므로 Threads 줄의 [연동하기]를 따로 눌러야 합니다.

A. 계정 만들기

1. 휴대폰에서 Threads 앱을 설치합니다. (threads.net에서도 시작할 수 있습니다.)
2. Instagram으로 로그인을 눌러 인스타그램 계정으로 가입합니다. 프로필 정보를 가져올지 묻는 화면이 나옵니다.
3. 프로필 공개 범위를 공개 프로필로 선택합니다. (비공개면 게시물이 일반에 보이지 않습니다.)

B. 연동

1. SNS 간편 연동 → Threads → 연동하기
2. Threads(Instagram) 계정으로 로그인한 뒤 허용을 누릅니다. 요청 권한은 "프로필 보기"와 "게시물 올리기" 두 가지입니다.

문제가 생기면

6YouTube

영상을 내 YouTube 채널에 업로드합니다. 채널이 있어야 연동됩니다. 채널 없이 구글 계정만 있으면 no_channel 오류가 납니다.

A. 구글 계정과 채널 만들기

1. 구글 계정이 없다면 accounts.google.com/signup에서 만듭니다.
2. youtube.com에 로그인합니다.
3. 오른쪽 위 프로필 사진 → 채널 만들기를 누릅니다.
4. 채널 이름·프로필 사진을 정하고 채널 만들기를 눌러 완료합니다. 사이트를 대표하는 이름으로 브랜드 채널로 만들어 두면 관리하기 편합니다.

B. 연동

1. SNS 간편 연동 → YouTube → 연동하기
2. 구글 로그인 창에서 채널이 있는 계정을 선택합니다.
3. "확인되지 않은 앱" 경고가 뜨면 고급 → (앱 이름)으로 이동을 눌러 계속합니다. (운영 관리자가 앱 인증을 마치면 이 경고는 사라집니다.)
4. "동영상 업로드"와 "채널 정보 보기" 권한 요청에서 모두 허용 → 계속을 누릅니다.

문제가 생기면

7TikTok

영상을 TikTok에 올립니다. 연동 앱 심사가 끝나기 전에는 바로 공개되지 않고 틱톡 앱의 임시보관함으로 전송됩니다.

A. 계정 만들기

1. 휴대폰에서 TikTok 앱을 설치하고 휴대폰 번호/이메일/구글 등으로 가입합니다.
2. 사용자 이름과 프로필 사진을 설정합니다.

B. 연동

1. SNS 간편 연동 → TikTok → 연동하기
2. TikTok 로그인 화면에서 로그인합니다. (QR 코드로 TikTok 앱에서 로그인하는 방법이 가장 쉽습니다.)
3. "기본 프로필 정보", "영상 게시/업로드" 권한 요청에서 허용을 누릅니다.

C. 올린 뒤 확인

1. 게시물에서 TikTok 올리기를 실행합니다. (영상을 먼저 첨부해야 합니다.)
2. 심사 전에는 TikTok 앱에 알림 → 시스템 알림(임시보관함) 형태로 도착합니다. 앱에서 열어 설명·공개 범위를 확인하고 직접 게시하세요.

연동 실패 코드 한눈에 보기

연동에 실패하면 화면 위에 연동에 실패했습니다 (…)라고 이유가 표시됩니다.

운영 관리자(마스터)용 사전 준비

테넌트가 [연동하기] 버튼만으로 연결되려면, 운영 관리자가 각 서비스에 앱을 한 번씩 만들어 두고 값을 등록해야 합니다. 테넌트에게는 보이지 않는 작업입니다.

1) 등록 위치와 값

최고관리자 → 전체 설정(글로벌 설정) 화면에 다음 값을 입력합니다. 각 항목 아래에 리디렉션 URI 주소가 자동으로 표시되니 그대로 복사해 서비스 콘솔에 등록하세요.

2) 요청하는 권한(코드 기준)

3) 개발 모드 ↔ 심사 후(공개) 차이

• Meta(Facebook·Instagram·Threads): 앱이 개발 모드면 앱 역할(관리자/개발자/테스터)에 등록된 계정만 로그인 가능합니다. Threads는 앱 대시보드에서 Threads 테스터로 초대하고, 초대받은 사람이 Threads 설정에서 수락해야 합니다. 일반 테넌트에게 공개하려면 위 권한들에 대한 앱 검수(App Review)와 비즈니스 인증이 필요합니다.
• Google(YouTube): OAuth 동의 화면이 "테스트" 상태면 테스트 사용자로 등록된 이메일만 허용됩니다. 업로드 권한은 민감한 범위라 공개하려면 앱 인증이 필요하고, API 서비스 감사 전에는 업로드 영상이 비공개로 제한될 수 있습니다.
• TikTok: 앱 심사(Content Posting API 감사) 전에는 임시보관함 전송과 테스트 계정 제한이 있습니다.

4) 테넌트 연동 요청이 왔을 때 체크리스트

1. 해당 서비스의 앱이 개발 모드인가? → 테넌트 계정을 테스터/테스트 사용자로 등록하고 수락을 안내.
2. Instagram이 안 잡히는가? → 테넌트의 인스타그램이 프로페셔널 계정이고 Facebook 페이지에 연결되었는지 확인.
3. token_exchange_failed가 반복되는가? → 글로벌 설정의 앱 ID/시크릿, 리디렉션 URI(주소 끝 슬래시·http/https까지 정확히 일치) 재확인.