자신의 시스템 연결

개요

채널 및 통합 → 자체 시스템 (/ko/integrations/own-system)은 고객 계정을 자체 시스템(예: 물류 포털)에 보관하고 해당 데이터를 OrderInChat에 복사하고 싶지 않은 스토어를 위한 것입니다.

• 로그인한 페이지에 OrderInChat 위젯을 삽입합니다.
• 귀하의 서버는 로그인한 사용자에 대한 단기 토큰을 서명하고 이를 위젯에 제공합니다.
• 해당 고객이 자신의 계정에 대해 질문할 때(예: "내 배송은 어디에 있나요?"), AI는 해당 사용자의 토큰을 사용하여 귀하의 읽기 전용 MCP 도구를 호출합니다. 이는 텍스트 채팅과 위젯에서 시작된 음성 통화에서 이루어집니다.
• OrderInChat은 귀하의 서명만 확인합니다. 절대 신원을 생성하지 않으며, 귀하의 데이터베이스를 읽지 않고, 귀하의 도구가 반환하는 내용을 저장하지 않습니다.

유료 요금제(Starter, Pro, Ultra)에서 제공됩니다. 유효한 토큰이 없는 방문자는 익명입니다: AI는 귀하의 지식 베이스에서 응답하고 계정 질문을 위해 로그인하라고 요청합니다.

개발자의 AI에게 맡기기

개발자의 AI에게 전달하기 에서 지침 복사 를 클릭하고, 개발자가 쓰는 AI 어시스턴트(Claude Code, Cursor, ChatGPT 등)에 텍스트를 그대로 붙여 넣으세요. 영어로 작성되어 있으며 만들어야 할 것(토큰 엔드포인트, 서명된 MCP 서버, 위젯 코드)을 스토어 ID와 주소가 채워진 상태로 정확히 설명합니다. 마지막에 이 페이지에 입력할 값 목록을 AI에게 요청합니다. 비밀 키는 절대 포함되지 않습니다. 서명 비밀 키는 이 페이지에서 만들고 서버에 직접 설정하세요.

1. 사용자 로그인 토큰

귀하의 서버는 로그인한 사용자에 대해 JWT를 서명합니다:

OrderInChat이 이를 검증하는 방법을 선택하세요:

• JWKS URL (ES256 또는 RS256) — 귀하의 공개 키의 HTTPS 주소.
• 공개 키 (ES256 또는 RS256) — PEM 공개 키를 붙여넣기.
• 공유 비밀 (HS256) — 최소 32자, 암호화된 상태로 저장.

토큰 테스트 아래에 샘플 토큰을 붙여넣어 라이브로 전환하기 전에 확인하세요. 유효하지 않거나 만료된 토큰은 채팅을 실패하게 하지 않으며, 방문자는 단순히 익명으로 처리됩니다.

2. 귀하의 MCP 서버

귀하의 MCP 서버 주소를 입력하세요 (스트리밍 HTTP, tools/list 및 tools/call). 테스트 및 라이브는 각각 고유한 주소와 서명 비밀을 가지며; 활성 모드는 AI가 사용할 모드를 선택합니다.

생성을 클릭하여 서명 비밀을 얻으세요. 이는 한 번만 표시되므로 귀하의 서버에 저장하세요. 무효화는 즉시 제거합니다(해당 모드의 호출은 새로 생성할 때까지 중단됩니다).

OrderInChat이 귀하의 서버에 보내는 모든 요청은 다음을 포함합니다:

• X-OIC-Timestamp — 유닉스 초
• X-OIC-Signature — v1= + 귀하의 서명 비밀로 timestamp.body의 hex HMAC-SHA256
• X-OIC-User-Token — 사용자의 토큰, 변경되지 않음 (직접 확인하고 해당 사용자의 데이터만 반환)
• X-OIC-Mode — test 또는 live

서명이 일치하지 않거나 타임스탬프가 5분 이상 오래된 요청은 거부하세요. OrderInChat은 고정 IP 주소가 없으므로 IP 허용 목록 대신 서명을 사용하세요.

3. 도구

