# SIP 단말 (Linphone) (/docs/clients/sip) **부가서비스 활성화가 선행되어야 합니다.** SIP 단말 등록은 **SIP 트렁크 연결 부가서비스** 입니다. [대시보드 → 부가서비스](https://platform.claw-ops.com/) 에서 활성화 후 진행하세요. ## 개요 한국AI통신 070 번호는 TLS 를 지원하는 표준 SIP 소프트폰에 등록해 쓸 수 있습니다. | 항목 | 값 | | --- | --- | | Transport | TLS, 포트 5061 | | Domain | 계정 전용 도메인 `<계정 ID 소문자>.sip.claw-ops.com` — 대시보드 SIP 단말 화면에 표시되는 값을 그대로 쓰세요 | | Codec | OPUS, PCMU, PCMA | | 인증 | SIP Digest | | DTMF | RFC 4733(RFC 2833). SIP INFO 는 지원하지 않습니다 | | IP ACL | 대시보드에서 SIP 단말별 허용 IP 대역(CIDR) 지정. 지정하면 그 밖의 IP 에서 온 요청은 `403` 으로 거절 | 외부 단말은 **TLS 5061** 로만 연결됩니다. UDP / 평문 TCP 는 외부 단말용으로 열려 있지 않습니다. Zoiper 무료판(Community Edition)은 TLS 를 지원하지 않아 연결할 수 없습니다. Zoiper 를 쓰려면 TLS 를 지원하는 유료판(PRO)이 필요합니다. ## Linphone 으로 연결하기 아래 화면은 Linphone 데스크톱(macOS)을 처음 설치한 상태에서 진행한 것입니다. Linphone 은 [linphone.org](https://www.linphone.org/) 에서 무료로 받을 수 있습니다. **SIP 단말 발급** 대시보드 **전화번호 → SIP 단말** 에서 **Credential 추가** 를 누릅니다. - **USERNAME**: 단말을 구분할 이름입니다. 영문 소문자·숫자·하이픈·언더스코어로 정합니다. Linphone 의 **Authentication ID** 에 넣는 값입니다. - **ALLOWED NUMBERS**: 이 단말에서 발신에 쓸 070 번호입니다. 비워 두면 계정의 모든 번호를 쓸 수 있습니다. ![SIP 단말 발급](/docs/clients/sip/01-credential-create.jpg) **발급** 을 누르면 domain·auth_id·password 가 표시됩니다. 비밀번호는 이 화면에서만 볼 수 있으니 복사해 두세요. ![SIP 단말 발급 완료](/docs/clients/sip/02-credential-issued.jpg) **번호 착신을 소프트폰으로 설정** **전화번호 → 내 번호** 에서 사용할 070 번호를 열고, **인바운드 라우팅** 의 **수정** 을 누른 뒤 **소프트폰** 을 고릅니다. ![인바운드 라우팅 소프트폰 선택](/docs/clients/sip/03-routing-softphone.jpg) **SIP 단말** 에서 1단계에서 만든 단말을 고르고 **저장** 합니다. ![SIP 단말 선택](/docs/clients/sip/04-routing-device.jpg) **Linphone 첫 실행** Linphone 을 처음 실행하면 소개 화면이 나옵니다. **Next** 를 눌러 넘긴 뒤 **Start** 를 누릅니다. ![Linphone 첫 화면](/docs/clients/sip/05-linphone-welcome.jpg) 로그인 화면에서 **Third-party SIP account** 를 누릅니다. ![Third-party SIP account](/docs/clients/sip/06-linphone-third-party.jpg) 안내 화면에서 **I understand** 를 누릅니다. ![I understand](/docs/clients/sip/07-linphone-notice.jpg) **계정 정보 입력** | Linphone 항목 | 입력값 | | --- | --- | | Username | 사용할 070 번호, 하이픈 없이 (예: `07012345678`) | | Password | 1단계에서 복사한 비밀번호 | | Domain | 1단계의 domain (`<계정 ID 소문자>.sip.claw-ops.com`) | | Authentication ID (if different) | 1단계의 USERNAME (auth_id) | | Transport | TLS | Registrar URI · Outbound SIP Proxy URI 는 비워 둡니다. **Connection** 을 누릅니다. ![계정 정보 입력](/docs/clients/sip/08-linphone-form.jpg) Username 에는 SIP 단말의 USERNAME 이 아니라 **070 번호** 를 넣습니다. 발신할 때 이 번호가 발신번호로 쓰이며, 번호가 아니면 발신이 거절됩니다. **등록 확인** 메인 화면으로 넘어가고 오른쪽 위 계정 아이콘에 초록 점이 표시되면 등록된 것입니다. ![등록 완료](/docs/clients/sip/09-linphone-registered.jpg) ## 전화 받기 070 번호로 전화가 오면 Linphone 에 착신 알림이 뜹니다. **Accept** 를 누르면 통화가 연결됩니다. ![착신 알림](/docs/clients/sip/10-incoming-popup.jpg) ![수신 통화 화면](/docs/clients/sip/11-incoming-call.jpg) 한 SIP 단말로 여러 기기가 등록되어 있으면 모두 동시에 울립니다. ## 전화 걸기 위쪽 검색창에 상대 번호를 하이픈 없이 입력하고, 목록의 `sip:<번호>@<계정 도메인>` 줄에서 전화 아이콘을 누릅니다. ![번호 입력](/docs/clients/sip/12-dial.jpg) 받는 사람에게는 Username 에 넣은 070 번호가 발신번호로 표시됩니다. ![발신 통화 화면](/docs/clients/sip/13-outgoing-call.jpg) ## 단말 설정 값 정리 | 단말 설정 | 값 | | --- | --- | | Username (사용자 이름) | 착신·발신에 쓸 070 번호(하이픈 없이, 예: `07012345678`) | | Authentication ID (인증 ID) | SIP 단말의 USERNAME | | Password | SIP 단말의 비밀번호 | | Domain | `<계정 ID 소문자>.sip.claw-ops.com` | | Transport | TLS (포트 5061) | Username 이 SIP 단말의 USERNAME 도, 이 SIP 단말에 허용된 계정 번호도 아니면 등록이 `403` 으로 거절됩니다. ## PBX에서 전화 걸기 사내 PBX 에서 등록 없이 전화를 거는 방법은 [SIP 트렁크 › PBX에서 전화 걸기](/docs/sip-trunk#pbx에서-전화-걸기)에 있습니다.