Ody API 키 받기
API 키는 설정 → 개발자 API에서 생성합니다. 키 이름을 지정하고, 범위를 선택하고, 라이브 또는 테스트를 선택한 다음, 키 생성을 클릭하고, 일회성 배너에서 비밀 키를 복사하세요.
시작하기 전에
- 키를 생성하거나 해지하려면 워크스페이스 관리자 또는 소유자여야 합니다.
- 키는 키를 생성한 멤버의 권한으로 작동합니다. 앱에서 해당 멤버가 할 수 있는 것 이상은 할 수 없습니다.
단계별 안내
사이드바에서 설정을 클릭한 다음, 개발자 API를 클릭합니다. (휴대폰에서는: 더보기 → 설정 → 개발자 API)
생성 양식에 키 이름을 입력합니다. 예를 들어 "Zapier" 또는 "프로덕션 서버"와 같이 입력하여 나중에 키를 구분할 수 있도록 합니다.
이름 필드 아래의 칩을 사용하여 키의 범위를 선택합니다. 10개 모두 미리 선택되어 있으며, 이는 전체 액세스 키를 만듭니다. 칩을 선택 해제하여 범위를 좁힐 수 있습니다. 사용 가능한 범위는 연락처 읽기, 연락처 관리, 대화 읽기, 대화 업데이트, 메시지 보내기, 번호 읽기, 웹훅 관리, 번호 및 10DLC 구매, AI 통화 걸기, AI 에이전트 관리입니다.
키 유형에서 라이브 또는 테스트를 선택합니다. 라이브 키는
ody_live_로 시작하며 모든 것을 실제와 같이 수행합니다. 테스트 키는ody_test_로 시작하며 실제 데이터를 읽지만, 메시지 전송은 시뮬레이션으로 기록되며 전송되지 않습니다. 이는 빌드 및 CI에 완벽합니다. 테스트 모드로 안전하게 빌드하기를 참조하세요.키 생성을 클릭합니다.
녹색 배너에서 키를 복사합니다 — "새 키를 지금 복사하세요 — 다시 볼 수 없습니다." Ody는 해시만 저장하므로 일반 텍스트는 정확히 한 번만 표시됩니다.
키를 비밀번호처럼 저장하세요. 비밀 관리자 또는 환경 변수에 저장하고, 클라이언트 측 코드나 공유 문서에는 절대 저장하지 마세요.
기존 키 관리
생성 양식 아래에는 각 키가 이름, 마스킹된 힌트(ody_live_…WXYZ 또는 ody_test_…WXYZ), 테스트 키에 대한 테스트 배지, 칩 형태의 범위(제한이 없을 경우 "전체 액세스"), 그리고 마지막 사용 시기와 함께 나열됩니다. 해지를 클릭하면 키가 즉시 비활성화됩니다. 해지된 키는 즉시 인증을 중단하며 복원할 수 없습니다.
관련 문서
자주 묻는 질문
API 키를 잃어버렸습니다. 다시 볼 수 있나요?
아니요. 전체 키는 생성 시점에 정확히 한 번만 표시됩니다. 잃어버린 키를 해지하고 새 키를 생성하세요.
라이브 키와 테스트 키의 차이점은 무엇인가요?
라이브 키(ody_live_…)는 실제 문자를 보냅니다. 테스트 키(ody_test_…)는 동일하게 작동하지만 메시지 전송은 시뮬레이션됩니다. 즉, 스레드에 기록되지만 전송되지는 않습니다.
누가 API 키를 생성할 수 있나요?
워크스페이스 관리자 및 소유자입니다. 키는 키를 생성한 멤버의 권한으로 작동합니다.
어떤 요금제에 API가 포함되어 있나요?
모든 요금제에 포함됩니다. API와 MCP는 Starter 요금제부터 포함됩니다.