콘텐츠로 건너뛰기
목차 · 찾기
위피스 설명서

사무실 밖 동료와 화상 통화가 안 될 때 통화 서버 넣기

들어가는 길
  • 설정 앱설정 → 일반 설정 → 메신저
  • 개발자 모드켜야 이 설정이 보입니다
  • 권한역할 / 관리자
설정 화면에 들어가는 세 가지 길

메신저의 음성·화상 통화는 참가자의 브라우저끼리 직접 연결합니다. 회사 방화벽이나 통신사 공유기 때문에 직접 연결이 막히면 통화 화면은 열려도 소리와 영상이 오가지 않습니다. 이럴 때 연결을 중계하는 통화 서버(ICE 서버)를 넣어 줍니다. 같은 사무실 안에서는 대부분 잘 되므로, 바깥 동료나 거래처와의 통화가 자꾸 끊길 때 손대면 됩니다.

이 설정이 영향을 주는 곳

값은 시스템 매개변수(mail.use_call_server, mail.use_twilio_rtc_servers, mail.twilio_account_sid, mail.twilio_account_token)에 저장됩니다.

화면 영향
메신저 통화·회의 누군가 통화에 들어올 때마다 서버가 통화 서버 목록을 만들어 브라우저에 넘깁니다. 채팅, 채널, 회의 탭의 통화가 모두 해당합니다
Twilio 계정 두 칸을 켜고 계정 값을 넣으면 통화에 들어올 때마다 Twilio에서 통화 서버 목록을 받아 옵니다
ICE 서버 목록 Twilio를 쓰지 않거나 Twilio에서 받아 오지 못하면 여기 등록한 서버를 앞에서부터 5개까지 씁니다

위피스에서 처음 들어 있는 값

칸 처음 값 뜻
맞춤형 통화 서버 꺼짐 아래 칸들이 숨어 있음
Twilio를 활용한 맞춤형 ICE 서버 꺼짐 Twilio를 쓰지 않음
ICE 서버 목록 없음 등록한 통화 서버가 없음

아무것도 넣지 않으면 브라우저는 구글이 공개한 연결 확인용 서버(STUN)만 씁니다. 이 서버는 서로의 주소를 찾아 줄 뿐 통화를 중계하지는 않으므로, 직접 연결이 막힌 곳에서는 통화가 되지 않습니다.

위피스에서는 이렇게 고릅니다

  • 같은 사무실 동료끼리만 통화한다면 그대로 둡니다.
  • 재택 근무자나 거래처와 통화할 일이 많고 연결이 자주 실패하면 중계 서버(TURN)가 필요합니다. 두 길이 있습니다.
    • Twilio 계정: Twilio에 가입해 계정 값 두 개를 넣습니다. 서버를 직접 운영하지 않아도 되지만 Twilio 요금이 듭니다.
    • 직접 등록: 이미 쓰고 있는 TURN 서버가 있으면 ICE 서버 환경설정에 주소와 인증 정보를 넣습니다.

설정 순서

Twilio 계정을 쓸 때

  1. Twilio에 가입하고, 콘솔의 계정 정보에서 Account SID와 Auth Token을 확인합니다.
  2. 왼쪽 위 앱 메뉴에서 설정을 열고 일반 설정 탭의 메신저 칸으로 내려갑니다.
  3. 맞춤형 통화 서버를 체크합니다. 아래에 통화 서버 칸들이 나타납니다.
  4. Twilio를 활용한 맞춤형 ICE 서버를 체크하고 SID에 Account SID, 토큰에 Auth Token을 넣습니다.
  5. 위쪽의 저장을 누릅니다.

TURN 서버를 직접 등록할 때

  1. 위 2~3번처럼 맞춤형 통화 서버를 체크하고 저장합니다.
  2. 맞춤형 ICE 서버 아래의 ICE 서버 환경설정을 누릅니다.
  3. 신규를 누르고 칸을 채웁니다.
    • 유형: 중계 서버는 「turn:」, 주소 확인용 서버는 「stun:」
    • URL: 서버 주소와 포트. 「turn:」을 앞에 붙이지 않고 turn.example.com:3478처럼 씁니다
    • 사용자 이름, 자격 증명: TURN 서버에서 받은 계정 값
  4. 저장합니다.

설정을 바꾼 뒤 통화에 새로 들어오는 사람부터 적용됩니다.

알아 둘 점

  • 두 칸을 모두 켜야 Twilio를 씁니다. 맞춤형 통화 서버를 끄면 Twilio 칸에 값이 남아 있어도 쓰지 않습니다.
  • ICE 서버 목록은 위 스위치와 상관없이 쓰입니다. 목록에 서버가 하나라도 있으면 Twilio를 쓰지 않는 동안 그 목록이 통화에 쓰입니다. 쓰지 않을 서버는 목록에서 지웁니다.
  • Twilio에서 받아 오지 못하면 목록으로 넘어갑니다. 계정 값이 틀렸거나 Twilio에 접속하지 못하면 등록한 ICE 서버 목록을 쓰고, 목록도 비어 있으면 공개 STUN만으로 연결을 시도합니다.
  • 목록은 5개까지만 씁니다. 브라우저 제한 때문에 서버는 등록한 순서대로 5개까지만 넘어갑니다.
  • 같은 묶음의 맞춤형 SFU 서버는 여러 사람이 함께 하는 큰 회의를 위한 별도 중계 서버입니다. 직접 운영하는 SFU 서버가 있을 때만 씁니다.