Vonage SIP 트렁크를 Wixzel Voice에 연결하기
Vonage 번호로 AI 음성 에이전트를 운영하려면 Vonage Programmable SIP의 트렁크를 Wixzel Voice에 연결합니다. 발신 통화가 수락되도록 트렁크가 반환하는 platform_ip를 ACL (Access Control List)에 추가하고, 수신 통화가 들어오도록 수신 통화를 트렁크의 origination_uri 주소로 보냅니다. 회선 요금은 Vonage에서 기존 요금대로 계속 청구하며, Wixzel Voice는 음성 엔진 요금을 선불 잔액에서 초 단위로 청구합니다.
최종 업데이트:
게시일
통신사는 Vonage이고, Wixzel Voice는 그 위에서 에이전트를 실행하는 음성 AI API입니다. 둘은 표준 SIP로 함께 작동합니다. Vonage의 상표권은 해당 소유자에게 있으며, Wixzel Voice는 Vonage의 제휴사가 아니고 Vonage의 보증을 받지 않았습니다.
Wixzel Voice시작하기 전에 무엇이 필요한가요?
- Programmable SIP 서비스가 있는 Vonage 계정, 그리고 트렁크의 호스트와 인증 정보.
- Vonage에서 보유하고 해당 트렁크에 연결된 전화번호. Wixzel Voice는 번호를 판매하거나 이전하지 않습니다. 콘솔에서 Vonage 계정을 연결하면 전화번호 페이지에서 그 계정으로 번호를 구매할 수도 있습니다. 요금은 Vonage에서 자체 가격으로 청구합니다.
- Wixzel Voice API 키와 선불 크레딧. 최소 충전 금액은 $5이며 무료 등급은 없습니다.
- Wixzel Voice는 기본적으로 계정당 동시 통화 5건을 처리하며, 요청하면 늘려 드립니다. 웹과 앱 세션도 같은 한도에 포함됩니다.
Wixzel Voice에서 Vonage 트렁크는 어떻게 만드나요?
Vonage SIP Dashboard가 트렁크에 표시하는 SIP 주소입니다. 설정 가이드에는 Vonage 호스트가 나와 있지 않으므로 대시보드에서 복사하세요.
curl https://api.voice.wixzel.com/v1/sip-trunks \
-H "Authorization: Bearer $WIXZEL_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "Vonage",
"host": "<the SIP host of your Vonage trunk>",
"transport": "udp"
}'Vonage에서 IP 대신 인증 정보로 인증한다면 본문에 username과 password를 추가합니다. 비밀번호는 암호화되어 저장되며 API가 다시 반환하지 않습니다. 응답에는 다음 단계에 필요한 두 값인 platform_ip와 origination_uri가 들어 있습니다.
Vonage에서는 무엇을 설정하나요?
| 설정 | Vonage의 명칭 | 값 |
|---|---|---|
| Wixzel Voice에서 오는 통화 허용 | ACL (Access Control List) | 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 안내에 있고, Vonage 전체 설정 단계에서 콘솔을 필드별로 살펴봅니다.
Vonage에서는 무엇이 잘못되나요?
- Vonage는 보내는 트래픽의 IP 범위를 자체적으로 공개합니다. Wixzel Voice 쪽에서는 이를 위해 열어 둘 것이 없지만, 경로의 다른 곳에 자체 방화벽이 있다면 그 목록을 허용해야 합니다.
- 이름에 SIP가 들어간 다른 Vonage 제품이 아니라 Programmable SIP를 고르세요. 탄력적 트렁크처럼 작동하는 것은 Programmable SIP뿐입니다.
Vonage 통화가 연결되지 않은 이유는 무엇인가요?
Vonage에서 거부한 통화에는 status: "failed", failure_code(통신사가 보낸 Q.850 원인 코드), 무엇을 해야 하는지 알려 주는 failure_reason이 있으며, 비용이 들지 않습니다. 모든 실패 코드, 모든 거부 사유, 트렁크 디버깅 방법은 통신사 페이지에 있습니다.
Vonage에서 AI 통화 비용은 얼마인가요?
회선 요금은 Vonage에서 기존 요금대로 청구합니다. Wixzel Voice는 음성 엔진만 실제 사용량 기준 초 단위로 청구하며, 연결된 1분당 gemini-live의 $0.0491부터 deepgram-agent의 $0.1851까지입니다. 모든 엔진의 가격.
자주 묻는 질문
Wixzel Voice에는 어떤 Vonage 제품이 필요한가요?
Wixzel Voice 쪽에서 Vonage의 IP 범위를 허용해야 하나요?
platform_ip를 SIP Dashboard에서 트렁크의 ACL에 추가하는 것입니다.다른 통신사
Elastic SIP Trunking. Termination IP ACL에 플랫폼 IP를 허용하고, 수신 통화용 Origination SIP URI를 설정합니다.
IP 인증 SIP Connection. 플랫폼 IP를 승인된 주소로 추가하고, 수신 리전을 고르고, 전송 방식을 맞춥니다.
Zentrunk. IP ACL에 플랫폼 IP를 넣은 발신 트렁크와, Primary 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로 설정하고, 번호 형식과 전송 방식을 맞춥니다.
트렁크의 두 부분이 작동하는 방식, 모든 실패 코드, 모든 통신사 가이드를 한 페이지에 모았습니다.