yshmarov/livechat

어떤 프로젝트인가요?

핵심 기능

• 01방문자가 어느 페이지에서든 열 수 있는 채팅 버블 위젯으로, 읽지 않은 메시지 배지와 임시 저장된 초안을 지원합니다.
• 02진행 중 및 해결된 대화 필터, 검색, 답변 작성자별 표시 기능을 제공하는 팀 받은편지함입니다.
• 03기본적으로 polling을 통한 실시간 업데이트를 제공하며, Action Cable push를 옵션으로 사용할 수 있습니다.
• 04읽지 않은 메시지가 연속된 구간별로 묶어 표시하는 양방향 이메일 알림입니다.
• 05Active Storage를 통한 파일 첨부를 지원하며, 접근 제어를 적용해 엔진에서 파일을 제공합니다.
• 06권한 부여, 방문자 식별, Slack 알림 등의 훅을 설정할 수 있습니다.

활용 사례

• SaaS 앱 안에서 결제, 온보딩 또는 계정 관련 질문에 답변합니다.
• 고객 포털에서 고객이 주문, 청구서 또는 예약에 관해 문의할 수 있도록 합니다.
• 관리자 화면에서 내부 관리자가 지원 팀원에게 직접 문의할 수 있도록 합니다.
• 현재 주문이나 레코드 정보를 채팅에 미리 입력하는 문맥 기반 지원 버튼을 추가합니다.

빠른 시작

1. 1

   Gemfile에 gem을 추가하세요

2. 2

   bundle을 설치하세요

   bundle install
3. 3

   설치 프로그램 제너레이터를 실행하세요

   bin/rails generate livechat:install
4. 4

   데이터베이스 마이그레이션을 실행하세요

   bin/rails db:migrate

사용 전 알아둘 점

• !Ruby on Rails 앱에서만 작동합니다(Ruby >= 3.2, Rails >= 7.1, < 9).
• !inbox는 기본적으로 개발 환경에서만 활성화되므로 배포 전에 authorize_agent를 설정해야 합니다.

포함된 컬렉션

토픽

자주 묻는 질문

livechat은(는) 무엇인가요?

Rails 앱에 직접 호스팅하는 라이브 채팅: 대화 내용을 자체 데이터베이스에 저장하는 고객 지원 위젯과 팀 받은편지함입니다. livechat은 Rails 애플리케이션에 앱 내 지원 메시지 기능을 추가하는 Ruby gem입니다. 채팅 버블을 통해 방문자는 막힌 페이지에서 바로 질문할 수 있고, 팀은 마운트된 받은편지함 /livechat에서 답변할 수 있습니다. 대화, 메시지, 첨부 파일은 호스트 앱의 데이터베이스에 저장되므로 서드파티 서비스나 외부 스크립트가 필요하지 않습니다.

livechat은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

livechat은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

livechat은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. livechat의 마지막 커밋은 2026년 10월 27일입니다.

livechat은(는) 어디에 사용할 수 있나요?

SaaS 앱 안에서 결제, 온보딩 또는 계정 관련 질문에 답변합니다. 고객 포털에서 고객이 주문, 청구서 또는 예약에 관해 문의할 수 있도록 합니다. 관리자 화면에서 내부 관리자가 지원 팀원에게 직접 문의할 수 있도록 합니다. 현재 주문이나 레코드 정보를 채팅에 미리 입력하는 문맥 기반 지원 버튼을 추가합니다.

livechat는 어떻게 설치하나요?

Gemfile에 gem을 추가하세요 bundle을 설치하세요: bundle install 설치 프로그램 제너레이터를 실행하세요: bin/rails generate livechat:install 데이터베이스 마이그레이션을 실행하세요: bin/rails db:migrate

livechat은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/yshmarov/livechat