연동, 데이터 이전과 API 키

연동(/app/integrations)에서 reactive.chat을 팀이 이미 사용하는 도구에 연결합니다. 연동은 워크스페이스 전체에 적용됩니다. 소유자와 관리자가 설정할 수 있으며, 개별 프로젝트로 권한이 제한된 관리자는 설정할 수 없습니다.

이 페이지에서는 연동으로 할 수 있는 일과 사용 방법을 설명합니다. 웹훅 서명 같은 기술 세부 사항은 기술 연동 부분에 있습니다.

현재 상태에 대한 안내

30개 이상의 서비스에 연결할 수 있습니다. 대부분 모의 환경의 상대 서비스로 테스트했지만 실제 서비스에서는 아직 실행하지 않았습니다. 연동 페이지에 “실제 서비스에서 검증되지 않음”으로 표시되며 일부에는 “진행 중”이 붙습니다. 웹훅과 Slack에는 이 안내가 없습니다. 미검증 연동을 설정한 뒤 실제 데이터로 테스트하고, 문제가 있으면 의견 보내기로 알려 주시기 바랍니다.

연동 설정

1. 연동을 엽니다. 상단에서 연결 수, 오류 또는 일시 중지 상태의 수, 전송 실패 여부를 확인합니다.
2. 카탈로그에서 검색하고(연동 검색, “전체” 또는 “연결되지 않음” 필터) 설정을 클릭합니다.
3. 서비스에서 요청하는 인증 정보를 입력합니다. 대개 해당 서비스 계정의 API 키나 토큰입니다.
4. 연결 및 활성화는 즉시 연결을 검사하고 연동을 켭니다. 활성화하지 않고 저장을 사용하면 나중에 활성화할 수 있습니다.

이후 연동을 수정, 일시 중지, 다시 활성화 또는 제거할 수 있습니다. 제거하면 저장된 인증 정보가 삭제되며 되돌릴 수 없습니다. 인증 정보는 암호화하여 저장합니다.

서비스 로그인 버튼은 Google Drive에만 있습니다. 그 밖의 서비스는 인증 정보를 직접 입력합니다. 예를 들어 Slack에는 자체 Slack 앱의 정보를 입력합니다.

서비스가 응답하지 않는 경우

모든 연동은 큐를 통해 작동합니다. 서비스가 응답하지 않으면 간격을 늘리며 여러 번 재전송합니다. 반복적으로 실패하면 잠시 전송을 중단합니다(“일시 중단: 서비스가 반복적으로 응답하지 않았습니다 …”). 약 1시간이 지나도 전송되지 않은 이벤트는 폐기합니다. 전송 실패 섹션에서 최근 실패 내역을 확인할 수 있으며 내용은 표시하지 않습니다.

채팅 메시지는 연동을 기다리지 않습니다. 서비스가 멈춰도 채팅은 영향 없이 계속됩니다.

제공되는 연동

팀 알림

• Slack – 새 대화마다 채널에 스레드가 생성됩니다. 스레드에 답변하면 방문자는 채팅에서 답변을 봅니다. /rc는 상태를 표시합니다. Slack 사용자를 상담원에 연결합니다.
• Microsoft Teams, Discord – 웹훅 주소로 알림을 보냅니다.
• Telegram – 봇 토큰과 채팅 ID로 채팅에 알림을 보냅니다.
• 이메일 – 팀 메일함에 알림을 보냅니다.

자동화

• 웹훅 – reactive.chat이 지정한 https:// 주소로 서명된 이벤트를 보냅니다. 새 대화, 각 메시지, 사람에게 인계 요청, 평가 제출, 새 오류 사례입니다. Zapier, Make와 n8n도 이 방식으로 연결합니다. 서명용 시크릿은 표시, 복사, 재생성이 가능합니다. 새 시크릿은 즉시 적용되고 이전 시크릿은 더 이상 유효하지 않습니다.
• Zapier – 인터페이스의 REST 훅을 사용합니다. Make와 n8n에는 아직 준비된 앱이 없으므로 웹훅을 사용합니다.

상담원 화면의 맥락 정보

이 연동은 상담원 화면의 맥락 열에 방문자의 주문이나 CRM 연락처 같은 카드를 표시합니다. 일부 카드에는 작업도 있습니다.

