Skip to main content
프로토타이핑에는 데모 번호로 충분하지만, 운영 트래픽에는 자체 VoIP 제공업체를 통해 보유한 번호를 사용해야 합니다. 이 가이드에서는 자격 증명 테스트 → 연결 생성 → 번호 가져오기 → 확인의 3단계 흐름을 안내합니다.
대시보드의 연결 → VoIP (/dashboard/voip-connections)에서 이 전체 흐름의 가이드 버전을 사용할 수 있습니다. 여기에는 계정 생성 및 API 키 설정을 안내하는 Telnyx 가이드 설정, 기존 계정 연결 경로, AI 설정 가이드 생성기가 포함된 수동 SIP 양식이 있습니다.

지원 제공업체

1. 자격 증명 테스트

저장된 VoIP 연결을 생성하기 전에 제공업체 자격 증명을 확인하여 정상 작동하는지 검증합니다. 이 요청은 생성 단계에 전달할 verification_evidence_id를 반환하므로, 테스트에 대해 자격 증명 비용이 중복 청구되지 않습니다.
Response
검사 중 하나라도 실패하면 응답 statusfail이 되며, checks에 실패한 단계가 표시됩니다. 제공업체 측 구성(트렁크 할당, IP 허용 목록, 발신 권한)을 수정한 후 다시 시도합니다.

2. 연결 생성

방금 받은 verification_evidence_id를 전달합니다.
응답은 status="connected" 상태의 VoipConnection 객체입니다. 자격 증명은 서버 측에 저장되며 이후 GET 요청에서 일반 텍스트로 반환되지 않습니다. 교체하려면 새 test를 실행하고 새 증거와 함께 PATCH합니다.

3. 번호 나열 및 가져오기

자격 증명에서 볼 수 있고 아직 ThunderPhone 조직에 포함되지 않은 번호를 확인합니다.
그런 다음 원하는 번호를 가져옵니다.
가져온 각 번호는 조직 내에서 source="voip"status="provisioning" 상태의 전화번호 리소스가 됩니다.

4. 가져온 각 번호 확인

가져오면 번호가 사용 가능으로 등록됩니다. 실제로 해당 번호로 통화를 라우팅하려면 왕복 확인(인바운드 수신 확인 + 아웃바운드 승인 확인)이 필요합니다.
성공하면 voip_verification_statusverified로 변경되고 번호는 status="active" 상태가 됩니다. 실패하면 응답에서 실패한 항목을 명시합니다. 이를 수정하고(대개 제공업체 대시보드에서 트렁크 할당이 누락된 경우) 다시 호출합니다.

5. 에이전트 할당 및 통화 수신

번호를 확인한 후에는 데모 번호와 동일한 방식으로 인바운드/아웃바운드 에이전트를 할당합니다. 인바운드 통화 처리아웃바운드 통화 발신을 참조하세요.

자격 증명 교체

제공업체 키가 교체되면 테스트 후 업데이트 흐름을 다시 실행합니다.
연결은 그대로 유지되므로 번호를 다시 가져올 필요가 없습니다.

다음 단계

VoIP 연결 참조

연결, 증거 및 가져오기 응답의 모든 필드입니다.

전화번호 참조

에이전트 할당, 조직 간 이전, 번호 해제를 수행합니다.

아웃바운드 통화 발신

이제 번호를 소유했으므로 아웃바운드 통화를 시작합니다.