RushChat홈에서 설치 흐름 보기

INSTALL

RushChat 설치하기

방을 만들고 임베드 키를 받은 뒤, 채팅을 표시할 위치에 SDK 코드를 추가하면 됩니다.

설치 전에 확인할 세 가지

코드를 붙이기 전에 어떤 페이지에서 어떤 방을 보여줄지 정하면 설치와 운영을 같이 설계할 수 있습니다.

  • 채팅을 마운트할 요소

    본문 아래, 멤버 영역, 이벤트 안내처럼 채팅이 들어갈 위치에 비어 있는 요소를 준비합니다.

  • 연결할 방의 임베드 키

    대시보드에서 방을 만든 뒤 발급된 임베드 키를 확인합니다. 이 키는 어느 방을 보여줄지 지정합니다.

  • 허용할 웹사이트 도메인

    실제 운영할 도메인을 허용 목록에 넣어, 의도한 웹사이트에서만 임베드가 동작하도록 준비합니다.

가장 단순한 설치 방식

채팅이 표시될 요소를 만들고 SDK를 불러온 뒤, 임베드 키와 높이를 전달해 마운트합니다. 아래 코드는 일반 HTML 페이지에서 사용할 수 있는 기본 형태입니다.

<div id="rushchat"></div>
<script src="{CHAT_ORIGIN}/rush-chat-sdk.js"></script>
<script>
  RushChat.mount("#rushchat", {
    key: "{EMBED_KEY}",
    height: "600px",
  });
</script>

연결이 보이지 않을 때 확인할 순서

설치 후 채팅이 보이지 않으면 코드를 반복해서 붙이기보다 연결 지점을 순서대로 확인하는 편이 빠릅니다.

  • 대상 요소의 선택자

    RushChat.mount에 전달한 선택자가 실제 페이지에 있고, 중복되지 않는지 확인합니다.

  • 임베드 키

    대시보드에서 확인한 방의 키와 코드에 넣은 키가 같은지 확인합니다.

  • 현재 접속한 도메인

    허용 도메인 설정이 있다면 로컬·스테이징·운영 주소가 각각 의도대로 등록됐는지 확인합니다.

자주 묻는 질문

설치 과정에서 자주 나오는 질문입니다.

한 사이트에서 여러 방을 사용할 수 있나요?
가능합니다. 각 위치에 연결할 방의 임베드 키를 다르게 지정하면 됩니다. 다만 처음에는 방이 너무 분산되지 않도록 목적부터 나누는 것이 좋습니다.
채팅 높이는 고정해야 하나요?
SDK를 마운트할 때 높이를 전달합니다. 페이지의 읽기 흐름과 모바일 화면을 함께 고려해 충분한 높이를 선택하세요.
운영 중인 페이지에도 붙일 수 있나요?
채팅을 표시할 위치에 요소와 SDK 코드를 추가할 수 있다면 기존 페이지에도 연결할 수 있습니다.
홈에서 설치 흐름 보기 →