• CRM – HubSpot, Pipedrive
• 쇼핑몰 – Shopify, Shopware 6, WooCommerce
• 결제 – Stripe(제한된 읽기 키 사용)
• 웹사이트 – WordPress
• 분석 – Matomo, Plausible, Google Analytics 4
• 오류 – Sentry

방문자의 서명되지 않은 주장에 기반한 정보는 카드에 표시됩니다. 실행을 누르고 확인하면 작업을 수행합니다.

티켓, 일정, 전화

• Zendesk, Freshdesk, Jira, Linear, GitHub – 대화나 오류 사례에서 티켓이나 이슈를 만듭니다.
• Cal.com – 가능한 일정을 표시하고 예약합니다. AI 어시스턴트로도 가능합니다.
• Twilio – 상담원 화면의 SMS 및 SMS 채널의 전송 경로입니다.

지식 출처

• Notion, Confluence – 콘텐츠를 지식 베이스로 가져옵니다.
• Google Drive – 지식 베이스의 “파일 및 Google Drive”에서 사용합니다(지식 베이스와 도움말 센터 참조).
• KB-Crawler – 웹사이트 크롤링 설정입니다.

채널

• WhatsApp Business, Facebook Messenger, Instagram Direct – 채널을 참조합니다.

다른 서비스에서 이전

데이터 이전(/app/migration)에서 다른 채팅 도구의 데이터를 가져옵니다.

• Intercom과 Crisp – 해당 인터페이스나 내보내기 파일을 사용합니다. Crisp에서는 Markdown 도움말 문서도 가져옵니다.
• Tidio – 내보내기 파일을 사용합니다.
• Zendesk – 전체 JSON 내보내기와 도움말 센터 내보내기를 사용합니다.

진행 방법:

1. 새 데이터 이전 시작을 누르고 대상(어느 프로젝트로 가져올까요?)을 선택합니다.
2. 연결하고 내용 확인 – 존재하는 데이터와 샘플을 봅니다.
3. 무엇을 가져올까요? – 연락처, 대화, 문서를 선택합니다.
4. 데이터 이전 시작을 누릅니다. 중지하거나 작업 폐기를 할 수 있습니다.

알아둘 사항:

• 가져온 대화는 상담원 화면에 종료됨 상태로 들어갑니다.
• 가져온 연락처는 미확인으로 간주합니다.
• 텍스트의 민감한 정보는 가림 처리합니다.
• 첨부 파일은 파일이 아닌 링크로 가져옵니다.
• 다시 실행해도 중복 생성하지 않습니다.
• 이전 서비스의 인증 정보는 실행 후 삭제됩니다.
• 서비스 인터페이스는 실제 계정 없이 테스트했으며, 파일 가져오기는 샘플 파일로 전체 과정을 테스트했습니다.

스니펫 교체로 계정에서 기존 Intercom 또는 Crisp 스니펫을 reactive.chat 스니펫으로 변환합니다. JavaScript 명령 boot, open, identify, track은 Intercom과 같은 이름을 유지합니다.

API 키

API 키(/app/api-keys, 소유자와 관리자용)에서 REST 인터페이스용 키를 만듭니다. 키는 정확히 한 번만 표시됩니다. 이후 reactive.chat에는 지문만 저장합니다. 따라서 즉시 안전한 곳에 복사합니다.

생성할 때 키의 권한을 선택합니다.

• 읽기 전용
• 읽기 및 쓰기
• 고객 데이터 가져오기 전용 – 채팅의 고객 데이터에 설명된 가져오기용입니다.
• 읽기 + 방문자 데이터 또는 읽기, 쓰기 + 방문자 데이터 – 이 권한이 있어야 방문자의 이름, 이메일과 전화번호를 볼 수 있습니다.

목록에는 이름, 접두사, 생성 시각과 생성자, 마지막 사용 시각이 표시됩니다. 폐기는 즉시 적용되며 되돌릴 수 없습니다.

키를 사용해 Model Context Protocol(MCP)을 지원하는 AI 도구에 reactive.chat을 연결할 수도 있습니다. 페이지에 예시가 표시됩니다. 인터페이스의 작동 방식은 기술 연동 부분에 설명되어 있습니다.