> ## 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)을 따라 주세요.

# 문제 해결

> 링크가 닫혔거나 수신 전화가 연결되지 않거나 발신이 거절되고 통화가 막힐 때 원인과 할 일을 증상별로 찾아요.

## 링크가 닫혔어요

에이전트가 건넨 링크는 만든 뒤 정해진 시간 동안만 열려요. 새 링크를 받으면 앞 링크는 닫혀요.

에이전트에게 새 링크를 요청해 주세요.

## 수신 전화가 연결되지 않아요

Telkit은 번호에 저장한 SIP 주소로 전화를 넘기고, 그 주소의 음성 에이전트 플랫폼이 받아야 통화가 시작돼요. 주소가 다르거나, 저장한 주소가 아직 반영되지 않았거나, 받는 쪽이 Telkit의 전화를 막거나 전송·암호화·번호 형식이 맞지 않으면 연결되지 않아요.

**1. 주소와 시간을 확인해요**

번호에 저장한 SIP 주소가 플랫폼이 준 주소와 같은지, 저장하고 1분이 지났는지 봐요. 저장 직후에 건 전화는 통화 중으로 끝날 수 있어요.

**2. 받는 쪽이 Telkit을 허용하는지 봐요**

Telkit은 아이디와 비밀번호를 보내지 못해요. 받는 쪽이 Telkit IP를 허용하거나 인증 없이 받아야 해요. IP와 포트는 내 플랫폼 연동 가이드의 수신 절에 있어요.

**3. 전송·암호화·번호 형식을 맞춰요**