도구 발견을 클릭하여 귀하의 서버가 나열한 도구를 읽고, AI가 사용할 수 있는 도구를 켭니다. 읽기 전용 도구만 허용하세요. 나중에 나타나는 도구는 켜기 전까지 꺼져 있습니다.

• 텍스트 채팅: 도구 호출은 최대 8초가 걸릴 수 있습니다.
• 음성 통화: 최대 3초; 어시스턴트가 먼저 짧은 "확인해 보겠습니다"라고 말합니다. 귀하의 서버가 느린 경우, 지금 확인할 수 없다고 말합니다.
• 귀하의 도구가 반환하는 내용은 데이터로만 처리되며, 절대 지침으로 사용되지 않으며, 채팅 기록에 저장되지 않습니다.

4. 위젯 삽입

<script>
  window.OrderInChatSettings = {
    userToken: "",
    getUserToken: async () => (await fetch("/your/oic-token")).text(),
  };
</script>
<script src="https://app.orderinchat.com/widget/oic-widget.js" data-tenant-id="YOUR-STORE-ID"></script>

getUserToken은 토큰이 만료될 때 호출됩니다. 스크립트가 로드된 후 OrderInChat.setUserToken(token), OrderInChat.clearUserToken() (로그아웃 시) 및 OrderInChat.onTokenRefresh(fn)을 사용할 수 있습니다.

유효한 토큰과 음성 어시스턴트가 활성화된 경우, 위젯 헤더에 전화 버튼이 표시됩니다. 통화는 위젯에서 실행되며, 모든 웹사이트 통화와 마찬가지로 AI 크레딧에서 청구됩니다(도구 호출은 통화에 포함됩니다). 웹 통화 오디오는 기록되지 않습니다.

사용자 지정 은 위젯 설정을 새 탭에서 엽니다. 코드는 페이지가 열릴 때마다 (data-tenant-id 로) OrderInChat에서 위젯 모양을 불러오므로, 거기서 저장한 변경 사항은 코드를 다시 붙여 넣지 않아도 바로 적용됩니다. 스토어프론트용으로 지정한 위젯 프로필(없으면 활성 프로필 또는 첫 번째 프로필)이 사용되며 새 프로필은 만들어지지 않습니다.

5. 연결 테스트

도구 아래의 연결 테스트는 테스트 서명 시크릿으로 테스트 MCP 주소에 정해진 검사를 실행합니다. AI는 사용하지 않으며 아무것도 저장하지 않습니다. 다음을 확인합니다.

• 주소가 공개 https인지(localhost나 사설 네트워크 주소가 아님)
• 올바르게 서명된 tools/list가 작동하는지
• 잘못된 서명의 요청이 거부되는지
• 서명이 맞아도 5분보다 오래된 타임스탬프의 요청이 거부되는지
• 켜진 도구에 대한 사용자 토큰 없는 tools/call이 오류를 반환하고 데이터를 주지 않는지
• 토큰 테스트에 샘플 토큰을 붙여넣었다면 tools/call이 작동하는지와 속도(2초를 넘으면 음성 통화에는 너무 느리며, 음성 통화는 3초 후 대기를 포기합니다)

찾아서 켠 도구만 빈 인수로 호출합니다. 샘플 토큰은 그 테스트에만 쓰이며 저장되지 않습니다. 실패한 항목마다 해결 방법이 표시됩니다. 개발자용 결과 복사는 개발자나 그 AI에게 붙여넣을 수 있는 영어 보고서를 복사합니다. 실패 항목이 없어질 때까지 테스트를 반복하세요.

귀하의 팀이 보는 것

• 받은편지함 → 웹: 토큰에서 고객의 이름과 이메일, 또는 둘 다 전송하지 않은 경우 사용자 #ID가 표시됩니다. 각 AI 응답은 사용된 도구와 작동 여부를 보여줍니다 — 데이터는 절대 표시되지 않습니다.
• 받은편지함 → 통화: 위젯 통화는 스토어 웹사이트 아래와 라이브에서 실행되는 동안 나타납니다; 전사에는 각 도구 단계(이름 및 결과만)가 표시됩니다.
• 고객: 각 사용자 ID(스토어 사용자 ID)에 대해 고객 카드가 생성되거나 재사용되므로 동일한 사람의 채팅과 통화가 연결됩니다.