개발자 API
API 키, 공개 REST API 및 AI 통합을 위한 MCP 서버.
Ody API 키 받기
설정 → 개발자 API에서 Ody API 키를 생성, 범위 지정 및 해지하세요. 라이브 또는 테스트 모드를 선택하세요. 키는 한 번만 표시되므로 즉시 복사해야 합니다.
API 개요 및 인증
api.ody.co에서 Bearer 키를 사용하여 Ody REST API를 호출하세요: 연락처, 대화, 메시지, 전화번호 및 10DLC, AI 통화, AI 에이전트, 웹훅.
MCP로 AI 도구 연결
Ody를 MCP 서버로 추가하여 ChatGPT, Claude, Cursor가 받은 편지함을 관리하고, 문자를 보내고, 번호를 구매하고, AI 통화를 걸고, AI 에이전트를 관리할 수 있도록 합니다.
API를 통해 번호 구매 및 문자 메시지 등록
Ody API 또는 MCP를 통해 전화번호를 검색하고 구매하며 10DLC 메시지 등록을 신청하세요. 앱과 동일한 청구, 게이트 및 계정을 사용합니다.
API를 통해 AI 통화 걸기 및 Astra 관리
POST /calls를 사용하여 Astra가 전화를 걸고, AI 에이전트를 구성 및 게시하며, Ody REST API 또는 MCP 도구를 통해 번호를 연결합니다.
API 속도 제한 및 모범 사례
모든 Ody API 키는 분당 600개의 요청을 처리합니다. RateLimit 헤더를 읽고, 429 오류 시 백오프하며, 다음 주요 보안 모범 사례를 따르세요.
웹훅 수신 및 서명 확인
Ody API를 통해 HTTPS 웹훅 엔드포인트를 등록하고, message.received와 같은 이벤트를 구독하며, whsec_ 비밀 키로 서명된 전달을 확인합니다.
테스트 모드로 안전하게 구축하기
ody_test_ API 키를 생성하여 실제 워크스페이스 데이터를 기반으로 구축하되, 메시지 전송, 번호 구매, AI 통화 및 10DLC 등록은 시뮬레이션됩니다.
페이지네이션, 멱등성, 오류 처리
커서를 사용하여 Ody API 목록을 페이지별로 탐색하고, Idempotency-Key 헤더로 안전하게 전송을 재시도하며, 통일된 오류 엔벨로프와 요청 ID를 처리하는 방법입니다.
SDK 빠른 시작: TypeScript 및 Python
Ody의 TypeScript 및 Python SDK를 사용하여 메시지 전송, 번호 구매, AI 통화 걸기, 에이전트 관리, 페이지 매김 및 웹훅 확인을 시작하세요.