내 플랫폼에 맞는 값은 [첫 통화](https://telkit.io/docs/connect/first-call.md#connect)의 표에 있어요. 받는 쪽이 SRTP를 받지 않으면 음성 암호화를 끄고, `+82`로 시작하는 번호만 받으면 번호 형식을 E.164로 바꿔 달라고 에이전트에게 요청해 주세요.

**4. 통화 기록의 SIP 코드를 봐요**

에이전트에게 그 통화의 SIP 코드와 결과 문구를 확인해 달라고 해 주세요. 404는 주소, 401과 403은 받는 쪽의 허용 설정, 488은 음성 암호화나 오디오 설정을 봐요. OpenAI로 받는다면 웹훅 서버가 전화를 수락했는지도 봐요. 방법은 [OpenAI 연동](https://telkit.io/docs/connect/openai.md)에 있어요.

## 발신이 거절돼요

Telkit은 발신마다 사용자 이름과 비밀번호, 보내는 번호, 오디오, 받는 번호를 확인하고 맞지 않으면 거절해요. 거절 사유는 SIP 응답의 `Reason` 헤더에 들어 있어요.

**1. 반영을 기다려요**

비밀번호를 만들거나 새로 만들고 1 \~ 2분이 지났는지 봐요.

**2. 접속 값을 맞춰요**

사용자 이름과 비밀번호가 에이전트가 건네준 값과 같은지 봐요. 비밀번호를 잃었으면 에이전트에게 새로 만들어 달라고 해 주세요. 새로 만들면 앞 비밀번호는 쓸 수 없어요.

**3. 보내는 번호와 오디오를 봐요**

보내는 번호가 내 070 번호인지, 오디오에 G.711인 `PCMA`나 `PCMU`가 들어 있는지 봐요. Opus만 켜 두면 거절돼요.

**4. 받는 번호를 봐요**

국내 휴대폰, 유선전화, 070 번호로만 걸 수 있어요. 국제전화, 060·080 같은 서비스 번호, 긴급 신고 번호는 막혀요.

사유가 한도이거나 동시 통화라면 [통화가 막혀요](#calls-blocked)를 봐 주세요.

## 발신 접속 정보를 만들 수 없어요

발신 접속 정보는 번호의 발신이 열린 뒤에만 만들어요. 카드가 없거나, 발신을 여는 중이거나, 이미 비밀번호가 있으면 만들 수 없어요.

* **카드가 없을 때**: 에이전트가 건넨 카드 등록 링크를 열어 카드를 등록해 주세요.
* **발신을 여는 중일 때**: 1분쯤 기다렸다가 에이전트에게 다시 만들어 달라고 해 주세요.
* **이미 비밀번호가 있을 때**: 장비에 넣어 둔 비밀번호를 그대로 써요. 잃었으면 에이전트에게 새로 만들어 달라고 해 주세요.
* **번호가 멈췄을 때**: [통화가 막혀요](#calls-blocked)를 봐 주세요.

## 통화가 막혀요

발신 한도나 동시 통화에 닿았거나, 잔액이 바닥났거나, 번호 월 요금을 결제하지 못했거나, 이용이 정지되면 새 통화가 막혀요. 동시 통화가 꽉 차면 거는 쪽은 `486`을 받는데, 상대가 통화 중일 때와 코드가 같아서 `Reason`의 `concurrency`로 구분해요.

* **한도와 동시 통화**: 숫자와 다시 열리는 때는 [한도와 동시 통화](https://telkit.io/docs/numbers/limits.md)에 있어요. 진행 중인 통화가 끝나거나 한도를 다시 세면 다시 걸 수 있어요.
* **잔액**: 에이전트가 건넨 충전 링크로 잔액을 채워 주세요. 충전하면 바로 다시 열려요.
* **번호 월 요금 결제 실패**: 등록한 카드를 확인하고 결제해 주세요. 기한은 [번호와 요금](https://telkit.io/docs/numbers/pricing.md#결제에-실패할-때)에 있어요.
* **이용 정지**: [support@telkit.io](mailto:support@telkit.io)로 문의해 주세요.

## 에이전트가 요청이 많다며 기다려요

짧은 시간에 API를 너무 많이 부르면 Telkit이 잠시 거절하고 기다릴 시간을 알려 줘요.

에이전트가 그 시간만큼 기다리면 다시 돼요. 계속되면 같은 요청을 되풀이하는 자동화가 없는지 봐 주세요. 규칙은 [한도와 동시 통화](https://telkit.io/docs/numbers/limits.md)에 있어요.

## 자주 묻는 문제

> [accordion] SIP 주소를 저장할 수 없어요
>
> **원인**: SIP 주소 모양이나 호스트가 규칙에 맞지 않아요. 주소는 `sip:` 또는 `sips:`로 시작하는 `[사용자@]호스트[:포트]`이고, 호스트는 도메인 이름이나 공인 IPv4 주소예요.
>
> **해결**: 받는 곳의 SIP 주소를 앞뒤 공백 없이 그대로 넣어 주세요. OpenAI 프로젝트라면 `sip:<프로젝트 ID>@sip.api.openai.com`이에요.

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

> [accordion] 같은 사람에게 전화가 두 번 걸렸어요
>
> **원인**: 내 장비나 에이전트가 시간 초과나 연결 실패 뒤에 새 통화를 만들어 다시 걸면 전화가 한 번 더 가요. 트렁크로 보내는 새 통화 요청은 보낼 때마다 통화를 새로 만들어요. SIP 장비가 같은 INVITE를 다시 보내는 재전송과 인증 요청에 아이디와 비밀번호를 붙여 다시 보내는 INVITE는 같은 통화의 연결 절차라서 통화가 더 생기지 않아요.
>
> **해결**: 시간 초과나 연결 실패 뒤에 에이전트나 앱이 새 통화를 자동으로 만들지 않게 해 주세요. 다시 걸지는 번호의 통화 기록과 결과를 보고 정해 주세요. SIP 장비의 재전송과 인증 재시도 설정은 그대로 두어도 돼요.

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

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

## 해결되지 않으면

[support@telkit.io](mailto:support@telkit.io)로 문의해 주세요. 번호, 통화한 시각, 에이전트가 알려 준 SIP 코드를 함께 보내 주면 빨리 찾을 수 있어요.


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