Skip to main content
community 채널은 계정의 Chat 익스피리언스 중 하나에 있는 채팅입니다. support 채널은 계정과 한 고객 간의 대화입니다. Channels API를 사용하여 채널을 생성하고 목록을 조회하며, 채널 자체 ID 또는 해당 Chat 익스피리언스의 ID로 채널을 조회할 수 있습니다. 또한 다이렉트 메시지 요청을 수락하거나 거절하고, 채널을 읽음으로 표시하고, 지원 대화를 해결하거나 다시 열 수 있습니다.

엔드포인트

속성

string
필수
기존 공개 채널 ID로, REST와 채팅 클라이언트 전반에서 유지됩니다.
string | null
필수
string
필수
생성 시간으로, ISO 8601 타임스탬프입니다.
string | null
필수
채널이 삭제되었거나 채널 목록에서 제거된 시점으로, ISO 8601 타임스탬프입니다. 활성 채널은 null입니다.
string | null
필수
object | null
필수
채널 아이콘입니다. 커뮤니티 채널은 익스피리언스 로고를 표시하며, 없으면 앱 아이콘을 표시합니다. 지원 채널은 계정 로고를 표시합니다. 그룹 비공개 채널은 자체 아이콘을 표시합니다. 일대일 비공개 채널이거나 이미지가 설정되지 않은 경우 null입니다.

속성

string
필수
파일 ID이며, 접두사는 file_입니다.
string | null
필수
이미지 또는 비디오의 BlurHash 플레이스홀더입니다. 사용할 수 없거나 모더레이션으로 제거된 경우 null입니다.
string | null
필수
원본 파일의 MIME 유형입니다(예: application/pdf). 모더레이션으로 파일이 제거되어도 유지됩니다.
string
필수
파일이 생성된 시점으로, ISO 8601 타임스탬프입니다.
number | null
필수
오디오 또는 비디오 길이(초)입니다. 사용할 수 없거나 모더레이션으로 제거된 경우 null입니다.
string | null
필수
확장자를 포함한 원본 파일 이름입니다.
integer | null
필수
이미지 또는 비디오 높이(픽셀)입니다. 사용할 수 없거나 모더레이션으로 제거된 경우 null입니다.
integer | null
각 파트(마지막 파트 제외)의 바이트 크기입니다. 생성 시에만, 멀티파트 업로드에만 존재합니다.
string | null
멀티파트 업로드의 ID로, complete에 다시 전달합니다. 생성 시에만, 멀티파트 업로드에만 존재합니다.
object[] | null
각 파트의 미리 서명된 URL입니다. 생성 시에만, 멀티파트 업로드에만 존재합니다.

속성

integer
필수
멀티파트 업로드 내에서 이 파트의 인덱스(1부터 시작)입니다.
string
필수
이 파트의 바이트를 PUT할 미리 서명된 URL입니다.
string
필수
이 객체의 유형으로, 항상 file입니다.
boolean
필수
모더레이션으로 파일이 제거되었는지 여부입니다. true이면 url은 대체 이미지를 제공합니다. filename, size, content_type은 여전히 원본 파일을 설명합니다.
integer | null
필수
파일 크기(바이트)입니다. 업로드가 완료될 때까지 null입니다.
object
업로드 PUT 요청과 함께 보낼 헤더입니다. 생성 시에만 존재합니다.
string
필수
파일의 업로드 수명 주기 단계입니다.사용 가능한 옵션: pending, processing, ready, failed
string | null
파일의 바이트를 PUT할 미리 서명된 URL입니다. 생성 시에만, 단일 파트 업로드에만 존재합니다.
string | null
필수
파일을 다운로드할 수 있는 URL입니다. 공개 파일은 영구 CDN URL을, 비공개 파일은 만료되는 서명 URL을 받습니다. 업로드가 완료될 때까지 null입니다. 모더레이션으로 파일이 제거된 경우 대체 이미지 URL입니다.
string
필수
public 파일은 서명되지 않은 CDN URL에서 제공됩니다. private 파일은 만료되는 서명 URL에서 제공됩니다.사용 가능한 옵션: public, private
string | null
필수
오디오 파형 URL입니다. 사용할 수 없거나 모더레이션으로 제거된 경우 null입니다.
integer | null
필수
이미지 또는 비디오 너비(픽셀)입니다. 사용할 수 없거나 모더레이션으로 제거된 경우 null입니다.
string
필수
사용 가능한 옵션: private, community, support
string | null
필수
채널에 마지막으로 메시지 활동이 기록된 시점으로, ISO 8601 타임스탬프입니다. 기록된 메시지 활동이 없으면 null입니다.
string | null
필수
object | null
필수

속성

string | null
필수
저장된 멤버십 ID이며, 접근 권한에서 파생된 사용자는 null입니다.
string
필수
string | null
필수
저장된 채널 멤버십이 생성된 시점으로, ISO 8601 타임스탬프입니다. 접근 권한에 저장된 멤버십이 없는 사용자는 null입니다.
string | null
필수
비공개 채널에 대한 내 받은편지함 상태입니다. 다른 사용자와 다른 채널 유형에서는 null입니다.사용 가능한 옵션: requested, accepted, hidden
string | null
필수
권한 있는 참여자의 읽음 위치입니다. 커뮤니티 채널의 위치는 해당 사용자 본인에게만 표시됩니다.
string | null
필수
사용 가능한 옵션: all, mentions, none
integer | null
필수
boolean | null
필수
채널에 대한 내 읽지 않음 상태입니다. 다른 사용자는 null입니다.
string | null
필수
저장된 채널 멤버십이 마지막으로 변경된 시점으로, ISO 8601 타임스탬프입니다. 접근 권한에 저장된 멤버십이 없는 사용자는 null입니다.
object
필수

속성

string
필수
사용자 ID이며, 접두사는 user_입니다.
string | null
필수
표시 이름입니다.
object
필수
아바타 래퍼입니다. url은 항상 존재하며, 사용자가 사진을 설정하지 않은 경우 생성된 플레이스홀더입니다.

속성

string
필수
아바타 이미지 URL입니다. 항상 존재합니다. 사용자가 사진을 설정하지 않은 경우 생성된 플레이스홀더입니다.
string
필수
공개 사용자 이름입니다.
string
필수
사용자 ID
object | null
필수

속성

boolean
필수
멤버가 미디어를 게시하지 못하도록 합니다.
boolean
필수
멤버가 링크를 게시하지 못하도록 합니다.
string[] | null
필수
채널에서 차단된 단어입니다. 이 설정을 볼 수 없으면 null이며, 빈 목록은 차단된 단어가 없음을 의미합니다.
integer | null
필수
멤버가 메시지 사이에 기다려야 하는 시간(초)입니다. 0 또는 null이면 쿨다운이 꺼집니다.
string
필수
메시지를 게시할 수 있는 사람입니다.사용 가능한 옵션: everyone, admins
string
필수
메시지에 반응할 수 있는 사람입니다.사용 가능한 옵션: everyone, no_one
string | null
필수
boolean
필수
앱 알림이 켜져 있는지 여부입니다. 웹훅은 어느 경우에나 발생합니다.
object | null
필수

속성

boolean
필수
string
필수
string | null
필수
사용 가능한 옵션: customer, support
string | null
필수
지원 대화가 해결된 시점으로, ISO 8601 타임스탬프입니다. 해결되지 않은 동안에는 null입니다.
string
필수
사용 가능한 옵션: unresolved, resolved
string
필수
마지막 채널 변경 시점으로, ISO 8601 타임스탬프입니다.
Channel