테스트 모드로 안전하게 구축하기

테스트 모드 API 키(ody_test_…)는 라이브 키와 동일하게 작동하지만, 비용이 발생하거나 외부 세계에 도달하는 모든 것(메시지 전송, 번호 구매, 아웃바운드 AI 통화, 에이전트 게시 및 10DLC 등록(모의 모드로 실행됨))은 시뮬레이션됩니다. 이는 개발 및 CI에 완벽하게 적합합니다.

시작하기 전에

• 키를 생성하려면 워크스페이스 관리자 또는 소유자여야 합니다.
• 테스트 모드가 무엇을 격리하고 무엇을 격리하지 않는지 알아두세요. 테스트 키는 실제 워크스페이스 데이터에 대해 작동합니다. 연락처 생성, 업데이트 및 삭제는 실제이며, 대화 상태 변경도 실제이며, 에이전트 초안 저장(PATCH /v1/api/agent)도 실제입니다. 시뮬레이션되는 것은 비용 발생 부분입니다: 전송, 번호 구매, 아웃바운드 AI 통화, 에이전트 게시 및 10DLC 등록.

단계별 안내

1. 사이드바에서 설정을 클릭한 다음 개발자 API를 클릭합니다.

2. 평소와 같이 생성 양식을 작성합니다 — 이름 및 범위 (참고: Ody API 키 가져오기).

3. 키 유형 아래에서 테스트를 선택합니다. 힌트에서 확인하듯이: 테스트 키는 실제 데이터를 읽지만 실제 문자를 보내지 않습니다 — 전송은 시뮬레이션으로 기록됩니다.

4. 키 생성을 클릭하고 일회성 배너에서 ody_test_… 비밀 키를 복사합니다.

5. 라이브 키와 동일하게 사용합니다 — 동일한 기본 URL, 엔드포인트, 범위 및 속도 제한:

curl https://api.ody.co/v1/api/messages \
  -H "Authorization: Bearer ody_test_…" \
  -H "Content-Type: application/json" \
  -d '{"to":"+15125550123","body":"CI smoke test"}'

응답은 "simulated": true가 포함된 일반 201이며, 메시지는 deliveryStatus: "simulated"와 함께 스레드에 나타납니다.

동일한 것, 시뮬레이션되는 것

동작	ody_test_… 키 사용 시

---

title: "Build safely with test mode" description: "Create an ody_test_ API key to build against real workspace data while sends, number purchases, AI calls, and 10DLC filings are simulated." keywords: ["test mode", "ody_test key", "simulated sends", "ci testing", "sandbox api"] category: developer-api order: 60 audience: [web] updated: 2026-08-17 faq:

• q: "Do test keys use a separate sandbox workspace?" a: "No — a test key reads and writes your real workspace data. Message sends, number purchases, outbound AI calls, agent publishing, and 10DLC filings are simulated; everything else behaves exactly like a live key."
• q: "How do I tell a simulated message apart?" a: "The send response includes "simulated": true, and the recorded message carries deliveryStatus "simulated" instead of queued/sent/delivered."
• q: "Do test keys work with MCP?" a: "Yes. Connect an AI assistant with an ody_test_ key and every tool works normally, but send_message records a simulated message instead of texting anyone."

---

테스트 모드 API 키(ody_test_…)는 라이브 키와 동일하게 작동하지만, 비용이 발생하거나 외부 세계에 도달하는 모든 것(메시지 전송, 번호 구매, 아웃바운드 AI 통화, 에이전트 게시 및 10DLC 등록(모의 모드로 실행됨))은 시뮬레이션됩니다. 이는 개발 및 CI에 완벽하게 적합합니다.

시작하기 전에

• 키를 생성하려면 워크스페이스 관리자 또는 소유자여야 합니다.
• 테스트 모드가 무엇을 격리하고 무엇을 격리하지 않는지 알아두세요. 테스트 키는 실제 워크스페이스 데이터에 대해 작동합니다. 연락처 생성, 업데이트 및 삭제는 실제이며, 대화 상태 변경도 실제이며, 에이전트 초안 저장(PATCH /v1/api/agent)도 실제입니다. 시뮬레이션되는 것은 비용 발생 부분입니다: 전송, 번호 구매, 아웃바운드 AI 통화, 에이전트 게시 및 10DLC 등록.

단계별 안내

1. 사이드바에서 설정을 클릭한 다음 개발자 API를 클릭합니다.

2. 평소와 같이 생성 양식을 작성합니다 — 이름 및 범위 (참고: Ody API 키 가져오기).

3. 키 유형 아래에서 테스트를 선택합니다. 힌트에서 확인하듯이: 테스트 키는 실제 데이터를 읽지만 실제 문자를 보내지 않습니다 — 전송은 시뮬레이션으로 기록됩니다.

