> ## 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 주소 하나를 저장하고, 휴대폰으로 걸어 내 음성 에이전트가 받는지 확인할 수 있어요.

끝나면 내 070 번호로 건 전화를 내 음성 에이전트나 PBX가 받아요. 번호마다 정하는 것은 전화를 받을 SIP 주소 하나예요.

순서는 셋이에요.

1. **연결 링크**: 본인인증과 2단계 인증 6자리 코드
2. **에이전트**: SIP 주소 확인, 구매 동의, 070 구매와 SIP 주소 저장
3. **휴대폰**: 번호로 걸어 보기

## 준비물

* **휴대폰**: 번호를 처음 구매할 때 휴대폰 본인인증을 해요. 본인 명의 휴대폰으로만 인증할 수 있어요.
* **전화를 받을 SIP 주소**: 음성 에이전트나 PBX가 전화를 받는 주소예요. `sip:` 또는 `sips:`로 시작해요.

| 받는 쪽 | SIP 주소 예 |
| - | - |
| OpenAI | `sip:proj_abc123@sip.api.openai.com`. 자세한 방법은 [OpenAI 연동](https://telkit.io/docs/connect/openai.md)에 있어요 |
| LiveKit | `sip:abcd1234.sip.livekit.cloud`. LiveKit 프로젝트 설정의 SIP 주소예요 |
| 내 PBX나 SIP 서버 | `sip:agent@pbx.example.com` |

## 번호 구매와 연결

**1. 에이전트에게 연결 요청**

에이전트에게 「[https://telkit.io/llms.txt](https://telkit.io/llms.txt) 읽고 따라 해 줘」라고 말해 주세요. 에이전트가 건네는 링크에서 Google 로그인, 연결 승인, 휴대폰 본인인증과 약관 동의를 해요. 필요하면 2단계 인증 6자리 코드로 한 번 더 확인해요. 링크는 1시간 동안 열려요. 카드는 선택이에요.

**2. SIP 주소 알려 주기**

에이전트가 번호를 사기 전에 전화를 받을 SIP 주소를 물어요. 그 주소를 알려 주세요. 음성 에이전트가 아직 없으면 에이전트는 번호를 사지 않고 기다려요. 먼저 들어 보고 싶으면 [홈](https://telkit.io/#demo)의 「전화 받아보기」에서 내 휴대폰으로 데모 전화를 받아 보세요.

**3. 구매 동의**

에이전트가 고른 번호와 번호 요금, 통화 요금, 잔액에서 내는 순서, 해지 조건을 설명하고 살지 물어요. 카드 부족분 결제가 필요하면 그 금액도 함께 알려 줘요. 동의하면 에이전트가 070 번호 하나를 구매하고 번호에 SIP 주소를 저장해요. 저장하고 잠시 후부터 이 번호로 걸려 온 전화가 그 주소로 가요.

전송은 기본으로 TLS를 쓰고, 음성은 SRTP로 암호화해요. 받는 쪽이 TCP나 UDP로 받으면 주소 끝에 `;transport=tcp`처럼 붙여 저장해 주세요.

**4. 받는 쪽 준비**

SIP 주소의 서버가 이 번호로 오는 전화를 받도록 준비해 주세요. OpenAI는 프로젝트의 웹훅으로 전화가 온 것을 알리고, 내 서버가 그 전화를 받아요.

**5. 휴대폰으로 걸어 보기**

에이전트가 걸어 달라고 하면 구매한 070 번호에 휴대폰으로 전화를 걸어 주세요. 음성 에이전트가 받으면 연결이 끝난 거예요. 에이전트가 통화 기록으로 확인하고 첫 통화가 연결됐다고 알려 줘요.

## 완성 확인

에이전트가 통화 기록의 시각·방향·상대 번호를 방금 건 전화와 대조해요. 일치하는 기록을 찾지 못했다면 연결이 검증됐다고 보지 말아 주세요.

방금 통화는 **통화 기록**에도 남고, 요금 칸에 그 통화의 통신비가 보여요. 통화가 끝나고 기록되기까지 잠시 걸려요.

설정은 여기서 끝나요. 내 장비로 전화를 걸고 싶으면 에이전트에게 따로 부탁해 주세요. 방법은 [지원 플랫폼](https://telkit.io/docs/connect/platforms.md)에서 내 플랫폼의 연동 가이드를 열어 확인해요.

## 처음 막히는 곳

> [accordion] 전화가 음성 에이전트로 넘어오지 않아요
>
> **원인**: 전화는 저장한 SIP 주소로 넘어가고, 그 주소의 서버가 받아야 통화가 시작돼요. 통화 기록에 연결 실패가 남을 때도 원인이 같아요.
>
> **해결**: 아래를 순서대로 확인해 주세요.
>
> 1. 번호에 저장한 SIP 주소가 받는 쪽 서버의 주소와 같은가요?
> 2. 저장하고 잠시 기다렸나요? 저장 직후 걸려 온 전화는 아직 그 주소로 가지 않을 수 있어요.
> 3. **통화 기록**의 SIP 코드를 확인해 주세요. 404는 주소, 403은 받는 쪽의 허용 설정, 486과 603은 받는 쪽의 거절이에요.
> 4. 받는 쪽이 TLS와 SRTP 음성 암호화로 받나요? TCP나 UDP로 받는다면 주소 끝에 `;transport=tcp`처럼 붙여 다시 저장해 주세요.
> 5. OpenAI로 받는다면 웹훅 서버가 `accept`를 보냈는지 확인해 주세요. [OpenAI 연동](https://telkit.io/docs/connect/openai.md)

> [accordion] 방금 건 전화가 통화 기록에 없어요
>
> **원인**: 통화는 끝난 뒤에 기록돼요. 통화가 끝나고 API에서 조회되기까지 잠시 걸려요.
>
> **해결**: 통화가 끝나고 잠시 후 에이전트에게 다시 확인해 달라고 해 주세요. 그래도 없으면 전화를 건 번호가 맞는지, 번호 상태가 수신을 받는 상태인지 확인해 주세요.

> [accordion] 번호를 더 구매할 수 없어요
>
> 한 계정에는 번호 하나만 구매할 수 있어요. 해지 예약·보관·정지 중에도 번호가 회수될 때까지 새로 구매할 수 없어요.
>
> 번호가 회수되면 에이전트에게 새 번호 구매를 요청할 수 있어요. 구매할 때의 요금은 [번호와 요금](https://telkit.io/docs/numbers/pricing.md)에 있어요.

> [accordion] 「이미 다른 계정에서 본인인증한 정보예요」가 나와요
>
> **원인**: 한 사람은 계정을 하나만 쓸 수 있어요. 같은 휴대폰 명의로 다른 계정에서 이미 본인인증을 했어요.
>
> **해결**: 처음 본인인증한 계정으로 로그인해 주세요. 그 계정을 쓸 수 없으면 [support@telkit.io](mailto:support@telkit.io)로 문의해 주세요.

## 다음 단계

* [OpenAI 연동](https://telkit.io/docs/connect/openai.md): OpenAI SIP 주소와 받는 쪽 준비
* [지원 플랫폼](https://telkit.io/docs/connect/platforms.md): 플랫폼별 수신과 발신 연동 가이드
* [번호와 요금](https://telkit.io/docs/numbers/pricing.md): 요금, 결제일, 번호 상태


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