사용 제한

서비스 기능 제한

기능
제한 항목
설명
1:1/그룹 채팅 메시지
콘텐츠 길이
1:1, 그룹 채팅 메시지당 최대 길이: 12K
전송 빈도
일대일 메시지 전송 빈도: 클라이언트에서 보내는 데 제한이 없습니다. REST API를 통한 전송에는 API 설명서에 지정된 API 빈도 제한이 적용됩니다. 그룹 메시지 전송 빈도: 그룹당 초당 최대 40개의 메시지를 보낼 수 있습니다(그룹 유형에 관계없이 이 제한은 각 그룹에 별도로 적용됨).
수신 빈도
Android/iOS/Mac/Windows/iPad: 1:1 및 그룹 메시지 무제한Web: 2.11.2 이전 SDK 버전의 경우, 최대 1000개/초(일대일 메시지 및 그룹 메시지 합계). v2.11.2 이상 SDK 버전의 경우, 무제한
단일 파일 크기
SDK는 전송할 단일 파일에 대해 최대 파일 크기 100MB를 지원합니다.
SDK는 파일 메시지 생성 및 전송을 지원하지 않습니다.
WebIM SDK는 음성 메시지 생성 및 전송을 지원하지 않습니다.
메시지 기록 저장 기간
1:1 채팅 메시지 및 오디오-비디오 그룹 외 그룹 메시지는 메시지 기록 저장이 가능합니다.
에 로그인 하여 관련 구성을 수정할 수 있습니다. 기본 설정 값은 다음과 같습니다.
체험판: 7일, 연장 불가
프로 버전: 7일, 연장 가능
플래그십 버전: 30일, 연장 가능
메시지 기록 저장 기간 연장은 유료 부가 서비스입니다. 과금 세부 정보는
을 참고하십시오.
UserID
이름 규칙
사용자 계정은 32바이트 이하의 알파벳, 숫자만 지원되며, 특수문자는 지원되지 않습니다.
사용자 프로필
사용자 정의 필드
사용자 정의 필드 키워드는 8바이트 이하의 알파벳만 지원되며, 사용자 정의 필드 값은 500바이트를 초과할 수 없습니다.
UserSig
유효기간
사용자 비밀번호. IM 백엔드 SDK의 기본 인터페이스에서 생성된 서명의 유효기간은 180일입니다.
대화 관리
최근 대화 상대 수량
각 사용자는 기본적으로 최대 100개의 최근 연락처를 저장할 수 있습니다. 플래그십 버전은 최대 500개의 최근 연락처를 지원합니다. 제한은 콘솔에서 구성할 수 있습니다.
사용자 관계망
친구 및 친구 그룹
단일 사용자는 최대 3000명의 친구를 가질 수 있습니다.
지원되는 대기 중인 친구 요청의 최대 수는 100개입니다.
지원되는 최대 친구 목록 수는 32개입니다.
친구 목록 이름의 최대 길이는 30자입니다.
친구 비고의 최대 길이는 96자입니다.
v2.13.0부터 WebIM SDK는 친구 관계 체인을 지원합니다.
블록리스트
단일 사용자는 최대 1000명의 사용자를 블록리스트에 추가할 수 있습니다.
그룹
그룹 수
해체된 그룹을 제외한 SDKAppID당 모든 그룹 유형의 기존 그룹의 총 수를 의미합니다. 한도에 도달하면 불필요한 그룹을 먼저 해체한 후 새 그룹을 생성할 수 있습니다. 한도는 다음과 같습니다.
평가판: 100개
프로 버전 또는 플래그십 버전: 제한 없음

하루 최대 1만개의 그룹을 생성할 수 있으며 무료 최대 그룹 수는 월 10만개입니다. 최대 그룹 수가 무료 수를 초과하는 경우 플랜 외 요금이 발생합니다. 과금 세부 정보는
을 참고하십시오.
그룹 구성원 인원
오디오-비디오 그룹(AvChatRoom): 그룹 구성원 수에 대한 상한이 없습니다.