4. 키 생성을 클릭하고 일회성 배너에서 ody_test_… 비밀 키를 복사합니다.

5. 라이브 키와 동일하게 사용합니다 — 동일한 기본 URL, 엔드포인트, 범위 및 속도 제한:

curl https://api.ody.co/v1/api/messages \
  -H "Authorization: Bearer ody_test_…" \
  -H "Content-Type: application/json" \
  -d '{"to":"+15125550123","body":"CI smoke test"}'

응답은 "simulated": true가 포함된 일반 201이며, 메시지는 deliveryStatus: "simulated"와 함께 스레드에 나타납니다.

동일한 것, 시뮬레이션되는 것

동작	ody_test_… 키 사용 시

---
title: "테스트 모드로 안전하게 구축하기"
description: "ody_test_ API 키를 생성하여 실제 워크스페이스 데이터를 기반으로 구축하되, 메시지 전송, 번호 구매, AI 통화 및 10DLC 등록은 시뮬레이션됩니다."
keywords: ["테스트 모드", "ody_test 키", "시뮬레이션된 전송", "CI 테스트", "샌드박스 API"]
category: developer-api
order: 60
audience: [web]
updated: 2026-08-17
faq:
  - q: "테스트 키는 별도의 샌드박스 워크스페이스를 사용하나요?"
    a: "아니요. 테스트 키는 실제 워크스페이스 데이터를 읽고 씁니다. 메시지 전송, 번호 구매, 아웃바운드 AI 통화, 에이전트 게시 및 10DLC 등록은 시뮬레이션되지만, 그 외의 모든 기능은 라이브 키와 동일하게 작동합니다."
  - q: "시뮬레이션된 메시지를 어떻게 구분할 수 있나요?"
    a: "전송 응답에는 \"simulated\": true가 포함되며, 기록된 메시지에는 queued/sent/delivered 대신 deliveryStatus \"simulated\"가 표시됩니다."
  - q: "테스트 키가 MCP와 함께 작동하나요?"
    a: "네. ody_test_ 키로 AI 어시스턴트를 연결하면 모든 도구가 정상적으로 작동하지만, send_message는 누구에게도 문자를 보내는 대신 시뮬레이션된 메시지를 기록합니다."
---

테스트 모드 API 키(`ody_test_…`)는 라이브 키와 동일하게 작동하지만, 비용이 발생하거나 외부 세계에 도달하는 모든 것(메시지 전송, 번호 구매, 아웃바운드 AI 통화, 에이전트 게시 및 10DLC 등록(모의 모드로 실행됨))은 **시뮬레이션**됩니다. 이는 개발 및 CI에 완벽하게 적합합니다.

## 시작하기 전에

- 키를 생성하려면 워크스페이스 **관리자 또는 소유자**여야 합니다.
- 테스트 모드가 무엇을 격리하고 무엇을 격리하지 않는지 알아두세요. 테스트 키는 **실제 워크스페이스 데이터**에 대해 작동합니다. 연락처 생성, 업데이트 및 삭제는 실제이며, 대화 상태 변경도 실제이며, 에이전트 **초안** 저장(`PATCH /v1/api/agent`)도 실제입니다. 시뮬레이션되는 것은 비용 발생 부분입니다: 전송, 번호 구매, 아웃바운드 AI 통화, 에이전트 게시 및 10DLC 등록.

## 단계별 안내

1.  사이드바에서 **설정**을 클릭한 다음 **개발자 API**를 클릭합니다.
2.  평소와 같이 생성 양식을 작성합니다 — 이름 및 범위 (참고: [Ody API 키 가져오기](/developer-api/get-your-api-key)).
3.  **키 유형** 아래에서 **테스트**를 선택합니다. 힌트에서 확인하듯이: 테스트 키는 실제 데이터를 읽지만 실제 문자를 보내지 않습니다 — 전송은 시뮬레이션으로 기록됩니다.



4.  **키 생성**을 클릭하고 일회성 배너에서 `ody_test_…` 비밀 키를 복사합니다.
5.  라이브 키와 동일하게 사용합니다 — 동일한 기본 URL, 엔드포인트, 범위 및 속도 제한:

```bash
curl https://api.ody.co/v1/api/messages \
  -H "Authorization: Bearer ody_test_…" \
  -H "Content-Type: application/json" \
  -d '{"to":"+15125550123","body":"CI smoke test"}'

응답은 "simulated": true가 포함된 일반 201이며, 메시지는 deliveryStatus: "simulated"와 함께 스레드에 나타납니다.

동일한 것, 시뮬레이션되는 것

| 동작 | ody_test_… 키 사용 시 | | :-------------------------------------- | :-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------```