모든 SIP 제공업체의 트렁크를 Wixzel Voice에 연결하기
어느 통신사의 번호로든 AI 음성 에이전트를 운영하려면 통신사의 SIP 트렁크를 Wixzel Voice에 연결합니다. 발신 통화가 수락되도록 트렁크가 반환하는 platform_ip를 허용 목록에 추가하고, 수신 통화는 트렁크의 origination_uri로 보냅니다. 회선 요금은 통신사가 기존 요금대로 계속 청구하며, Wixzel Voice는 음성 엔진 요금을 선불 잔액에서 초 단위로 청구합니다.
최종 업데이트:
게시일
Wixzel Voice시작하기 전에 무엇이 필요한가요?
- 어느 통신사든 SIP 트렁크 하나와 그 호스트, 그리고 등록(registration) 방식을 쓴다면 사용자 이름과 비밀번호.
- 사용 중인 통신사에서 보유하고 해당 트렁크에 연결된 전화번호. Wixzel Voice는 번호를 판매하거나 이전하지 않습니다.
- Wixzel Voice API 키와 선불 크레딧. 최소 충전 금액은 $5이며 무료 등급은 없습니다.
- Wixzel Voice는 기본적으로 계정당 동시 통화 5건을 처리하며, 요청하면 늘려 드립니다. 웹과 앱 세션도 같은 한도에 포함됩니다.
Wixzel Voice에서 트렁크는 어떻게 만드나요?
통신사가 트렁크용으로 제공하는 SIP 호스트입니다.
curl https://api.voice.wixzel.com/v1/sip-trunks \
-H "Authorization: Bearer $WIXZEL_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "My carrier",
"host": "sip.carrier.example",
"transport": "udp"
}'사용 중인 통신사에서 IP 대신 인증 정보로 인증한다면 본문에 username과 password를 추가합니다. 비밀번호는 암호화되어 저장되며 API가 다시 반환하지 않습니다. 응답에는 다음 단계에 필요한 두 값인 platform_ip와 origination_uri가 들어 있습니다.
사용 중인 통신사에서는 무엇을 설정하나요?
| 설정 | 사용 중인 통신사의 명칭 | 값 |
|---|---|---|
| Wixzel Voice에서 오는 통화 허용 | IP ACL, 허용 목록 또는 승인된 주소 | 187.126.120.231 |
| 수신 통화를 Wixzel Voice로 보내기 | Origination URI 또는 통신사가 부르는 이름 | sip:187.126.120.231:5090 |
두 값 모두 현재 기준입니다. 페이지에서 복사하지 말고 GET /v1/sip-trunks에서 platform_ip와 origination_uri를 읽으세요. 그런 다음 POST /v1/phone-numbers로 각 번호를 트렁크에 등록하고 inbound_agent_id를 지정해 에이전트가 응답하게 합니다. 이 요청들은 AI 전화 통화 API 안내에 있고, 그 밖의 SIP 제공업체 전체 설정 단계에서 콘솔을 필드별로 살펴봅니다.
익숙하지 않은 통신사에서는 무엇이 잘못되나요?
- 열린 SIP 포트는 노출된 지 몇 시간 안에 통화 사기를 노린 스캔을 받습니다. 통신사 자체의 사기 방지 기능을 켜 두세요.
- 일부 시장에서는 발신 통화에 신원 확인이 필요합니다. KYC를 마치지 않았거나, 시장에서 요구하는 착신지 등록을 마치지 않은 계정은 잔액이 남아 있어도 모든 발신 통화가 즉시 종료될 수 있습니다.
- 통신사 선불 잔액은 필요하지만 그것만으로는 충분하지 않습니다. 크레딧이 있는지만이 아니라 해당 착신지 범위가 계정에서 활성화되어 있는지 확인하세요.
사용 중인 통신사 통화가 연결되지 않은 이유는 무엇인가요?
사용 중인 통신사에서 가장 자주 보이는 실패 코드:
| failure_code | 통신사 응답 | 의미 | 조치 |
|---|---|---|---|
| 1 | 404 | 통신사가 번호를 인식하지 못합니다. | 번호 형식을 확인하세요. 통신사가 기술 다이얼 접두사를 요구한다면 트렁크에 dial_prefix를 설정하세요. |
| 3 | - | 통신사에 이 착신지로 가는 경로가 없습니다. | 통신사 계정에서 착신지가 활성화되지 않았을 가능성이 큽니다. 통신사에 경로를 열어 달라고 요청하세요. |
| 28 | 484 | 통신사가 번호 형식을 거부했습니다. | 통신사가 기술 다이얼 접두사를 요구한다면 트렁크에 dial_prefix를 설정하세요. |
| 102 | 408 | 통신사가 제시간에 응답하지 않았습니다. | 트렁크의 host와 port, 그리고 통신사가 platform_ip에서 오는 SIP를 받는지 확인하세요. 통신사에 통화가 수신되었지만 응답하지 않은 것으로 표시된다면 send_plus를 false로 설정하세요. |
사용 중인 통신사에서 거부한 통화에는 status: "failed", failure_code(통신사가 보낸 Q.850 원인 코드), 무엇을 해야 하는지 알려 주는 failure_reason이 있으며, 비용이 들지 않습니다. 모든 실패 코드, 모든 거부 사유, 트렁크 디버깅 방법은 통신사 페이지에 있습니다.
사용 중인 통신사에서 AI 통화 비용은 얼마인가요?
회선 요금은 통신사가 기존 요금대로 청구합니다. Wixzel Voice는 음성 엔진만 실제 사용량 기준 초 단위로 청구하며, 연결된 1분당 gemini-live의 $0.0491부터 deepgram-agent의 $0.1851까지입니다. 모든 엔진의 가격.
자주 묻는 질문
여기에 가이드가 없는 통신사에서도 Wixzel Voice가 작동하나요?
통신사가 408 Request Timeout으로 응답합니다. 무엇을 바꿔야 하나요?
PATCH /v1/sip-trunks/{id}로 트렁크의 send_plus를 false로 설정하세요. 많은 도매 통신사는 요청 URI 앞의 +를 해석하지 못해, INVITE를 받은 뒤 라우팅에 실패하고 시간 초과됩니다. dial_prefix를 설정해도 같은 효과가 있습니다. 기술 접두사는 문자 그대로 매칭되므로 +가 빠지기 때문입니다.다른 통신사
Elastic SIP Trunking. Termination IP ACL에 플랫폼 IP를 허용하고, 수신 통화용 Origination SIP URI를 설정합니다.
IP 인증 SIP Connection. 플랫폼 IP를 승인된 주소로 추가하고, 수신 리전을 고르고, 전송 방식을 맞춥니다.
Zentrunk. IP ACL에 플랫폼 IP를 넣은 발신 트렁크와, Primary URI가 플랫폼을 가리키는 별도의 수신 트렁크가 필요합니다.
Programmable SIP. SIP Dashboard에서 트렁크의 ACL에 플랫폼 IP를 추가하고, 수신 통화를 origination URI로 보냅니다.
SIP REGISTER를 지원하지 않으므로 고정 IP가 필요합니다. 로케이션에 플랫폼 IP를 추가하고 Termination과 Origination을 따로 설정하거나, 네트워크 브리지 자격 증명을 사용합니다.
인도 번호 체계용 Virtual SIP Trunking(vSIP), TCP 사용. 플랫폼 IP를 ACL로 트렁크에 매핑하고, 수신용 Destination URI는 플랫폼의 TCP 포트를 가리키게 합니다.
트렁크별 SIP 도메인을 호스트로 쓰고, 트렁크의 IP ACL에 플랫폼 IP를 넣습니다. "origination URI"는 Twilio와 반대 의미입니다.
Saudi Arabia, ordered through Mobily Business sales and delivered over a private link. No one-step connect: your own SBC on the link relays calls, with G.711 A-law and a one-hour call cap.
트렁크의 두 부분이 작동하는 방식, 모든 실패 코드, 모든 통신사 가이드를 한 페이지에 모았습니다.