연동과 채널(기술)

채널은 다른 서비스의 메시지를 웹사이트 채팅과 같은 상담원 화면으로 가져옵니다. 연동은 다른 서비스에 이벤트를 보내거나 지식을 가져옵니다. 이 페이지는 기술을 설명합니다. 계정에서의 운영은 매뉴얼에 있습니다.

상태: 채널과 대부분의 연동은 모의 제공업체 응답으로 테스트했지만 모든 실제 계정에서 검증하지는 않았습니다. 서명된 웹훅은 해당 문서에 명시한 제한을 제외하면 완료되었습니다. 다른 제공업체는 활성화 후 연동 로그를 확인합니다. 베타로 취급합니다.

공통 규칙

• 콜백 주소는 https://reactive.chat/kanal/<kanal>/<SITE_KEY> 형식입니다. 사이트 키는 계정 프로젝트 → 설치에 있습니다.
• 모든 수신 경로는 제공업체의 서명을 검증합니다. 제공업체 시크릿이 없으면 아무것도 받지 않습니다.
• 인증 정보는 나머지 설정과 분리해 암호화하여 저장합니다.
• 팀의 답변은 발신 큐로 제공업체에 전달합니다. 플랫폼이 멈춰도 채팅은 지연되지 않습니다.
• 메시지 길이: 요금제 제한을 넘는 수신 메시지는 줄이고 [...]로 표시합니다(제한).
• 채널의 첨부 파일(이메일, Telegram 사진)은 위젯과 같은 검사(유형, 크기, 할당량)를 거칩니다. 거부한 파일은 프로젝트 기본 언어(de, en, pl, 그 외에는 영어)로 텍스트에 “[첨부 파일이 허용되지 않음: …]”으로 표시합니다.

WhatsApp, Messenger, Instagram

계정의 연동에서 설정합니다. Meta Developer Dashboard의 자체 앱이 필요합니다. 메시지는 당사 계정을 거치지 않습니다.

• Callback URL: https://reactive.chat/kanal/whatsapp/SITE_KEY, …/kanal/messenger/SITE_KEY 또는 …/kanal/instagram/SITE_KEY
• Verify Token: Meta와 당사에 동일하게 입력하는 긴 임의 문자열입니다(상수 시간 비교).
• App Secret: 모든 콜백의 서명을 검증하는 데 사용합니다. App Secret이 없으면 수신 경로는 아무것도 받지 않습니다.
• Access Token: 운영자를 대신해 전송하는 데 사용합니다.

전송이 안내 없이 실패할 수 있는 플랫폼 규칙:

• WhatsApp: 고객의 마지막 메시지 후 24시간 동안 자유롭게 답변할 수 있으며 이후에는 승인된 템플릿만 가능합니다(UTILITY 유형, 정확히 하나의 {{1}} 자리 표시자). 설정에 이름을 입력합니다. 허용 시간 밖에서는 자유 형식으로 보내지 않습니다.
• Instagram: 고객이 먼저 작성해야 합니다.
• Messenger: 메시지 태그 중 HUMAN_AGENT만 남아 있으며 나머지는 거부합니다.

Meta는 콜백에 5초 안에 응답하기를 요구합니다. 당사의 수신 경로는 수락하고 큐에 넣기만 합니다.

Telegram, SMS, 이메일

이 채널들은 프로젝트에 속하며 프로젝트 → 채널에서 설정합니다.

• Telegram: 자체 봇입니다. 봇 토큰을 저장하면 당사가 setWebhook으로 https://reactive.chat/kanal/telegram/SITE_KEY 콜백 주소를 등록합니다. 각 콜백이 반드시 포함해야 하는 임의의 secret_token도 설정합니다. 기본적으로 어시스턴트도 답변합니다.
• SMS: Twilio 계정을 사용합니다(Twilio 연동). 전화번호의 “A message comes in”에 https://reactive.chat/kanal/sms/SITE_KEY 를 입력합니다. X-Twilio-Signature를 검증합니다. 기본적으로 어시스턴트도 답변합니다.
• 이메일: IMAP으로 1분마다 메일함을 조회하고 답변은 운영자의 SMTP로 보냅니다(그 외에는 Reply-To가 있는 당사 전송 서비스 사용). 활성화할 때 이전 메일은 가져오지 않습니다. In-Reply-To/References로 대화에 연결하며 없으면 최근 30일의 발신자와 제목을 사용합니다. 부재중 안내, 전송 보고서, 메일링 리스트, 스팸 표시 메일, 발신자당 시간당 20통 초과(프로젝트당 300통)는 수집하지 않습니다. 기본적으로 어시스턴트는 이메일에 답변하지 않습니다. 켜면 답변에 Auto-Submitted: auto-replied가 포함됩니다.

알려진 미완료 사항: 제공업체 전송이 영구 실패하면(차단된 번호, 종료된 허용 시간) 원인은 연동 로그에 있지만 아직 대화에는 없습니다.

연동

계정의 연동에서 켭니다. 각각 별도 인증 정보(키, 토큰, 주소 또는 제공업체 로그인)를 사용합니다. 이벤트(conversation.created, message.created, handoff.requested, csat.submitted, fehlerfall.erstellt)는 재시도가 있는 큐로 처리합니다.

• 간격을 늘리며 최대 5회 재시도합니다(1초부터 10분 조금 넘게까지).
• 제공업체·워크스페이스별 회로 차단기: 60초 안에 오류 5회면 30초 일시 중지합니다.
• 1시간보다 오래된 이벤트는 더 이상 전송하지 않습니다.
• 채팅은 연동을 기다리지 않습니다.

코드에 있는 제공업체:

• 자체 시스템에 이벤트: 웹훅(서명됨. 웹훅 참조), Zapier, Make, n8n(REST 훅)
• 팀 채팅: Slack, Microsoft Teams, Discord
• 티켓과 CRM: Zendesk, Freshdesk, HubSpot, Pipedrive, Jira, Linear, GitHub
• 쇼핑몰: Shopify, WooCommerce, Shopware, Stripe
• 지식: 웹사이트 크롤러, WordPress, Notion, Confluence, Google Drive
• 분석과 오류: Google Analytics 4, Matomo, Plausible, Sentry
• 일정: Cal.com
• 채널: WhatsApp, Messenger, Instagram, Telegram, Twilio, 이메일

자체 제공업체를 등록할 수는 없습니다. 자체 연결에는 웹훅, 서버 API 또는 MCP를 사용합니다.

채팅 내 쇼핑몰 기능(WooCommerce, Shopify, Shopware의 “장바구니에 추가” 등)은 reactive.chat이 프로젝트별로 활성화합니다. 등록된 쇼핑몰 호스트에서만 작동하며 자체 JavaScript API는 없습니다.

모바일 앱

앱용 네이티브 SDK는 없지만 WebView용 삽입 페이지가 있습니다. 모바일 앱을 참조합니다.

다음: 모바일 앱