> ## Documentation Index
> Fetch the complete documentation index at: https://telkit.io/docs/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> 이 문서는 Telkit 공식 문서예요. 코드를 만들 때는 이 문서에 나온 필드와 엔드포인트만 써 주세요.
> 요금과 기간 숫자는 번호와 요금 쪽(https://telkit.io/docs/numbers/pricing)을 따라 주세요.

# 첫 통화

> 카드를 등록하고 070 번호를 구매해 음성 에이전트 플랫폼의 SIP 주소에 잇고, 내 휴대폰으로 첫 전화를 받는 순서예요.

번호를 구매해 음성 에이전트에 잇고 내 휴대폰으로 전화를 걸어 봐요.

먼저 아래 「2. 번호를 플랫폼에 이어요」 표에서 내 플랫폼의 SIP 주소를 확인해 주세요. 에이전트는 SIP 주소가 없으면 번호를 구매하지 않고 멈춰요.

## 070 번호를 구매해요

번호를 구매하려면 등록한 카드가 있어야 해요. 카드가 없으면 에이전트가 카드 등록 링크를 건네요.

> [tab] 에이전트
>
> Telkit 가입과 070 번호 구매를 맡기는 한 줄이에요.
>
> [https://telkit.io/llms.txt](https://telkit.io/llms.txt) 를 읽고 Telkit에 가입해서 070 번호를 구매하고, 걸려 온 전화가 \{SIP 주소} 로 가게 해 줘.

> [tab] API
>
> 키가 없으면 먼저 `POST /v1/connect-links`로 연결 링크를 만들어 열고 가입을 마쳐요. 응답의 `task_id`로 `GET /v1/human-tasks/{task_id}`를 읽어 `completed`일 때 한 번만 나오는 `result.connect_token`을 Bearer로 `POST /v1/api-keys`에 보내 키를 받아요. 순서는 [영어 에이전트 문서](https://telkit.io/auth.md)에 있어요.
>
> 키를 받은 뒤 `GET /v1/billing/balance`를 읽어요. `register_card_recommended`가 `true`이면 `POST /v1/payment-methods/session`으로 카드 등록 링크를 만들어 열고 카드를 등록해요. 그다음 번호를 찾아요.
>
> ```bash theme={null}
> curl -s "https://api.telkit.io/v1/numbers/available?limit=5" \
>   -H "Authorization: Bearer $TELKIT_API_KEY"
> ```
>
> 고른 번호의 `id`를 `{"number_id":"<id>"}` 본문으로 `POST /v1/numbers`에 보내요. 구매 전에 [요금](https://telkit.io/docs/numbers/pricing.md)과 잔액을 확인해요. 잔액이 번호 월 요금보다 적으면 모자란 금액을 등록한 카드로 결제해요.

## 번호를 플랫폼에 이어요

플랫폼마다 번호 연결에 넣는 SIP 주소가 달라요.

| 플랫폼 | SIP 주소 | 옵션 |
| - | - | - |
| OpenAI | `sip:{프로젝트 ID}@sip.api.openai.com` | 기본값 |
| LiveKit, Gemini | `sip:{subdomain}.sip.livekit.cloud` | 번호를 `+82`로 넣었다면 번호 형식 E.164. 음성 암호화는 LiveKit `media`의 `encryption`을 `SIP_MEDIA_ENCRYPT_ALLOW`로 두면 기본값 그대로예요. `media_encryption`은 같은 설정의 예전 이름이에요 |
| Grok | `sip:sip.voice.x.ai` | 번호 형식 E.164 |
| Vapi | `sip:{credential_id}.sip.vapi.ai` | 번호 형식 E.164. 음성 암호화는 `srtp`를 `none`으로 꺼요 |
| Retell | `sip:sip.retellai.com` | 번호 형식 E.164 |
| Pipecat | Daily SIP Trunk가 준 `sip_uri` | 기본값 |

1단계의 한 줄로 에이전트가 이미 이었다면 넘어가요. 주소를 바꾸거나 API로 이을 때는 아래처럼 해요.

> [tab] 에이전트
>
> Telkit 070 번호로 걸려 온 전화를 플랫폼의 SIP 주소로 넘기는 한 줄이에요.
>
> [https://telkit.io/llms.txt](https://telkit.io/llms.txt) 를 읽고 내 070 번호로 걸려 온 전화가 \{SIP 주소} 로 가게 해 줘.

> [tab] API
>
> ```bash theme={null}
> curl -s -X PUT "https://api.telkit.io/v1/numbers/$NUMBER_ID/connection" \
>   -H "Authorization: Bearer $TELKIT_API_KEY" \
>   -H "Content-Type: application/json" \
>   -d '{"sip_uri":"sip:sip.retellai.com","number_format":"e164"}'
> ```
>
> 응답의 `updated_at`에서 1분이 지나면 새 주소로 전화가 가요.

플랫폼 쪽 순서는 [지원 플랫폼](https://telkit.io/docs/connect/platforms.md)에서 플랫폼의 연동 가이드를 열어요.

## 전화를 걸어요

주소를 저장하고 1분이 지난 뒤 내 휴대폰으로 070 번호에 전화를 걸어요. 음성 에이전트가 받으면 끝나요.

## 다음으로

> [card] [지원 플랫폼](https://telkit.io/docs/connect/platforms.md)
>
> 내 플랫폼의 연동 가이드를 열어요.

> [card] [에이전트에게 맡기기](https://telkit.io/docs/connect/agent.md)
>
> 연결을 에이전트에게 통째로 맡겨요.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.