오디오-비디오가 아닌 그룹의 경우 기본 구성은 다음과 같습니다.
평가판: 20명/그룹
프로 버전: 200명의 구성원/그룹, 2000명의 구성원/그룹으로 확장 가능
플래그십 버전: 2000명의 구성원/그룹, 6000명의 구성원/그룹으로 확장 가능
그룹 구성원 수의 상한을 연장하는 것은 유료 부가 서비스입니다. 과금 세부 정보는
을 참고하십시오.
사용자가 가입할 수 있는 그룹 수
사용자가 가입할 수 있는 모든 그룹 유형의 총 그룹 수를 나타냅니다. 한도는 다음과 같습니다.
평가판: 50개 그룹/사용자
프로 버전: 사용자당 500개 그룹, 사용자당 1000개 그룹으로 확장 가능
플래그십 버전: 사용자당 3000개 그룹으로 한도 확장 가능
사용자가 가입할 수 있는 그룹 수의 상한을 확장하는 것은 유료 부가 서비스입니다. 과금 세부 정보는
을 참고하십시오.
그룹 프로필
그룹 이름 길이: 최대 30바이트
그룹 소개 길이: 최대 240바이트
그룹 공지 길이: 최대 300바이트
그룹 프로필 사진 URL 길이: 최대 100바이트
그룹 명함 길이: 최대 50바이트
사용자 정의 그룹 ID
사용자 정의 그룹 ID는 인쇄 가능한 ASCII 문자(0x20-0x7e)여야 하며, 최대 길이는 48바이트입니다. 디폴트 그룹 ID와의 혼동을 피하기 위해, 접두사는 @TGS#일 수 없습니다.
그룹 사용자 정의 필드
그룹 사용자 정의 필드는 최대 10개를 지원합니다.
필드 Key는 String 유형으로, 길이는 16바이트를 초과할 수 없습니다. 이름은 알파벳 대소문자, 숫자, 언더바만 지원합니다.
필드 Value는 사용자 정의 Buffer이며, 이진 데이터일 수 있습니다. 그룹 최대 Value 길이는 512바이트입니다.
그룹 구성원 사용자 정의 필드
그룹 구성원 사용자 정의 필드는 최대 5개를 지원합니다.
필드 Key는 String 유형으로, 길이는 16바이트를 초과할 수 없습니다. 이름은 알파벳 대소문자, 숫자, 언더바만 지원합니다.
필드 Value는 사용자 정의 Buffer이며, 바이너리 데이터일 수 있습니다. 그룹 구성원 최대 Value 길이는 64바이트입니다.
커뮤니티의 토픽 수
현재 커뮤니티는 최대 200개의 토픽을 지원합니다.


API 관련 한도

설명:
본문에서는 사용 제한이 있는 REST API만 나열합니다. 전체 API 목록은 REST API를 참고하십시오.

일반 제한

제한 항목
설명
호출 빈도
최대 200회/초: 기타 REST API


계정 관리

API
설명
여러 계정 가져오기
한 번에 최대 100개의 사용자 이름을 가져올 수 있으며, 이 API는 계정 닉네임 및 프로필 사진 정보의 직접 가져오기 기능을 지원하지 않습니다.
계정의 온라인 상태 쿼리
단일 요청으로 최대 500명의 사용자 상태를 쿼리할 수 있습니다.


1:1 채팅 메시지

API
설명
1:1 채팅 메시지 일괄 발송
한 번에 최대 500명의 사용자에게 1:1 채팅 메시지를 보낼 수 있습니다.


관계망 관리

API
설명
친구 가져오기
한 번에 최대 1000명의 친구를 가져오기 할 수 있습니다.


그룹 관리

API
설명
그룹 구성원 추가
한 번에 최대 100명의 구성원을 추가할 수 있습니다.
그룹 구성원 삭제
한 번에 최대 500명의 구성원을 삭제할 수 있습니다.
그룹에서 사용자 신분 쿼리
한 번에 최대 500개의 계정을 쿼리할 수 있습니다.
일괄 음소거 및 음소거 해제
한 번에 최대 500개의 계정을 음소거/음소거 해제할 수 있습니다.
그룹에서 일반 메시지 보내기
단일 그룹의 기본 전송 빈도는 초당 40회로 제한됩니다.5분 이내에 동일한 발신자가 보낸 두 메시지의 랜덤 값(Random 매개변수)이 동일한 경우, 두번째 메시지는 중복 메시지로 간주되어 삭제됩니다.
그룹 메시지 가져오기
한 번에 최대 20개의 메시지를 가져오기 할 수 있습니다. 메시지 타임스탬프 오름차순으로 가져오기해야하며, 메시지 타임스탬프는 그룹 생성 시간 이후 및 현재 시간 이전 시간이어야 합니다. 그렇지 않으면 실패하게 됩니다.
그룹 구성원 가져오기
오디오-비디오 그룹(AvChatRoom)은 그룹 구성원 가져오기를 지원하지 않습니다.한 번에 최대 300명의 구성원 가져오기가 가능하지만, 그룹 유형에 따라 수량 제한이 다릅니다. 자세한 내용은 그룹 기능을 참고하십시오.