본 문서는 영어 원본을 기계 번역한 것입니다. 번역본과 영어 원본 사이에 내용이 상충할 경우 영어 원본이 우선합니다. 영어 원본 보기

메시징 게이트웨이: 연락처가 이미 사용하는 앱에서 Caiioo가 답변하게 하세요

메시징 게이트웨이는 Caiioo가 고객과 연락처가 이미 사용 중인 플랫폼에서 메시지를 주고받을 수 있게 하는 서비스 독립적인 방식입니다. 사람들이 WhatsApp, Telegram 또는 그들이 있는 곳 어디에서나 메시지를 보내면 에이전트가 해당 채널에서 실시간으로 자율적으로 답변합니다. 동일한 게이트웨이가 반대 방향으로도 작동합니다. 에이전트는 모든 스레드에서 도구로서 메시지를 보낼 수 있습니다 ("Telegram의 팀 그룹에 회의에 대해 문자 보내줘").

하나의 게이트웨이로 여러 서비스를 지원합니다. 각 서비스를 한 번만 연결하면 Caiioo가 단일 인터페이스 뒤에서 모든 것을 표준화합니다.

지원되는 서비스

설정 > 연결성 > 메시징 게이트웨이에서 다음 중 하나를 연결하세요:

  • WhatsApp Business — 안정적
  • Telegram — 안정적
  • Messenger (베타)
  • iMessage (베타)
  • Signal (베타)
  • Viber (베타)
  • Beeper (베타)

WhatsApp Business와 Telegram은 안정적입니다. 나머지는 베타 버전이며 완전히 사용할 수 있고 계속 안정화 작업 중입니다.

설정

  1. 설정 > 연결성 > 연결 > 개인 릴레이에서 이 기기의 원격 접속을 켭니다. 이것이 실제로 인바운드 메시지를 수신하는 릴레이에 기기를 연결하는 요소입니다. 이 기능이 없으면 아래 서비스가 어떻게 구성되든 아무것도 도착하지 않습니다. 기본적으로 꺼져 있으며 기기별로 설정됩니다(아래 플랫폼 지원 참조).
  2. 설정 > 연결성 > 메시징 게이트웨이로 이동합니다.
  3. 서비스를 선택합니다.
  4. 해당 제공업체의 표준 봇 또는 비즈니스 자격 증명을 입력합니다 — 해당 플랫폼의 모든 통합에 사용할 동일한 토큰 또는 비즈니스 계정입니다.
  5. Caiioo가 인바운드 경로를 등록합니다. 원격 접속이 아직 켜져 있지 않은 경우 설정 > 연결성 > 메시징 게이트웨이에서 이를 알리고 바로 켤 수 있도록 안내합니다.

각 서비스를 한 번만 구성하면 됩니다. 그 후에는 연결된 서비스 수에 관계없이 에이전트가 단일 메시징 기능을 인식합니다.

대화별 상호작용 모드

모든 대화에는 스레드 상단의 세 가지 버튼에서 선택한 고유한 모드가 있어, 각 연락처에 대해 에이전트가 어떻게 나타날지 정확히 결정할 수 있습니다.

자동 (초록색)

에이전트가 모든 사람에게 자동으로 답변합니다. 해당 스레드에서 사용자가 입력하는 모든 내용은 코칭으로 처리됩니다. 이는 에이전트의 다음 답변을 형성하지만 연락처에게 전송되지는 않습니다. 에이전트가 대화를 처리하되 가끔 방향을 지시하고 싶을 때 사용하세요 ("더 정중하게 말해줘", "할인을 제안해줘").

개입 (파란색)

에이전트가 여전히 수신 메시지에 자동 답변하지만, 사용자가 입력하는 모든 내용은 사용자 본인으로서 연락처에게 직접 전달됩니다. 에이전트가 대화를 이어가는 도중에 직접 끼어들어 대화하고 싶을 때 사용하세요.

채팅 (황색)

에이전트가 일시 중지하고 물러납니다. 자동 응답을 중지하며, 사용자가 직접 대화를 처리하고 메시지는 사용자 본인으로서 연락처에게 전달됩니다. 스레드에 사람이 필요하고 에이전트가 관여하지 않기를 원할 때 사용하세요.

양방향 미디어

이미지, 오디오, 비디오가 양방향으로 흐릅니다. 연락처가 사진을 보내면 모델에 전달되므로 "방금 고객이 보낸 사진에 무엇이 있나요?"라고 묻고 동일한 채널에서 바로 답변할 수 있습니다. 에이전트가 생성하거나 첨부한 미디어도 동일한 방식으로 연락처에게 전달됩니다.

개인정보 보호 및 아키텍처

모든 메시지 처리는 원격 액세스가 켜져 있는 사용자의 기기(데스크톱 앱, 브라우저 확장 프로그램 또는 둘 다)에서 로컬로 이루어집니다. 에이전트는 사용자의 기기에서 실행되며 대화, 자격 증명, 미디어는 클라우드가 아니라 해당 기기에서 처리됩니다.

Cloudflare는 사용자별 단순 웹훅 릴레이 역할만 합니다. 각 사용자는 단일 테넌트 Durable Object를 가지며, 이 객체는 비공개 연결을 통해 원시 인바운드 웹훅을 사용자의 기기로 전달하는 역할만 수행합니다. 클라우드 메시지 저장소나 클라우드 측 처리는 전혀 없습니다. 아웃바운드 메시지는 Cloudflare를 완전히 우회하며 사용자의 기기가 서비스의 API를 직접 호출합니다. Cloudflare가 관여하는 유일한 이유는 외부 서비스가 인바운드 웹훅을 전달할 수 있는 안정적인 공개 URL이 필요하기 때문입니다.

플랫폼 지원

실제로 메시지 수신 여부를 결정하는 것은 원격 액세스(설정 > 연결 > 연결 > 프라이빗 릴레이)입니다. 이는 장치별 스위치로 기본적으로 꺼져 있으며, 네트워크 노출 설정(포트 개방과 유사)이기 때문에 의도적으로 장치 간에 동기화되지 않습니다. 응답하게 하려는 모든 장치에서는 이를 켜고, 그렇지 않은 장치에서는 꺼 두세요.

  • macOS, Windows, Linux — 지원됨. 데스크톱 앱에서 원격 액세스를 켜면 응답합니다.
  • 브라우저 확장 프로그램(Chrome, Safari) — 지원되며 완벽하게 독자적으로 작동합니다(데스크톱 앱 불필요). 확장 프로그램 자체 설정에서 원격 액세스를 켜면 직접 연결되어 혼자서 메시지에 응답합니다.
  • 원격 액세스가 켜진 데스크톱 앱과 확장 프로그램을 동시에 둘 다 가지고 있는 경우, 데스크톱 앱이 우선권을 가지며 확장 프로그램은 데스크톱 앱이 오프라인 상태가 될 경우를 대비해 백업으로 대기 상태를 유지합니다.
  • iOS 또는 Android — 사용 불가. 모바일 앱은 게이트웨이가 의존하는 프라이빗 릴레이 클라이언트를 실행하지 않으므로, 원격 액세스 여부와 관계없이 수신 메시지를 받거나 응답할 수 없습니다.

Slack에 관한 참고 사항

Slack은 메시징 게이트웨이의 일부가 아닙니다. Slack은 Community Hub에서 별도의 OAuth 패키지로 제공되므로 그곳에서 설치하세요. Community Hub를 참조하세요.

티어

메시징 게이트웨이는 Pro 기능입니다.

참고 항목

This guide is maintained by the Caiioo team using Slate, our built-in editor.