Telnyx SIP 트렁크를 Wixzel Voice에 연결하기
Telnyx 번호로 AI 음성 에이전트를 운영하려면 Telnyx SIP Connections의 트렁크를 Wixzel Voice에 연결합니다. 발신 통화가 수락되도록 트렁크가 반환하는 platform_ip를 authorised addresses on an IP-authenticated SIP Connection에 추가하고, 수신 통화가 들어오도록 수신 통화를 트렁크의 origination_uri 주소로 보냅니다. 회선 요금은 Telnyx에서 기존 요금대로 계속 청구하며, Wixzel Voice는 음성 엔진 요금을 선불 잔액에서 초 단위로 청구합니다.
최종 업데이트:
게시일
통신사는 Telnyx이고, Wixzel Voice는 그 위에서 에이전트를 실행하는 음성 AI API입니다. 둘은 표준 SIP로 함께 작동합니다. Telnyx의 상표권은 해당 소유자에게 있으며, Wixzel Voice는 Telnyx의 제휴사가 아니고 Telnyx의 보증을 받지 않았습니다.
Wixzel Voice시작하기 전에 무엇이 필요한가요?
- SIP Connections 서비스가 있는 Telnyx 계정, 그리고 트렁크의 호스트와 인증 정보.
- Telnyx에서 보유하고 해당 트렁크에 연결된 전화번호. Wixzel Voice는 번호를 판매하거나 이전하지 않습니다. 콘솔에서 Telnyx 계정을 연결하면 전화번호 페이지에서 그 계정으로 번호를 구매할 수도 있습니다. 요금은 Telnyx에서 자체 가격으로 청구합니다.
- Wixzel Voice API 키와 선불 크레딧. 최소 충전 금액은 $5이며 무료 등급은 없습니다.
- Wixzel Voice는 기본적으로 계정당 동시 통화 5건을 처리하며, 요청하면 늘려 드립니다. 웹과 앱 세션도 같은 한도에 포함됩니다.
Wixzel Voice에서 Telnyx 트렁크는 어떻게 만드나요?
Mission Control이 연결에 표시하는 SIP 주소입니다. 설정 가이드에는 Telnyx 호스트가 나와 있지 않으므로 여기가 아니라 콘솔에서 복사하세요.
curl https://api.voice.wixzel.com/v1/sip-trunks \
-H "Authorization: Bearer $WIXZEL_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "Telnyx",
"host": "<the SIP host Telnyx shows for the connection>",
"transport": "udp"
}'Telnyx에서 IP 대신 인증 정보로 인증한다면 본문에 username과 password를 추가합니다. 비밀번호는 암호화되어 저장되며 API가 다시 반환하지 않습니다. 응답에는 다음 단계에 필요한 두 값인 platform_ip와 origination_uri가 들어 있습니다.
Telnyx에서는 무엇을 설정하나요?
| 설정 | Telnyx의 명칭 | 값 |
|---|---|---|
| Wixzel Voice에서 오는 통화 허용 | authorised addresses on an IP-authenticated SIP Connection | 187.126.120.231 |
| 수신 통화를 Wixzel Voice로 보내기 | 수신 통화의 목적지. 필드 이름은 설정 단계에 나와 있습니다 | sip:187.126.120.231:5090 |
두 값 모두 현재 기준입니다. 페이지에서 복사하지 말고 GET /v1/sip-trunks에서 platform_ip와 origination_uri를 읽으세요. 그런 다음 POST /v1/phone-numbers로 각 번호를 트렁크에 등록하고 inbound_agent_id를 지정해 에이전트가 응답하게 합니다. 이 요청들은 AI 전화 통화 API 안내에 있고, Telnyx 전체 설정 단계에서 콘솔을 필드별로 살펴봅니다.
Telnyx에서는 무엇이 잘못되나요?
- 전송 방식이 맞지 않으면 통신사가 응답하지 않는 것처럼 보입니다. 연결과 트렁크의 전송 방식을 같게 유지하세요. 기본값은 양쪽 모두 UDP입니다.
- Telnyx는 번호 앞의
+를 기대하므로send_plus는 기본값인true로 두세요.
Telnyx 통화가 연결되지 않은 이유는 무엇인가요?
Telnyx에서 가장 자주 보이는 실패 코드:
| failure_code | 통신사 응답 | 의미 | 조치 |
|---|---|---|---|
| 102 | 408 | 통신사가 제시간에 응답하지 않았습니다. | 트렁크의 host와 port, 그리고 통신사가 platform_ip에서 오는 SIP를 받는지 확인하세요. 통신사에 통화가 수신되었지만 응답하지 않은 것으로 표시된다면 send_plus를 false로 설정하세요. |
Telnyx에서 거부한 통화에는 status: "failed", failure_code(통신사가 보낸 Q.850 원인 코드), 무엇을 해야 하는지 알려 주는 failure_reason이 있으며, 비용이 들지 않습니다. 모든 실패 코드, 모든 거부 사유, 트렁크 디버깅 방법은 통신사 페이지에 있습니다.
Telnyx에서 AI 통화 비용은 얼마인가요?
회선 요금은 Telnyx에서 기존 요금대로 청구합니다. Wixzel Voice는 음성 엔진만 실제 사용량 기준 초 단위로 청구하며, 연결된 1분당 gemini-live의 $0.0491부터 deepgram-agent의 $0.1851까지입니다. 모든 엔진의 가격.
자주 묻는 질문
Wixzel Voice와 함께 쓸 수 있는 Telnyx 연결 유형은 무엇인가요?
platform_ip를 승인된 주소로 추가하세요.전송 방식을 바꾼 뒤 Telnyx 통화가 연결되지 않는 이유는 무엇인가요?
transport가 tcp나 tls라면 Telnyx 연결의 SIP Transport Protocol도 같게 바꿔야 합니다. 그렇지 않으면 양쪽이 맞지 않습니다.다른 통신사
Elastic SIP Trunking. Termination IP ACL에 플랫폼 IP를 허용하고, 수신 통화용 Origination SIP URI를 설정합니다.
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.
방법은 어디서나 같습니다. 플랫폼 IP를 허용 목록에 추가하고, 수신 목적지를 origination URI로 설정하고, 번호 형식과 전송 방식을 맞춥니다.
트렁크의 두 부분이 작동하는 방식, 모든 실패 코드, 모든 통신사 가이드를 한 페이지에 모았습니다.