개발자 API

귀사의 비즈니스 폰,
이제 프로그래밍 가능합니다.

Ody 워크스페이스의 모든 연락처, 대화, 메시지, 통화를 하나의 깔끔한 REST API로 관리하세요 | AI 비서용 MCP 서버, 서명된 웹훅, SDK도 제공됩니다. 단 하나의 키로 몇 분 만에 생성됩니다.

Bearer 인증 · ody_live_ 및 ody_test_ 키 · 설정 → 개발자 API

send-sms.sh | 첫 API 호출
# Ody 번호로 SMS 보내기
curl https://api.ody.co/v1/api/messages \
-H "Authorization: Bearer ody_live_…" \
-H "Idempotency-Key: order-1042-shipped" \
-d '{"to": "+15125550123", "body": "Your order shipped!"}'
201 Created
{
"conversationId": "b4a6f0…",
"message": { "body": "Your order shipped!" },
"simulated": false
}
POST /messages에 대한 Idempotency-Key | 24시간 이내 재시도는 첫 응답을 다시 재생합니다
모든 목록 엔드포인트에 커서 페이지네이션 | nextCursor를 따라가면 어떤 행도 놓치지 않습니다
표준 RateLimit-Limit / -Remaining / -Reset 헤더, 429 오류 시 Retry-After
균일한 JSON 오류 엔벨로프, 모든 응답에 X-Request-Id 에코 포함

플랫폼

Ody에서 구축하는 데 필요한 모든 것

여섯 가지 요소, 하나의 API 키. 가장 좋은 방식으로 지루하게 느껴지도록 설계되었습니다: 예측 가능한 리소스, 예측 가능한 오류, 예측 가능한 페이지.

REST API

연락처 CRUD, 대화, SMS/MMS 전송, 메시지 검색, 통화 기록 및 전화번호를 https://api.ody.co/v1/api에서 제공합니다 | ody_live_ 키로 Bearer 인증됩니다.

GET /v1/api/contacts

AI 비서용 MCP

ChatGPT, Claude 또는 Cursor를 https://api.ody.co/v1/mcp에 연결하면 귀하의 비서는 11가지 도구(연락처 목록 및 업데이트, 대화 읽기, 메시지 검색, 문자 전송)를 얻게 되며, 이는 귀하의 키에 의해 범위가 지정됩니다.

11 tools · /v1/mcp

서명된 웹훅

Standard-Webhooks HMAC 서명이 적용된 아웃바운드 웹훅 | webhook-id, webhook-timestamp, webhook-signature 헤더 | 자동 재시도 및 언제든지 변경 가능한 엔드포인트별 비밀 키를 제공합니다.

webhook-signature: v1,…

테스트 모드

ody_test_ 키는 라이브 키와 똑같이 작동하지만 메시지 전송은 시뮬레이션됩니다 | 실제 SMS는 전송되지 않습니다. CI를 프로덕션에 연결하고 편안하게 주무세요.

"simulated": true

TypeScript 및 Python SDK

자동 페이지네이션, 타입 지정 오류, 멱등성 전송, 웹훅 서명 확인 기능이 내장된 공식, 완전 타입 지정 클라이언트 | 따라서 다시는 HMAC를 직접 구현할 필요가 없습니다.

await ody.messages.send(…)

OpenAPI 3.1

전체 인터페이스는 /v1/api/openapi.json에서 하나의 기계 판독 가능한 사양으로 설명됩니다 | 클라이언트, 모의 서버를 생성하거나 AI 코딩 에이전트에 제공할 수 있습니다.

GET /v1/api/openapi.json

최소 권한

명령한 대로만 작동하는 키

Ody 앱의 설정 → 개발자 API에서 키를 생성하고 각 키를 통합에 필요한 정확한 범위로 제한하세요 | 연락처, 대화, 메시지, 번호, 웹훅에 걸쳐 7가지 범위가 있습니다. 읽기 전용 대시보드 키는 고객에게 문자를 보낼 수 없습니다.

ody_live_… · 범위 지정 키
✓contacts:read
✕contacts:write
✓conversations:read
✕conversations:write
✓messages:send
✓numbers:read
✕webhooks:manage

모델 컨텍스트 프로토콜

한 블록을 붙여넣으면, 귀하의 AI가 전화 업무를 처리합니다

동일한 API 키로 MCP 서버를 구동합니다. 이 구성을 ChatGPT, Claude 또는 Cursor에 넣고 비어 있는 대화를 확인하거나, 답장을 작성하거나, 고객에게 문자를 보내도록 AI 비서에게 요청하세요. | 각 호출은 키가 허용하는 범위 내에서 이루어집니다.

MCP 서버 살펴보기→
mcp.json
{
"mcpServers": {
"ody": {
"url": "https://api.ody.co/v1/mcp",
"headers": {
"Authorization": "Bearer ody_live_…"
}
}
}
}

개발 시작

처음부터 첫 SMS까지 5분 만에

키를 발급받고, curl 호출 한 번으로 문자를 보낼 수 있습니다. 전체 API 참조, 웹훅 가이드, SDK 빠른 시작 가이드는 도움말 센터에 있습니다.

API 키는 작업 공간 소유자 및 관리자가 설정 → 개발자 API에서 생성합니다.

자주 묻는 질문

개발자 질문에 대한 답변

현재 API로 무엇을 할 수 있나요?
연락처 CRUD 전체 기능; 대화 목록을 확인하고 읽으며 상태 설정; SMS 및 MMS 전송; 메시지 기록 검색; 통화 및 음성 메일 기록을 스크립트와 함께 가져오기; 그리고 워크스페이스의 전화번호 목록 확인. 전체 참조 자료는 help.ody.co의 개발자 문서에서 확인할 수 있습니다.

스택과 함께 더 나은 경험

API는 전체 표면입니다. 통합은 코드 없는 경로입니다.

범위가 지정된 키, 웹훅 및 SDK는 구축하려는 모든 것을 다룹니다. Slack, Make 및 CSV는 대부분의 팀이 작성할 필요가 없는 작업을 처리합니다.

단 한 명의 고객도 놓치지 마세요.

번호를 포팅하고, 몇 분 안에 에이전트를 훈련시키고, 회선을 자동 조종 모드로 전환하세요. 아니면 AI를 완전히 꺼두세요. 선택은 당신의 몫입니다.