시각적인 단계별 매뉴얼

sem.chat 문서

실제 sem.chat 대시보드 흐름을 기반으로 구축된 스크린샷 지원 SEMJAT 매뉴얼입니다. 각 가이드에서는 무엇을 클릭해야 하는지, 클릭 후 어떤 일이 발생해야 하는지, 테스트 방법, 문제 해결 방법, 다음에 수행할 작업을 알려줍니다.

일치하는 가이드가 없습니다. 위젯, API, 음성, 결제, 웹훅, WordPress, SendPulse 또는 예약과 같은 더 짧은 키워드를 사용해 보세요.
스크린샷 참고: 이 매뉴얼의 모든 이미지는 데모 워크스페이스를 사용해 실제 sem.chat 앱에서 캡처했습니다. 공개 전에 민감한 계정 정보, 고객 데이터, API 키, 결제 정보, 비공개 대화 내용은 마스킹됩니다.
01

시작하기

계정을 만들고, 온보딩을 마치고, 대시보드를 이해하고, 첫 번째 봇을 만들고, 비공개로 테스트하고, 설치하고, 올바른 플랜을 선택하세요.

/인증가입, 평가판 및 첫 번째 봇
sem.chat 데모 워크스페이스의 실제 스크린샷
1공개 사이트나 앱에서 가입 또는 로그인으로 시작하세요.
2알림이나 청구 메시지에 의존하기 전에 이메일 주소를 확인하세요.
3대시보드를 열기 전에 온보딩을 사용하여 첫 번째 봇을 생성하세요.
/개요로그인 후 개요
sem.chat 데모 워크스페이스의 실제 스크린샷
1빠른 작업을 사용하여 봇을 만들고, 봇을 보고, 분석을 열고, 청구를 관리하세요.
2변경하기 전에 활성 봇, conversations, 음성 통화 시간 및 만족도를 검토하세요.
3모든 설정 테스트 후에 최근 활동을 확인하세요.
첫 출시

가입하고 평가판을 시작하고 대시보드를 이해하세요

용도: 새로운 작업 공간을 위해 또는 sem.chat을 사용해 본 적이 없는 팀원을 온보딩할 때 이 워크플로를 사용하세요.

시작하기 전에
  • 확인 및 청구 이메일을 받을 수 있는 비즈니스 이메일을 사용하세요.
  • 나머지 팀원을 초대하기 전에 누가 작업 공간을 소유해야 하는지 결정하세요.
  • 위젯 설치를 위해 안전한 테스트 웹사이트나 준비 페이지를 준비하세요.
1

앱 가입 페이지 열기

웹사이트 로그인/가입 버튼에서 app.sem.chat/auth로 이동하세요.

예상 결과: 인증 페이지에는 로그인 및 계정 생성 옵션이 표시됩니다.
2

계정 만들기

비즈니스 이메일을 입력하고 비밀번호를 만든 후 가입 양식을 제출하세요.

예상 결과: 계정이 승인된 후 앱에서 확인을 요청하거나 온보딩으로 이동합니다.
3

이메일을 확인하세요

확인 이메일을 열고 확인 링크를 클릭하세요.

예상 결과: 계정은 청구, 초대, 보고 및 경고 메시지를 받을 수 있습니다.
4

온보딩 완료

업체명을 입력하고, 어시스턴트 목표를 설명하고, 시작 색상을 선택하고, 첫 번째 봇을 생성하세요.

예상 결과: 작업 영역은 봇 초안 및 활성 평가판 상태로 열립니다.
5

개요 열기

왼쪽 사이드바에서 개요를 클릭합니다.

예상 결과: 대시보드에는 usage 카드, 빠른 작업 및 최근 활동이 표시됩니다.
6

다음 작업을 선택하세요

설정을 위해서는 새 봇 생성을, 관리를 위해서는 모든 봇 보기를, 성능을 위해서는 분석을, 계획 한도는 청구를 사용하세요.

예상 결과: 작업공간의 상태에 따라 계속 진행해야 할 위치를 알 수 있습니다.
테스트 방법: 팀원을 초대하기 전에 하나의 비공개 테스트 봇을 만들고 테스트 메시지를 보내세요. 테스트 후 개요 활동 변경 사항을 확인합니다.
문제수정
인증메일이 도착하지 않습니다스팸을 확인하고 이메일 철자를 확인한 후 다른 확인 이메일을 요청하세요.
결제 시 대시보드가 열립니다.작업 공간에는 활성 평가판이나 계획이 필요할 수 있습니다. 평가판을 시작하거나 설정하기 전에 올바른 계획을 선택하세요.
팀원이 작업 공간에 액세스할 수 없습니다.소유자 로그인을 공유하는 대신 설정, 팀에서 초대하세요.

다음에 해야 할 일: 첫 번째 봇을 만들고 비공개로 테스트한 다음 준비 페이지에 위젯을 설치합니다.

비공개 출시 테스트

라이브로 시작하기 전에 첫 번째 비공개 봇 테스트 만들기

용도: 고객이 어시스턴트를 보기 전에 계정, 봇, 위젯 및 내역 추적을 확인하려면 이를 사용하십시오.

시작하기 전에
  • 하나의 샘플 고객 질문을 준비하십시오.
  • 준비 페이지 또는 로컬 HTML 테스트 페이지를 준비하세요.
  • 첫 번째 테스트에서는 실제 고객 데이터를 사용하지 마세요.
1

My Bots 열기

사이드바에서 My Bots을 클릭하거나 개요에서 모든 봇 보기를 사용하세요.

예상 결과: 온보딩 중에 생성된 봇이나 새 봇 버튼을 통해 비어 있는 상태를 확인할 수 있습니다.
2

봇 빌더 열기

새 봇을 클릭하거나 기존 봇에서 편집을 클릭합니다.

예상 결과: Bot Builder은 기본, 위젯, 지식, 음성 및 통합 제어로 열립니다.
3

봇을 한 번 저장하세요.

필수 봇 이름과 첫 번째 메시지를 입력한 후 저장을 클릭하세요.

예상 결과: 봇은 유효한 ID를 수신하고 포함 코드를 생성할 수 있습니다.
4

비공개로 미리보기

미리보기 패널을 사용하여 샘플 질문을 해보세요.

예상 결과: 답변은 귀하의 지시 사항과 일치해야 하며 어떤 지식이 누락되었는지 밝혀야 합니다.
5

스테이징 시 설치

Embed를 열고 HTML 코드 조각을 복사한 후 스테이징 페이지의 닫는 본문 태그 앞에 붙여넣습니다.

예상 결과: 위젯은 데스크탑과 모바일의 구성된 모서리에 나타납니다.
6

추적 확인

테스트 대화 후에 Inbox 또는 Chat History을(를) 엽니다.

예상 결과: 올바른 봇, 채널 및 메시지 기록과 함께 테스트 대화가 나타납니다.
테스트 방법: 음성이 활성화된 경우 문자 메시지 하나와 음성 테스트 하나를 보냅니다. 둘 다 Chat History에 나타나는지 확인하세요.
문제수정
삽입 코드를 사용할 수 없습니다.먼저 봇을 저장하세요. 음성 동기화가 아직 보류 중인 경우 동기화를 기다리거나 필수 항목을 모두 입력한 후 다시 저장하세요.
위젯에 잘못된 봇이 표시됨코드 조각의 data-bot-id이 Embed 모달의 봇 ID와 일치하는지 확인하세요.
기록에 대화가 표시되지 않습니다.Chat History을(를) 새로 고치고 봇이 활성 상태인지 확인하고 테스트가 오래된 페이지가 아닌 설치된 위젯에서 발생했는지 확인하세요.

다음에 해야 할 일: Bot Builder 설정 및 지식 교육으로 이동하세요.

02

봇 생성 및 구성

My Bots 및 Bot Builder에서 봇을 구축, 편집, 미리보기, 활성화, 전송 또는 제거합니다.

/대시보드My Bots 제어 센터
sem.chat 데모 워크스페이스의 실제 스크린샷
1새 어시스턴트를 시작하려면 새 봇을 클릭하세요.
2각 봇 카드에서 편집, 삽입, 전송, 활성화 또는 삭제를 사용하세요.
3테스트하기 전에 활성 상태와 마지막 업데이트 시간을 확인하세요.
/bots/:ID/편집Bot Builder 기본 탭
sem.chat 데모 워크스페이스의 실제 스크린샷
1봇 이름, 아바타, 첫 번째 메시지, 시스템 지침을 입력하세요.
2게시하기 전에 미리보기를 사용하여 테스트하세요.
3삽입 코드를 복사하기 전에 저장하고 동기화하세요.
봇 생성

My Bots에서 새 봇 만들기

용도: 새로운 브랜드, 웹사이트, 지원 대기열 또는 캠페인에 자체 도우미가 필요할 때 이 워크플로를 사용하세요.

시작하기 전에
  • 봇 이름, 목표, 첫 번째 메시지 및 2~3개의 샘플 질문을 준비합니다.
  • 콘텐츠를 가져오려는 경우 공개 웹사이트 URL을(를) 수집하세요.
  • 계획에서 필요한 수의 봇과 음성/아바타 기능을 허용하는지 확인하세요.
1

My Bots 열기

사이드바에서 My Bots을(를) 클릭하세요.

예상 결과: 기존 봇과 새 봇 버튼이 표시됩니다.
2

새 봇을 클릭하세요

My Bots 페이지에서 새 봇을 시작하세요.

예상 결과: Bot Builder은 초안 도우미와 함께 열립니다.
3

봇 ID 설정

봇 이름을 입력하고, 아바타를 업로드하거나 선택하고, 방문자가 보게 될 첫 번째 메시지를 작성하세요.

예상 결과: 미리보기 패널에는 보조자 이름, 아바타 및 인사말이 반영됩니다.
4

시스템 지침 작성

봇이 무엇을 해야 하는지, 어떻게 말해야 하는지, 무엇을 피해야 하는지, 언제 인간의 도움을 요청해야 하는지 설명하세요.

예상 결과: 보조자는 지식이 추가되기 전에 명확한 행동 규칙을 가지고 있습니다.
5

기본 지식 추가

필수 회사, 제품, 지원, 가격, 연락처 정보를 지식 영역에 붙여넣습니다.

예상 결과: 봇은 아직 웹사이트를 가져올 필요 없이 일반적인 질문에 답할 수 있습니다.
6

봇 저장

저장을 클릭하고 저장 또는 동기화 확인을 기다립니다.

예상 결과: 봇은 안정적인 ID를 가지며 미리보기를 테스트할 수 있으며 포함 옵션을 사용할 수 있습니다.
7

결과 미리보기

미리보기에서 준비된 샘플 질문을 물어보세요.

예상 결과: 답변은 지침을 따르고 입력한 지식을 활용해야 합니다.
8

준비가 된 경우에만 활성화

비공개 테스트를 통과한 후 봇을 활성화합니다.

예상 결과: 봇은 위젯 또는 채널 트래픽을 처리할 준비가 되어 있습니다.
테스트 방법: 최소한 5가지 현실적인 질문을 해보세요. 답변이 맞는지, 브랜드에 남는지, 필요할 때 사람의 도움을 요청하는지 확인해보세요.
문제수정
답변이 너무 일반적이네요더 구체적인 지식을 추가하고 좋은 답변의 예를 들어 지침을 다시 작성하세요.
봇은 답변해야 할 질문을 거부합니다.지나치게 엄격한 지침을 제거하고 해당 주제에 대해 신뢰할 수 있는 지식을 추가하십시오.
저장하면 포함 코드가 생성되지 않습니다.필수 항목을 확인하시고, 음성사 동기화가 완료된 후 다시 저장하세요.

다음에 해야 할 일: 위젯 설정을 구성하고 웹사이트 지식을 추가한 다음 봇을 설치하세요.

봇 관리

봇 편집, 워크플로 복제, 전송, 비활성화 또는 삭제

용도: 봇에 업데이트, 소유권 변경, 임시 일시 중지 또는 영구 제거가 필요한 경우 이 워크플로를 사용하세요.

시작하기 전에
  • 봇을 삭제하기 전에 보관해야 하는 대화 또는 연락처 데이터를 내보내세요.
  • 봇을 삭제하거나 전송하기 전에 봇이 실제 웹사이트에 포함되어 있지 않은지 확인하세요.
  • 프로덕션 봇을 비활성화하기 전에 팀원에게 알리십시오.
1

My Bots 열기

이름이나 상태로 봇 카드를 찾으세요.

예상 결과: 카드에는 현재 상태와 사용 가능한 작업이 표시됩니다.
2

편집을 클릭하세요

봇 빌더를 열고 필요한 사항을 변경합니다.

예상 결과: 편집기는 현재 구성을 로드합니다.
3

저장하고 다시 테스트하세요

자료가 변경될 때마다 저장을 클릭한 다음 미리보기 질문을 실행하세요.

예상 결과: 저장된 구성은 미리보기 및 설치된 위젯에서 사용됩니다.
4

일시적으로 비활성화

봇이 지금 방문자 처리를 중지해야 하는 경우 활성 토글을 사용하세요.

예상 결과: 봇은 구성을 유지하는 동안 실시간 트래픽 제공을 중지합니다.
5

소유권 이전

전송을 사용하고 수신자 이메일을 입력한 후 확인하세요.

예상 결과: 선택한 계정은 앱 이전 흐름에 따라 소유권을 받습니다.
6

확인 후 삭제

삭제를 사용하고, 경고를 읽고, 봇이 더 이상 필요하지 않은 경우에만 확인하세요.

예상 결과: 경고에 따라 봇 및 관련 구성이 제거됩니다.
테스트 방법: 편집 후 설치된 위젯을 열고 변경 동기를 부여한 정확한 질문을 물어보세요. 실시간 답변이 변경되었는지 확인하세요.
문제수정
이전 답변이 계속 나타납니다.웹사이트 페이지를 새로 고치고, 올바른 봇을 저장했는지 확인하고, 가져온 지식에 동기화가 필요한지 확인하세요.
전송 실패수신자 이메일이 유효하고 대상 계정이 봇을 수락할 수 있는지 확인하세요.
실수로 삭제를 눌렀습니다최종 확인 전에 중지하세요. 삭제 경고는 해당 작업이 봇 데이터를 영구적으로 제거할 수 있기 때문에 존재합니다.

다음에 해야 할 일: 실시간 변경 후 분석 및 기록을 검토하여 방문자 경험이 개선되었는지 확인하세요.

03

위젯 설치

올바른 포함 코드를 복사하고 HTML, WordPress, React 또는 고급 SDK 컨텍스트에 설치한 다음 데스크톱 및 모바일 동작을 확인하세요.

모달 삽입웹사이트 설치 스니펫 복사
sem.chat 데모 워크스페이스의 실제 스크린샷
1사이트 스택에 따라 HTML, WordPress, React 또는 NPM/SDK을 선택합니다.
2봇을 저장하고 동기화한 후 코드를 복사하세요.
3닫는 본문 태그 앞이나 프레임워크 레이아웃에 코드 조각을 붙여넣습니다.
HTML 설치

표준 HTML 웹사이트에 위젯을 설치하세요.

용도: 페이지 템플릿, 테마 바닥글 또는 전역 HTML 레이아웃을 편집할 수 있는 경우 이 기능을 사용하세요.

시작하기 전에
  • 삽입 모달에 실제 봇 ID가 있도록 봇을 먼저 저장하세요.
  • 프로덕션 전에 준비 사이트를 사용하세요.
  • 모달에서 정확한 스크립트 버전과 data-bot-id을 유지하세요.
1

My Bots 열기

설치하려는 봇을 찾아 포함을 클릭하세요.

예상 결과: Embed 모달이 설치 탭과 함께 열립니다.
2

HTML을 선택하세요.

HTML 탭을 선택하고 코드 복사를 클릭하세요.

예상 결과: 위젯 스크립트는 봇 ID가 첨부된 상태로 복사됩니다.
3

웹사이트 템플릿 열기

위젯이 표시되어야 하는 모든 페이지에 렌더링되는 전역 바닥글 또는 레이아웃 파일을 편집합니다.

예상 결과: 의도적이지 않은 한 격리된 단일 페이지가 아닌 공유 사이트 셸을 편집하고 있습니다.
4

본문을 닫기 전에 붙여넣기

닫는 본문 태그 바로 앞에 스니펫을 붙여넣습니다.

예상 결과: 스크립트는 페이지 콘텐츠 다음에 로드되며 위젯 컨테이너를 탑재할 수 있습니다.
5

게시 또는 배포

템플릿을 저장하고 사이트를 배포합니다.

예상 결과: 위젯 스크립트는 대상 페이지에 적용됩니다.
6

데스크톱 및 모바일 테스트

새로운 브라우저 창과 모바일 뷰포트에서 사이트를 엽니다.

예상 결과: 위젯이 구성된 위치에 나타나고 콘솔 오류 없이 열립니다.
테스트 방법: 라이브 페이지에서 메시지를 보낸 다음 Inbox와 Chat History을 열어 대화가 올바른 봇에 속해 있는지 확인하세요.
문제수정
위젯이 없습니다코드가 닫는 본문 태그 앞에 있는지, 사이트 빌더에 의해 스크립트가 차단되지 않았는지, 봇이 활성화되어 있는지 확인하세요.
잘못된 봇이 나타납니다스니펫을 다시 복사하고 data-bot-id을 원하는 봇과 비교하세요.
위젯이 페이지 컨트롤과 겹칩니다.위젯 설정에서 위치나 크기를 변경하고 모바일에서 다시 테스트해보세요.

다음에 해야 할 일: 설치 후 위젯 설정 및 리드 캡처를 조정하세요.

HTML 삽입
<!-- sem.chat Voice & Text Widget -->
<script
  src="https://app.sem.chat/widget-v2.js?v=16"
  data-bot-id="YOUR_BOT_ID"
></script>
플랫폼 설치

WordPress, React 또는 고급 음성 SDK 흐름에 설치

용도: 웹사이트가 CMS, React 앱 또는 사용자 정의 음성 통합으로 관리되는 경우 이 기능을 사용하세요.

시작하기 전에
  • 공유 레이아웃을 소유한 스택을 파악합니다.
  • 선택한 봇에 대해 sem.chat에 표시된 정확한 스니펫을 사용하세요.
  • 고급 SDK 사용을 위해서는 필수 Vapi 공개 키와 보조자 ID가 있는지 확인하세요.
1

WordPress 옵션

Appearance, Theme Editor, footer.php 또는 신뢰할 수 있는 머리글 및 바닥글 플러그인을 사용하세요.

예상 결과: 스니펫은 공개 WordPress 페이지에 로드됩니다.
2

React 옵션

작은 ChatWidget 구성 요소를 만들고 useEffect에 스크립트를 추가한 다음 루트 레이아웃에 렌더링합니다.

예상 결과: 위젯은 한 번 로드되고 레이아웃이 마운트 해제되면 정리됩니다.
3

고급 SDK 옵션

기본 위젯 이상의 사용자 정의 음성 통화 제어가 필요한 경우에만 NPM/SDK 탭을 사용하십시오.

예상 결과: sem.chat이 구성된 보조 소스로 유지되는 동안 앱은 음성 세션을 제어합니다.
4

봇 ID 확인

설치된 코드가 Embed 모달의 봇 ID를 참조하는지 확인하세요.

예상 결과: 라이브 위젯이 의도한 어시스턴트에 연결됩니다.
5

콘솔 확인

브라우저 개발자 도구를 열고 다시 로드하세요.

예상 결과: 차단된 스크립트, 중복 컨테이너 또는 네트워크 오류가 없습니다.
테스트 방법: 설치된 사이트에서 하나의 테스트 메시지를 완료한 다음 예상 페이지 URL과 함께 받은 편지함에 나타나는지 확인하세요.
문제수정
React은 중복된 위젯을 로드합니다.참조를 사용하여 스크립트 삽입을 보호하거나 루트 레이아웃에서만 구성 요소를 렌더링합니다.
WordPress은 스크립트 태그를 제거합니다.스크립트를 허용하는 바닥글 삽입 플러그인이나 테마 파일을 사용하세요.
SDK 통화를 시작할 수 없습니다.공개 키, 어시스턴트 ID, 브라우저 권한을 확인하고 음성 액세스 계획을 확인하세요.

다음에 해야 할 일: 행동, 브랜딩, 리드 포착을 제어하려면 위젯 설정으로 이동하세요.

WordPress 바닥글 스니펫
<!-- sem.chat Widget (WordPress Compatible) -->
<script>
window.SEMCHAT_CONFIG = { botId: "YOUR_BOT_ID" };
</script>
<script src="https://app.sem.chat/widget-v2.js?v=16"></script>
React 구성요소
import { useEffect, useRef } from 'react';

export function ChatWidget() {
  const loaded = useRef(false);

  useEffect(() => {
    if (loaded.current) return;
    loaded.current = true;

    const script = document.createElement('script');
    script.src = 'https://app.sem.chat/widget-v2.js?v=16';
    script.setAttribute('data-bot-id', 'YOUR_BOT_ID');
    script.async = true;
    document.body.appendChild(script);

    return () => {
      const container = document.getElementById('semchat-widget-container');
      if (container) container.remove();
      script.remove();
    };
  }, []);

  return null;
}
고급 음성 SDK
npm install @vapi-ai/web

import Vapi from '@vapi-ai/web';

const vapi = new Vapi('YOUR_VAPI_PUBLIC_KEY');
await vapi.start('YOUR_ASSISTANT_ID');

vapi.on('call-start', () => console.log('Call started'));
vapi.on('call-end', () => console.log('Call ended'));
04

위젯 설정

모드, 테마, 크기, 위치, 색상, 브랜딩, 반응, 사운드, 동의, 리드 캡처, 평가, 후속 이메일 및 활성화 상태를 구성합니다.

Bot Builder / 위젯위젯 모양 및 방문자 행동
sem.chat 데모 워크스페이스의 실제 스크린샷
1chat, 음성 또는 하이브리드 모드를 선택하세요.
2테마, 색상, 위치, 크기, 브랜딩, 동의, 사운드를 설정합니다.
3리드 캡처, 평가, 반응 및 후속 조치를 구성합니다.
위젯 동작

방문자 대상 위젯 동작 구성

용도: 처음 설치한 후 또는 위젯이 웹사이트와 일치하고 더 나은 리드를 포착해야 할 때마다 이 기능을 사용하세요.

시작하기 전에
  • 준비 페이지에 위젯을 설치합니다.
  • 방문자가 chat, 음성 또는 둘 다로 시작해야 하는지 확인하세요.
  • 해당 지역에 필요한 경우 동의서 및 리드 캡처 사본을 준비하십시오.
1

봇 빌더 열기

My Bots을 열고 편집을 클릭한 다음 위젯 탭을 선택하세요.

예상 결과: 선택한 봇에 대한 위젯 컨트롤이 나타납니다.
2

모드를 선택하세요

원하는 방문자 경험에 따라 채팅, 음성 또는 하이브리드를 선택하세요.

예상 결과: 선택한 모드를 표시하도록 미리보기가 변경됩니다.
3

외형 설정

테마, 색상, 크기, 버튼 위치, 브랜드 옵션을 선택하세요.

예상 결과: 위젯은 중요한 내용을 가리지 않고 사이트와 일치합니다.
4

방문자 제어 활성화

반응, 소리, 평가, 동의 메시지를 켜거나 끕니다.

예상 결과: 방문자는 귀하가 사용하기를 원하는 컨트롤만 볼 수 있습니다.
5

리드 캡처 구성

필수 필드, 선택적 설명 필드 및 양식이 표시되는 시기를 선택합니다.

예상 결과: 연락처는 설정에 따라 conversations 이전 또는 도중에 수집됩니다.
6

후속 이메일 설정

계획에 포함된 경우 후속 이메일 동작을 구성합니다.

예상 결과: 방문자는 conversations 문제가 해결된 후 후속 메시지를 받을 수 있습니다.
7

저장 및 테스트

저장을 클릭하고 스테이징 페이지를 다시 로드한 후 위젯을 엽니다.

예상 결과: 라이브 위젯은 저장된 설정과 일치합니다.
테스트 방법: 데스크톱과 모바일에서 위젯을 열고 리드 양식을 제출하고 평점을 남기고 연락처와 대화가 녹음되었는지 확인하세요.
문제수정
색상이 업데이트되지 않았습니다.봇을 저장하고, 웹사이트를 새로 고치고, 설치된 위젯이 동일한 봇 ID를 사용하는지 확인하세요.
리드 필드가 누락되었습니다.리드 캡처가 활성화되어 있고 선택한 트리거 조건이 충족되는지 확인하세요.
방문자는 음성을 사용할 수 없습니다음성 설정, 브라우저 마이크 권한, 계획 액세스 및 음성 시간 제한을 확인하세요.

다음에 해야 할 일: 제작 시작 전에 음성/아바타 설정 및 지식 소스를 추가하세요.

05

음성 및 아바타

스톡 음성을 선택하고, 음성 모드 및 제한을 구성하고, 스크립트를 읽고, 음성을 복제하고, 복제된 음성을 할당하고, 스톡 또는 사용자 정의 아바타를 관리하세요.

Bot Builder / 음성음성, 한도, 스크립트, 아바타
sem.chat 데모 워크스페이스의 실제 스크린샷
1스톡 음성이나 저장된 복제 음성을 선택하세요.
2음성 시간 제한 및 스크립트 저장을 설정하세요.
3기본 아바타를 선택하거나 계획에서 허용하는 경우 맞춤 아바타를 업로드하세요.
음성 설정

음성 통화 및 스크립트 설정

용도: 방문자가 입력만 하는 대신 봇과 대화해야 할 때 이 기능을 사용하세요.

시작하기 전에
  • 계획에 음성 통화 시간과 원하는 음성/아바타 옵션이 포함되어 있는지 확인하세요.
  • 테스트에는 조용한 브라우저 환경을 사용하십시오.
  • 음성으로 테스트할 현실적인 지원 또는 판매 질문을 하나 준비하세요.
1

음성 설정 열기

봇 빌더를 열고 음성 또는 음성 및 아바타 영역을 선택하세요.

예상 결과: 음성 제어 및 현재 음성 선택이 표시됩니다.
2

주식 목소리를 선택하세요

사용 가능한 음성을 미리 보고 가장 적합한 음성을 선택한 후 선택 항목을 저장하세요.

예상 결과: 봇은 통화에 선택한 음성을 사용합니다.
3

음성 모드 구성

방문자가 음성을 사용할 수 있어야 하는 경우 위젯 설정을 사용하여 음성 또는 하이브리드를 선택하세요.

예상 결과: 방문자에게는 위젯에 음성 옵션이 표시됩니다.
4

음성 제한 설정

가능한 경우 사용자별 또는 작업 공간 제한을 정의합니다.

예상 결과: 길거나 반복되는 통화는 의도한 것보다 더 많은 시간을 소모할 수 없습니다.
5

스크립트 활성화

내역에서 통화 검토가 필요한 경우 대화 내용 저장을 켜세요.

예상 결과: 음성 통화는 세션 후 읽을 수 있는 기록을 생성합니다.
6

통화 테스트

위젯을 열고 마이크 접근을 허용한 후 통화를 시작하고 준비된 질문을 해보세요.

예상 결과: 봇이 음성으로 응답하고 통화가 깔끔하게 종료됩니다.
7

대본 읽기

Chat History을 열고 음성 대화를 찾으세요.

예상 결과: 기록에는 방문자와 봇이 말한 내용이 표시됩니다.
테스트 방법: 짧은 통화 한 번을 완료하고 음성 통화 시간, 스크립트, 대화 모드가 녹음되었는지 확인하세요.
문제수정
브라우저가 마이크를 차단함브라우저에서 마이크 권한을 허용하고 페이지를 다시 로드하세요.
음성 옵션이 잠겨 있습니다.청구를 열고 작업 공간 요금제에 음성 기능이 포함되어 있는지 확인하세요.
성적 증명서가 비어 있습니다.대화 내용 저장이 활성화되어 있고 통화가 정상적으로 종료되었는지 확인하세요.

다음에 해야 할 일: 음성 답변이 정확하도록 지식을 추가하거나 개선하세요.

음성 복제 및 아바타

음성을 복제하고 맞춤 아바타 할당

용도: 어시스턴트에게 브랜드 음성이나 말하는 아바타 경험이 필요할 때 이 기능을 사용하세요.

시작하기 전에
  • 사용 권한이 있는 오디오와 이미지만 사용하세요.
  • 배경 소음이 적은 깨끗한 음성 샘플을 녹음하세요.
  • 복제된 음성 및 사용자 정의 아바타에 대한 계획 제한을 확인하세요.
1

공개 음성 복제

음성 영역에서 음성 복제를 클릭합니다.

예상 결과: 업로드 대화 상자에는 허용되는 샘플 요구 사항이 표시됩니다.
2

샘플 업로드

1~5개의 명확한 녹음을 업로드하고 복제 요청을 제출하세요.

예상 결과: 처리 후 복제된 음성이 나타나거나 대화 상자에 다음 요구 사항이 표시됩니다.
3

복제된 음성 할당

음성 선택기에서 복제된 음성을 선택하고 저장합니다.

예상 결과: 향후 통화에서는 복제된 음성을 사용합니다.
4

주식 아바타를 선택하세요

사용자 정의 아바타 업로드가 필요하지 않은 경우 포함된 아바타를 선택하세요.

예상 결과: 음성 경험에는 시각적 정체성이 있습니다.
5

맞춤 아바타 업로드

계획에서 지원하는 경우 선명한 얼굴 이미지나 짧은 동영상을 업로드하세요.

예상 결과: 아바타가 처리되어 선택할 수 있게 됩니다.
6

전체 미리보기 실행

음성 통화를 시작하고 음성, 아바타, 스크립트 동작을 함께 확인하세요.

예상 결과: 방문자 경험은 구성된 브랜드와 일치합니다.
테스트 방법: 복제된 음성을 선택하여 짧은 질문을 하고 통화에서 예상되는 음성/아바타를 사용하는지 확인하세요.
문제수정
클론 품질이 좋지 않음하나의 스피커, 안정적인 볼륨, 음악 없이 더욱 깨끗한 샘플을 녹음하세요.
맞춤 아바타 업로드를 사용할 수 없습니다.요금제에 따른 아바타 제한은 청구를 확인하세요.
예전 목소리가 아직도 들려요새 음성을 선택한 후 봇을 저장하고 위젯 페이지를 다시 로드하세요.

다음에 해야 할 일: 음성 경험이 정확한 답변을 제공할 수 있도록 지식 및 데이터로 진행하세요.

06

지식과 데이터

수동 지식 추가, 웹사이트 콘텐츠 가져오기, 크롤링 결과 적용, 가져온 콘텐츠 동기화, 제품 피드 URLs 추가, 피드 새로고침 또는 제거, 테스트 질문으로 답변 확인 등을 수행합니다.

Bot Builder / 지식지식 소스 및 답변 테스트
sem.chat 데모 워크스페이스의 실제 스크린샷
1정책, 가격, 브랜드 규칙에 대한 수동 지식을 추가합니다.
2웹사이트 페이지를 가져오고 크롤링 결과를 적용합니다.
3제품 피드를 추가하고 재고가 변경되면 동기화하세요.
지식 소스

수동 지식, 웹사이트 가져오기 및 제품 피드를 통해 봇 교육

용도: 어시스턴트가 불완전한 답변을 제공하거나 새로운 제품, 정책 또는 웹사이트 정보가 필요할 때마다 이를 사용하세요.

시작하기 전에
  • 소스 URL 및 제품 피드 URL을 준비합니다.
  • 관리 페이지나 개인 페이지 등 가져오지 말아야 할 페이지를 결정합니다.
  • 추가하는 각 주제에 대한 시험 문제를 만듭니다.
1

열린 지식

Bot Builder을 열고 지식 또는 데이터 탭을 선택하세요.

예상 결과: 수동 지식, 웹사이트 가져오기, 제품 피드 도구가 표시됩니다.
2

수동 지식 추가

간결한 사실, 정책, 가격, 연락처 세부정보 및 답변 스타일 메모를 붙여넣으세요.

예상 결과: 봇에는 우선순위가 높은 답변을 제공하는 즉시 신뢰할 수 있는 소스가 있습니다.
3

웹사이트 콘텐츠 가져오기

공개 웹사이트 URL을(를) 붙여넣고 크롤링/가져오기를 시작하세요.

예상 결과: 크롤링 결과에는 발견된 페이지 또는 가져오기 상태가 표시됩니다.
4

결과 검토 및 적용

유용한 페이지를 유지하고, 관련 없는 페이지를 제거한 후 선택한 콘텐츠를 적용하세요.

예상 결과: 승인된 웹사이트 콘텐츠만 지식 베이스에 입력됩니다.
5

제품 피드 추가 URLs

Google Merchant Center 또는 지원되는 피드 URL을(를) 붙여넣고 가져옵니다.

예상 결과: 제품, 가격, 가용성 및 속성을 봇에서 사용할 수 있게 됩니다.
6

피드 새로 고침 또는 제거

카탈로그 데이터가 변경되면 새로 고침을 사용하고 더 이상 사용되지 않는 피드를 제거하세요.

예상 결과: 봇은 오래되거나 중복된 제품 데이터를 방지합니다.
7

저장 및 동기화

봇을 저장하고 동기화가 완료될 때까지 기다립니다.

예상 결과: 최신 지식은 미리보기 및 라이브 위젯 답변에 사용됩니다.
8

확인 질문하기

추가한 소스당 하나의 테스트 문제를 질문하세요.

예상 결과: 답변은 업데이트된 내용을 정확하게 인용하거나 반영합니다.
테스트 방법: 가격, 반품, 재고 여부, 회사 정보, 지원되지 않는 주제에 대해 질문하세요. 봇이 알려진 주제에 답변하고 알려지지 않은 세부정보를 만들어내지 않는지 확인하세요.
문제수정
크롤러가 관련 없는 페이지를 가져옵니다.선택한 결과에서 해당 페이지를 제거하고 보다 명확한 수동 지침을 추가하세요.
제품 가격이 오래되었습니다.피드를 새로 고치고 피드 URL 자체에 현재 값이 포함되어 있는지 확인하세요.
봇이 답변을 구성합니다봇이 확실하지 않다고 말하고 지식이 누락된 경우 사람의 지원을 제공해야 한다는 규칙을 추가합니다.

다음에 해야 할 일: 미리보기로 돌아가서 다시 테스트한 후 위젯을 설치하거나 업데이트하세요.

07

받은 편지함, Live Support, 기록, 연락처

매일 conversations을 처리하고, 실시간 지원 요청을 요청하고, 제어권을 AI로 다시 넘겨주고, 기록을 내보내고, 연락처를 관리하고, 연락처를 SendPulse에 동기화하세요.

/받은 편지함받은 편지함 대화 워크플로
sem.chat 데모 워크스페이스의 실제 스크린샷
1봇 또는 채널별로 필터링하세요.
2필요할 때 대화를 열고 사람으로서 답변하세요.
3번역, 해결 및 전달 제어를 신중하게 사용하십시오.
/실시간 지원실시간 지원 핸드오프 제어
sem.chat 데모 워크스페이스의 실제 스크린샷
1대기 중인 핸드오프를 신속하게 요청하세요.
2상담원으로 응답하거나 대화를 AI에 다시 전달하세요.
3방문자에게 더 이상 사람의 도움이 필요하지 않은 경우 해결합니다.
/chat-기록대화 기록 및 내보내기
sem.chat 데모 워크스페이스의 실제 스크린샷
1방문자, 봇, 채널 또는 날짜별로 검색하세요.
2텍스트 및 음성 세션의 전체 내용을 엽니다.
3필요한 경우 CSV 또는 JSON을 내보냅니다.
/연락처연락처 및 SendPulse 내보내기
sem.chat 데모 워크스페이스의 실제 스크린샷
1봇 또는 소스별로 연락처를 필터링합니다.
2연락처 세부정보 및 대화 내용을 엽니다.
3선택한 연락처를 SendPulse로 내보내거나 동기화합니다.
받은편지함 답장

대화를 열고 사람이 답장을 보내세요.

용도: 운영자가 AI를 혼자 계속하도록 두는 대신 sem.chat에서 고객에게 응답해야 할 때 이 기능을 사용하세요.

시작하기 전에
  • 운영자가 봇 또는 작업 영역에 액세스할 수 있는지 확인하세요.
  • 답장하기 전에 대화를 읽어보세요.
  • 방문자가 동일한 언어를 기대하는지 확인하십시오.
1

받은편지함 열기

사이드바에서 받은 편지함을 클릭합니다.

예상 결과: 최근 conversations은 봇, 채널, 방문자, 상태 및 시간과 함께 표시됩니다.
2

필요한 경우 필터링

채널, 봇, 읽지 않음 또는 상태 필터를 사용하여 대화를 찾으세요.

예상 결과: 목록은 필요한 대화 세트로 범위를 좁힙니다.
3

대화 열기

방문자 행을 클릭합니다.

예상 결과: 전체 스레드, 방문자 정보 및 회신 제어가 표시됩니다.
4

필요한 경우 번역하세요

방문자의 언어가 상담원의 언어와 다른 경우 번역 제어를 사용하세요.

예상 결과: 상담원이 이해하고 적절하게 답변할 수 있습니다.
5

답장 보내기

사람의 응답을 작성하여 보냅니다.

예상 결과: 메시지는 상담원/사람 응답으로 스레드에 추가됩니다.
6

해결 또는 공개 유지

대화가 완료되면 해결하거나 후속 조치를 위해 열어두세요.

예상 결과: 받은 편지함 상태는 실제 고객 상태와 일치합니다.
테스트 방법: 테스트 대화에 안전한 테스트 답장을 보내고 방문자 위젯과 Chat History에 표시되는지 확인하세요.
문제수정
답장을 보낼 수 없습니다.네트워크 상태, 대화 상태, 실시간 지원 요청 여부를 확인하세요.
방문자의 언어가 잘못되었습니다.답장하기 전에 번역을 사용하거나 봇 언어 설정을 업데이트하세요.
대화가 받은편지함에 없습니다.Chat History을 검색하고 올바른 봇을 사용한 위젯 테스트를 확인하세요.

다음에 해야 할 일: 활성 핸드오프 대기열에는 Live Support을 사용하고 감사에는 Chat History을 사용합니다.

실시간 지원

청구, 응답, AI에 반환 및 전달 해결

용도: AI가 인간에게 요청하거나 방문자가 명시적으로 에이전트를 필요로 하는 경우 이 기능을 사용하세요.

시작하기 전에
  • 실시간 지원을 활성화하기 전에 상담원을 확보하세요.
  • AI가 봇 지침에서 언제 핸드오프를 요청해야 하는지 정의합니다.
  • 핸드오프 알림에 대한 알림 설정을 활성화된 상태로 유지하세요.
1

Live Support 열기

사이드바에서 Live Support을(를) 클릭하세요.

예상 결과: 대기 중 및 활성 핸드오프 conversations이 표시됩니다.
2

요청 청구

대기 중인 대화에서 소유권 주장을 클릭하세요.

예상 결과: 다른 상담원은 대화가 활발하게 처리되는 것을 볼 수 있습니다.
3

컨텍스트 읽기

답장하기 전에 메시지와 방문자 세부정보를 열어보세요.

예상 결과: 상담원은 핸드오프가 발생한 이유를 이해합니다.
4

사람의 답장 보내기

명확하게 응답하고 스레드를 최신 상태로 유지하세요.

예상 결과: 방문자는 사람의 응답을 받습니다.
5

적절한 경우 AI에 다시 전달

문제에 대한 답변이 제공되고 AI가 계속 진행되면 손을 돌려주십시오.

예상 결과: AI가 대화 처리를 재개합니다.
6

완료되면 해결

방문자에게 더 이상 도움이 필요하지 않으면 해결을 클릭하세요.

예상 결과: 핸드오프가 닫히고 활성 대기열에서 제거됩니다.
테스트 방법: 테스트 핸드오프를 생성하고, 요청하고, 한 번 응답하고, 돌려주고, Live Support 및 Chat History의 상태 변경을 확인하세요.
문제수정
상담원이 요청을 놓쳤습니다.브라우저/이메일/푸시 알림을 활성화하고 대기열 소유권에 대한 프로세스를 추가합니다.
AI가 너무 빨리 인계받음해결되거나 반환될 때까지 인간의 통제가 활성 상태로 유지되도록 지침과 전달 규칙을 조정합니다.
외부 CRM이 동기화되지 않았습니다.개발자 레시피 섹션에서 웹훅이나 폴링을 사용하세요.

다음에 해야 할 일: 지원 팀이 sem.chat 외부에서 작업하는 경우 CRM/webhooks를 연결하세요.

연혁 및 연락처

대화/연락 기록 검색, 내보내기, 사용

용도: 감사, 리드 검토, CSV 내보내기 및 SendPulse 동기화에 이 기능을 사용하세요.

시작하기 전에
  • conversations, 연락처 또는 둘 다 필요한지 결정하십시오.
  • 내보내기 전에 올바른 날짜 범위를 적용하세요.
  • 필요한 것보다 더 많은 개인 데이터를 내보내지 마십시오.
1

Chat History 열기

사이드바에서 Chat History을(를) 클릭하세요.

예상 결과: 대화 필터, 통계, 대화 내용 목록이 표시됩니다.
2

검색 및 필터링

봇, 채널, 모드, 방문자 또는 날짜 범위별로 필터링하세요.

예상 결과: 일치하는 conversations만 표시됩니다.
3

성적표 열기

전체 메시지 스레드를 읽으려면 대화를 클릭하세요.

예상 결과: 전체 컨텍스트, 연락처 세부 정보 및 대화 메타데이터가 표시됩니다.
4

conversations 내보내기

내보내기를 클릭하고 가능한 경우 필요한 형식을 선택합니다.

예상 결과: 내보내기에는 필터링된 대화 데이터가 포함됩니다.
5

연락처 열기

사이드바에서 연락처를 클릭합니다.

예상 결과: 리드/연락처 기록은 소스, 봇, 상태와 함께 표시됩니다.
6

연락처 필터링 및 내보내기

연락처를 검색하고 원하는 기록을 선택한 다음 SendPulse로 내보내거나 동기화하세요.

예상 결과: 선택한 연락처는 선택한 작업에 따라 sem.chat 외부에서 사용할 수 있습니다.
테스트 방법: 필터링된 작은 CSV을 내보낸 후 로컬에서 열어 열과 날짜 범위가 올바른지 확인하세요.
문제수정
연락처에서 연락처가 누락되었습니다.리드 캡처가 활성화되어 있고 방문자가 양식을 제출했는지 확인하세요.
내보내기가 너무 큼내보내기 전에 날짜 범위나 봇 필터를 좁히세요.
SendPulse 동기화할 수 없음먼저 통합에서 SendPulse을 연결한 다음 연락처로 돌아갑니다.

다음에 해야 할 일: 작업 실행 후 성능 추세를 이해하려면 분석을 검토하세요.

08

채널 및 통합

BotFather, 수동 자격 증명, 대체 chat 링크, SendPulse 및 CRM 통합을 통해 Slack, Facebook, Instagram, WhatsApp, Telegram을 연결합니다.

/통합채널, CRM 및 이메일 연결
sem.chat 데모 워크스페이스의 실제 스크린샷
1채널 또는 CRM 통합 카드를 선택하세요.
2각 공급자에 대한 OAuth 또는 자격 증명 단계를 따르세요.
3동일한 페이지에서 통합을 연결 해제하거나 다시 테스트하세요.
채널 연결

메시징 채널 또는 CRM 통합 연결

용도: sem.chat이 웹사이트 위젯 외부에서 conversations을 수신하거나 연락처를 다른 도구로 보내야 할 때 이 기능을 사용하세요.

시작하기 전에
  • 외부 플랫폼에 대한 관리자 액세스 권한이 있습니다.
  • 어떤 봇이 채널 메시지를 받아야 하는지 알아보세요.
  • 프로덕션 계정을 연결하기 전에 테스트 채널을 사용하세요.
1

개방형 통합

사이드바에서 통합을 클릭합니다.

예상 결과: 사용 가능한 채널, CRM 도구, SendPulse 및 웹사이트 위젯 옵션이 표시됩니다.
2

통합을 선택하세요

Slack, 메타 채널, Telegram, SendPulse, CRM 또는 수동 자격 증명에서 연결을 클릭합니다.

예상 결과: 설정 대화상자 또는 OAuth 흐름이 열립니다.
3

공급자 설정 완료

OAuth 채널의 경우 요청된 권한을 승인하세요. 수동 채널의 경우 필수 토큰, 비밀번호, 계정 ID 또는 웹훅 URL을(를) 붙여넣습니다.

예상 결과: sem.chat은 연결을 저장하고 연결된 것으로 통합을 표시합니다.
4

봇 할당

대화 상자에서 요청할 때 해당 채널의 메시지를 처리해야 하는 봇을 선택하세요.

예상 결과: 수신 메시지는 올바른 도우미에게 전달됩니다.
5

채널 테스트

외부 채널에서 테스트 메시지를 보냅니다.

예상 결과: 메시지는 받은편지함이나 올바른 채널 아래의 Chat History에 표시됩니다.
6

필요한 경우 연결을 끊습니다.

채널이 중지되어야 할 경우 통합 카드에서 연결 끊기를 사용하십시오.

예상 결과: sem.chat은(는) 해당 통합을 통한 수신 또는 전송을 중지합니다.
테스트 방법: 연결된 채널을 통해 하나의 테스트 메시지를 보내고 봇 응답, 받은 편지함 행 및 기록 기록을 확인합니다.
문제수정
Telegram 토큰 실패BotFather에서 토큰을 생성하거나 재설정하고 다시 붙여넣습니다.
Slack 메시지가 도착하지 않습니다.앱 범위, 이벤트 구독 URL, 봇 토큰, 서명 비밀 및 채널 멤버십을 확인하세요.
메타 채널 연결 실패Facebook/Instagram/WhatsApp 계정에 관리자 권한과 필수 비즈니스 액세스 권한이 있는지 확인하세요.
SendPulse 동기화 실패SendPulse을(를) 다시 연결하고 연락처 필드가 매핑되었는지 확인하세요.

다음에 해야 할 일: 팀의 채널 소유권을 문서화하고 출시 후 Inbox를 모니터링하세요.

09

스케줄링

이벤트 유형 생성, 가용성 구성, 캘린더 연결, 예약 관리, 일회성 링크 생성, 예약 이메일 구성, 분석 검토, 유료 이벤트 설정 및 공개 예약 링크 테스트.

/스케줄링일정 작업 공간
sem.chat 데모 워크스페이스의 실제 스크린샷
1이벤트 유형, 예약, 분석, 일회용 링크, 달력, 이메일 및 설정에 대한 탭을 사용하세요.
2이벤트 유형을 편집, 복사, 포함, 활성화 또는 일시 중지합니다.
3공개 링크를 복사하고 비공개 예약 테스트를 실행하세요.
이벤트 편집자이벤트 유형 구성
sem.chat 데모 워크스페이스의 실제 스크린샷
1이름, 설명, 기간, 위치 및 버퍼를 입력합니다.
2이용 가능 여부, 예약 기간, 질문, 유료 이벤트 옵션, 취소 규칙을 설정하세요.
3링크를 공유하기 전에 이벤트를 저장하세요.
/book/:사용자 이름/:eventSlug공개 예약 페이지
sem.chat 데모 워크스페이스의 실제 스크린샷
1방문자는 공개 예약 페이지에서 날짜를 선택합니다.
2방문자는 이용 가능한 시간대를 선택합니다.
3방문자는 예약을 확인하고 확인 이메일을 받습니다.
이벤트 유형

이벤트 유형 생성 및 예약 링크 게시

용도: 방문자가 데모, 상담, 영업 통화, 온보딩 또는 지원 세션을 예약해야 할 때 이 기능을 사용하세요.

시작하기 전에
  • 이벤트 이름, 기간, 회의 유형, 소유자를 선택하세요.
  • 링크를 공유하기 전에 시간대와 사용 가능 여부를 설정하세요.
  • 이중 예약이 중요한 경우 캘린더를 연결하세요.
1

오픈 스케줄링

사이드바에서 일정을 클릭합니다.

예상 결과: 예약 작업 공간에는 이벤트 유형, 예약, 분석, 일회성 링크, 캘린더, 이메일 및 설정에 대한 탭이 표시됩니다.
2

이벤트 유형 만들기

생성을 클릭한 다음 이름, 설명, 기간, 위치, 버퍼 및 예약 규칙을 추가합니다.

예상 결과: 이 행사에는 방문객들이 이해할 수 있을 만큼 충분한 공개 정보가 있습니다.
3

가용성 설정

주간 시간, 날짜 재정의, 알림 창 및 예약 창을 구성합니다.

예상 결과: 방문자는 귀하가 제공하려는 시간만 볼 수 있습니다.
4

질문 추가

전화, 회사, 웹사이트, 회의 목표 등 필수 질문을 추가하세요.

예상 결과: 예약은 통화 전에 팀에 필요한 상황을 수집합니다.
5

캘린더 연결

캘린더를 열고 가능한 경우 Google, Outlook 또는 iCal을 연결하세요.

예상 결과: 바쁜 시간을 차단하고 확정된 예약을 달력에 기록할 수 있습니다.
6

이메일 및 알림 설정

이메일을 열고 확인, 미리 알림, 취소 및 메시지 일정 변경을 구성하세요.

예상 결과: 방문자는 올바른 예약 통신을 받습니다.
7

공개 링크 공유 및 테스트

이벤트 링크를 복사하여 비공개 창에서 열고 슬롯을 선택한 후 테스트 예약을 완료하세요.

예상 결과: 예약 탭에 예약이 표시되고 확인 메시지가 전송됩니다.
테스트 방법: 테스트 예약 1회, 일정 변경 1회, 취소 1회를 완료하세요. 각 이벤트가 예약 및 연결된 캘린더에 표시되는지 확인하세요.
문제수정
공개 페이지에 시간이 표시되지 않습니다.시간대, 주간 가용성, 날짜 재정의, 알림 창 및 연결된 달력 충돌을 확인하십시오.
예약 이메일이 누락되었습니다이메일 설정과 스팸 폴더를 확인한 후 다른 테스트 예약을 보내세요.
유료 이벤트 결제 실패게시하기 전에 청구/결제 통합 설정 및 통화가 유효한지 확인하세요.

다음에 해야 할 일: 봇, 웹사이트 또는 후속 이메일에 예약 링크를 삽입하세요.

고급 예약

일회성 링크, 분석, 삽입 및 유료 이벤트 사용

용도: 일정에 임시 가용성, 보고, 포함된 예약 또는 결제가 필요한 경우 이 기능을 사용하세요.

시작하기 전에
  • 먼저 이벤트 유형을 하나 이상 생성하세요.
  • 일회용 링크를 많이 사용하기 전에 캘린더를 연결하세요.
  • 유료 이벤트를 활성화하기 전에 환불/취소 정책을 정의하세요.
1

일회용 링크 만들기

일회용 링크를 열고 제공된 슬롯이나 규칙을 선택한 다음 링크를 생성하세요.

예상 결과: 수신자는 선택한 이용 가능 객실에서만 예약할 수 있습니다.
2

일정 포함

예약 흐름이 웹사이트에 표시되어야 하는 경우 이벤트 카드 삽입 옵션을 사용하세요.

예상 결과: 방문자가 전환하는 페이지에 예약 UI를 배치할 수 있습니다.
3

일정 분석 검토

스케줄링 내에서 분석을 엽니다.

예상 결과: 예약 현황, 완료 동향, 이벤트별 실적을 확인할 수 있습니다.
4

유료 이벤트 활성화

이벤트 편집기를 열고 가격, 통화, 결제 방식을 설정하세요.

예상 결과: 방문객은 이벤트 설정에 따라 결제 단계를 완료해야 합니다.
5

예약 감사

예약을 열고 예정된 항목, 완료된 항목, 취소된 항목, 일정이 변경된 항목을 검토합니다.

예상 결과: 팀은 출석 및 후속 조치를 관리할 수 있습니다.
테스트 방법: 공개 페이지와 포함된 페이지(사용된 경우)를 통해 예약하세요. 두 가지 모두 동일한 유형의 예약 기록을 생성하는지 확인하세요.
문제수정
일회성 링크가 잘못된 슬롯을 노출함더 작은 슬롯 세트 또는 더 엄격한 날짜 범위를 사용하여 링크를 다시 생성합니다.
포함된 예약이 너무 좁습니다.더 넓은 콘텐츠 컨테이너에 임베드를 배치하고 모바일 레이아웃을 확인하세요.
분석이 비어 있는 것 같습니다.실제 예약을 생성하거나 기다립니다. 분석은 예약 기록에 따라 달라집니다.

다음에 해야 할 일: 일정 결과를 보고서 및 분석에 연결합니다.

10

분석 및 보고서

날짜 범위를 선택하고, 사용자 정의 날짜를 사용하고, 핵심 측정항목을 읽고, CSV을 내보내고, 만족도 및 대화 추세를 검토하고, 이메일 보고서를 구성하고, 전달을 확인하세요.

/분석분석 대시보드
sem.chat 데모 워크스페이스의 실제 스크린샷
1기간 또는 맞춤 날짜를 선택하세요.
2대화, 만족도, 언어, 채널 및 전환 지표를 읽어보세요.
3오프라인 분석을 위해 CSV을 내보냅니다.
설정/보고서이메일 보고서 설정
sem.chat 데모 워크스페이스의 실제 스크린샷
1일일, 주간 또는 월간 보고서 주기를 선택합니다.
2보고서 수신자를 추가합니다.
3테스트 전달을 위해 즉시 보고서를 보냅니다.
분석 검토

분석 읽기 및 성능 데이터 내보내기

용도: 주간 검토, 출시 확인, 지원 품질 검토 및 전환 분석에 이 기능을 사용하세요.

시작하기 전에
  • 측정항목을 읽기 전에 기간을 선택하세요.
  • 평가 중인 봇이나 채널을 파악하세요.
  • 생산 성능을 보고할 때 비공개 테스트 날짜를 제외하세요.
1

오픈애널리틱스

사이드바에서 분석을 클릭합니다.

예상 결과: 대시보드 측정항목과 차트 패널이 표시됩니다.
2

기간 선택

오늘, 7일, 30일 또는 사용자 정의 날짜를 선택하세요.

예상 결과: 모든 차트는 선택한 기간으로 업데이트됩니다.
3

핵심 지표 읽기

conversations, 음성 통화 시간, 만족도, 전환 및 채널 믹스를 검토하세요.

예상 결과: 고객 상호 작용의 양과 질을 이해합니다.
4

동향 검토

대화 동향, 만족도 변화, 주요 질문, 언어/채널 패턴을 살펴보세요.

예상 결과: 봇 지침이나 인력 배치를 개선할 부분을 식별할 수 있습니다.
5

CSV 내보내기

팀에 스프레드시트 분석이 필요한 경우 내보내기 CSV을(를) 사용하세요.

예상 결과: CSV에는 선택한 기간과 측정항목이 포함되어 있습니다.
6

발견한 내용을 변화로 전환

데이터를 기반으로 봇 지침, 지식, 위젯 설정 또는 지원 범위를 업데이트합니다.

예상 결과: 분석은 구체적인 제품 개선으로 이어집니다.
테스트 방법: 간단한 맞춤 날짜 CSV을 내보내고 날짜 범위와 측정항목이 대시보드에 표시되는 내용과 일치하는지 확인하세요.
문제수정
측정항목이 너무 높은 것 같습니다.선택한 기간에 스테이징/테스트 conversations이 포함되어 있는지 확인하세요.
만족은 비어있다위젯 설정에서 평가를 활성화하고 방문자가 평가를 남길 때까지 기다립니다.
음성 통화 시간이 기대와 일치하지 않습니다.음성 모드가 의도한 봇에서만 활성화되어 있는지 확인하세요.

다음에 해야 할 일: 반복적으로 볼 수 있도록 이메일 보고서를 예약하세요.

보고서

반복 이메일 보고서 구성 및 테스트 전달

용도: 소유자, 관리자 또는 고객에게 자동 성과 요약이 필요할 때 이 기능을 사용하세요.

시작하기 전에
  • 보고서를 받을 사람을 결정합니다.
  • 확인된 이메일 주소를 사용하세요.
  • 비즈니스 검토 리듬에 맞는 흐름을 선택하세요.
1

설정을 열고 보고서를 엽니다.

설정으로 이동하여 보고서 탭을 선택하거나 가능한 경우 보고서 리디렉션을 사용하세요.

예상 결과: 보고서 주기, 수신자 및 기록이 표시됩니다.
2

케이던스 선택

일일, 주간 또는 월간 보고서를 활성화합니다.

예상 결과: 작업공간에 대한 보고서 일정이 저장됩니다.
3

수신자 추가

보고서를 받을 이메일 주소를 입력하세요.

예상 결과: 보고서는 올바른 이해관계자에게 전송됩니다.
4

즉시 보고서 보내기

지금 보내기 또는 이에 상응하는 즉시 보고서 작업을 클릭합니다.

예상 결과: 확인을 위해 보고서 이메일이 즉시 전송됩니다.
5

신고 내역 검토

보고서가 전송된 후 기록 패널을 확인하세요.

예상 결과: 배송상태와 시기를 확인하실 수 있습니다.
테스트 방법: 테스트 수신자에게 즉시 보고서를 보내고 수신 및 형식을 확인합니다.
문제수정
신고 메일이 도착하지 않습니다수신자 철자, 스팸 폴더, 신고 기록 상태를 확인하세요.
잘못된 사람이 신고를 받았습니다.수신자를 업데이트하고 다음 예정된 전송 전에 저장하세요.
신고 내용이 시끄럽게 느껴집니다.기간 기대치를 조정하고 분석을 사용하여 심층적인 수동 검토를 수행하세요.

다음에 해야 할 일: 보고서 흐름을 봇 개선을 위한 운영 리듬으로 사용하세요.

11

결제, 팀, 보안, 설정, 제휴

계획 시작 또는 업그레이드, 청구 포털 관리, 팀원 초대, 역할 설정, 프로필/언어 편집, 알림 구성, 2FA 활성화, 위험 영역 작업 사용 및 제휴 워크플로 실행.

/청구계획 및 청구 관리
sem.chat 데모 워크스페이스의 실제 스크린샷
1현재 계획, 평가판 상태 및 usage 제한을 검토하세요.
2업그레이드하기 전에 플랜 기능을 비교해 보세요.
3청구서, 결제 방법, 취소 또는 재활성화를 위한 청구 포털을 엽니다.
/설정설정, 팀 및 보안
sem.chat 데모 워크스페이스의 실제 스크린샷
1프로필과 언어에는 일반을 사용하세요.
2초대 및 역할에 팀을 사용하세요.
32FA, API 키 및 위험 영역 작업에 보안을 사용하세요.
/제휴제휴 프로그램 제어
sem.chat 데모 워크스페이스의 실제 스크린샷
1프로그램에 가입하여 추천 링크를 만드세요.
2캠페인의 추천 링크를 복사하세요.
3지급 이메일을 설정하고 적격한 지급을 요청하세요.
청구

계획 시작, 업그레이드, 취소 또는 재활성화

용도: 작업 공간에 평가판 활성화, 추가 한도, 송장, 결제 업데이트 또는 구독 변경이 필요한 경우 이 기능을 사용하세요.

시작하기 전에
  • 계정 소유자 또는 청구 관리자가 청구 작업을 수행해야 합니다.
  • 음성, 복제된 음성, 사용자 정의 아바타, API, 팀, CRM 및 채널 등 어떤 기능이 계획에 따라 결정되는지 확인하세요.
  • 결제 방법 및 청구서 변경을 위해 보안 청구 포털을 사용하세요.
1

공개 청구

사이드바에서 청구를 클릭합니다.

예상 결과: 현재 계획, 평가판 상태, usage 제한 및 계획 카드가 표시됩니다.
2

요금제 비교

chat, 음성, 팀, API, 아바타, 통합, 예약 및 지원 제한을 검토하세요.

예상 결과: 필요한 기능을 잠금 해제하는 계획이 무엇인지 알고 있습니다.
3

청구 간격 선택

토글이 가능한 경우 월별 또는 연간을 선택합니다.

예상 결과: 선택한 간격 동안 가격 및 절감액이 업데이트됩니다.
4

업그레이드 또는 결제 시작

원하는 플랜을 선택하고 결제를 완료하세요.

예상 결과: 결제 확인 후 구독이 활성화됩니다.
5

고객 포털 열기

결제 방법, 송장, 취소 또는 재활성화를 위해 결제 포털을 사용하세요.

예상 결과: 민감한 청구 작업은 보안 공급자 포털에서 이루어집니다.
6

기능 액세스 확인

잠긴 기능으로 돌아가서 앱을 다시 로드하세요.

예상 결과: 이제 계획에 포함된 경우 잠금 해제된 기능을 사용할 수 있습니다.
테스트 방법: 업그레이드 후 음성 복제 또는 API 키 등 이전에 잠긴 기능을 열고 잠금이 사라졌는지 확인하세요.
문제수정
업그레이드 후에도 기능이 잠긴 상태로 유지됩니다.앱을 새로 고치고 구독 동기화를 잠시 기다린 후 결제를 다시 확인하세요.
결제가 취소되었습니다.Billing으로 돌아가 결제를 다시 시작하세요. 결제가 취소된 후에는 요금제 변경이 발생하지 않습니다.
청구서 또는 카드 변경이 필요합니다.앱 내에서 결제 세부정보를 편집하는 대신 고객 포털을 엽니다.

다음에 해야 할 일: 팀원을 초대하고 소유자 계정을 보호하세요.

팀 및 보안

팀원 초대, 역할 설정, 프로필 편집, 2FA 활성화 및 설정 관리

용도: 작업 공간이 개인 설정에서 팀 작업으로 이동할 때 사용합니다.

시작하기 전에
  • 초대를 보내기 전에 각 팀원의 역할을 알아보세요.
  • 최소 권한 액세스 사용: 소유자, 관리자, 편집자, 뷰어.
  • 2FA를 위한 인증 앱을 준비하세요.
1

설정 열기

사이드바에서 설정을 클릭합니다.

예상 결과: 일반, 알림, 팀, 보고서, 개발자, 보안, 관련 탭이 표시됩니다.
2

프로필 및 언어 수정

일반에서 표시 이름, 프로필 정보 및 기본 언어를 업데이트합니다.

예상 결과: 앱은 사용자를 올바르게 식별하고 가능한 경우 선택한 언어를 사용합니다.
3

팀원 초대

팀을 열고 이메일을 입력하고 역할을 선택한 후 초대를 보냅니다.

예상 결과: 팀원은 초대 링크를 받고 수락할 때까지 보류 중으로 표시됩니다.
4

역할 권한 설정

모든 권한은 소유자, 관리는 관리자, 콘텐츠 변경은 편집자, 읽기 전용 액세스는 뷰어를 사용하세요.

예상 결과: 각 사용자는 자신의 책임에 따라 적절한 액세스 권한을 갖습니다.
5

알림 구성

이메일, 브라우저, 푸시, 실시간 지원, 청구 및 보고 알림을 선택하세요.

예상 결과: 적절한 사람들은 불필요한 소음 없이 알림을 받습니다.
6

2FA 활성화

보안을 열고, 이중 인증을 활성화하고, 코드를 스캔하고, 복구 세부 정보를 저장하세요.

예상 결과: 계정에는 비밀번호 로그인 후 두 번째 요소가 필요합니다.
7

위험 지대 조치를 신중하게 사용하세요

파괴적인 계정 조치를 취하기 전에 필요한 데이터를 내보내고 활성 위젯/통합을 확인하세요.

예상 결과: 작업 공간은 우발적인 데이터 손실을 방지합니다.
테스트 방법: 테스트 팀원을 초대하고, 별도의 브라우저에서 초대를 수락하고, 해당 역할이 의도한 기능만 노출하는지 확인하세요.
문제수정
초대 이메일이 누락되었습니다스팸을 확인하고, 초대를 다시 보내고, 주소를 확인하세요.
팀원이 너무 많이 본다역할을 낮추고 봇 액세스 설정을 검토하세요.
2FA 설정 실패기기 시간을 확인하고, QR 코드를 다시 스캔하고, 복구 세부 정보를 저장한 후 신뢰하세요.

다음에 해야 할 일: API 키가 필요한 사용자 및 서비스에 대해서만 구성하세요.

제휴

제휴 가입, 추천 링크 복사, 지급 이메일 설정 및 지급 요청

용도: 파트너나 고객이 새로운 sem.chat 사용자를 추천하고 커미션 활동을 추적하려는 경우 이 기능을 사용하세요.

시작하기 전에
  • 추천 속성을 보유해야 하는 계정을 사용하세요.
  • 지급을 요청하기 전에 지급 이메일을 준비하세요.
  • 추천 캠페인을 게시하기 전에 프로그램 규칙을 확인하세요.
1

오픈 제휴

사이드바에서 제휴를 클릭하거나 설정에 링크된 경우 제휴 탭을 엽니다.

예상 결과: 제휴 프로그램 페이지에는 가입, 추천, 지불금 및 내역 영역이 표시됩니다.
2

프로그램에 참여하세요

계정이 아직 가입되지 않은 경우 가입을 클릭하세요.

예상 결과: 추천코드와 추천링크가 생성됩니다.
3

추천 링크 복사

고유한 링크를 복사하여 콘텐츠, 캠페인 또는 파트너 메시지에 사용하세요.

예상 결과: 링크를 통한 가입은 제휴 계정으로 귀속될 수 있습니다.
4

지급 이메일 설정

지급 이메일을 입력하고 저장하세요.

예상 결과: 적격 지급금이 올바르게 전달될 수 있습니다.
5

추천 및 커미션 검토

추천인 목록, 커미션 상태, 지급 내역을 확인하세요.

예상 결과: 무엇이 대기 중인지, 적격인지, 이미 지불되었는지 알 수 있습니다.
6

지급 요청

프로그램 규칙과 최소 금액이 충족되면 지급 요청을 클릭하세요.

예상 결과: 지급 요청은 처리를 위해 기록됩니다.
테스트 방법: 개인 브라우저에서 추천 링크를 열고 추천 추적을 통해 예상 가입 흐름에 도달하는지 확인하세요.
문제수정
추천 링크가 누락되었습니다먼저 프로그램에 가입하거나 가입 후 제휴 페이지를 새로 고치세요.
대금지급 요청 불가최소 지급 기준액, 적격 커미션 상태, 지급 이메일을 확인하세요.
추천이 반영되지 않았습니다.방문자가 정확한 추천 링크를 사용했고 추적 매개변수를 제거하지 않았는지 확인하세요.

다음에 해야 할 일: 해당되는 경우 분석 및 보고서를 사용하여 추천 고객 영향을 모니터링하세요.

12

알림 및 App Updates

경고를 검토하고, 알림을 읽은 것으로 표시하고, 중요한 이벤트를 필터링하고, 앱 업데이트를 사용하여 새로운 제품 변경 사항을 이해하세요.

/알림알림 센터
sem.chat 데모 워크스페이스의 실제 스크린샷
1읽지 않은 알림을 검토한 후 모두 읽은 것으로 표시를 사용하세요.
2읽지 않음, 청구, 실시간 지원 또는 시스템 이벤트를 기준으로 필터링합니다.
3알림을 읽은 후 관련 기능을 엽니다.
/앱 업데이트앱 업데이트 피드
sem.chat 데모 워크스페이스의 실제 스크린샷
1새로운 기능과 수정 사항에 대한 릴리스 노트를 읽어보세요.
2워크플로가 변경되기 전에 세부 정보를 사용하여 팀원을 교육하세요.
3UI 또는 동작 변경 사항을 확인한 후 업데이트를 확인하세요.
알림

알림 검토 및 경고에 대한 조치

용도: 앱이 핸드오프, 청구 상태, 시스템 이벤트, 보고서 전달 또는 중요한 작업 공간 활동을 보고할 때 이 기능을 사용하세요.

시작하기 전에
  • 알림 기본 설정이 설정에 지정되어 있는지 확인하세요.
  • 핸드오프 경고가 활성화된 경우 실시간 지원을 받을 수 있습니다.
  • 읽은 알림으로 표시하기 전에 읽지 않은 알림을 검토하세요.
1

알림 열기

사이드바 또는 앱 헤더 알림 항목에서 알림을 클릭합니다.

예상 결과: 알림 센터에는 최근 경고가 나열됩니다.
2

알림 필터링

읽지 않은 필터 또는 카테고리 필터를 사용하여 청구, 실시간 지원, 봇, 보고서 또는 시스템 이벤트에 집중하세요.

예상 결과: 일치하는 경고만 계속 표시됩니다.
3

관련 페이지 열기

경고를 클릭하거나 해당 컨텍스트를 사용하여 결제, Live Support, 보고서 또는 관련 봇을 엽니다.

예상 결과: 알림을 읽기만 하는 것이 아니라 알림에 따라 조치를 취합니다.
4

읽은 것으로 표시

단일 경고를 읽은 것으로 표시하거나 검토 후 모두 읽은 것으로 표시를 사용합니다.

예상 결과: 읽지 않은 개수가 감소하고 검토된 항목이 더 이상 강조 표시되지 않습니다.
5

환경설정 조정

경고가 너무 많거나 너무 적으면 설정, 알림을 엽니다.

예상 결과: 알림 스트림은 팀 요구 사항과 일치합니다.
테스트 방법: 실시간 지원 요청이나 즉시 보고서와 같은 안전한 테스트 이벤트를 만든 다음 알림이 표시되고 읽음으로 표시될 수 있는지 확인하세요.
문제수정
알림이 도착하지 않음설정 알림 환경설정, 브라우저 권한, 이벤트가 실제로 발생했는지 확인하세요.
경고가 너무 많습니다.시끄러운 카테고리를 비활성화하거나 담당 팀 구성원에게만 보내십시오.
읽지 않은 개수가 멈춘 것 같습니다.모든 읽은 항목을 표시한 후 앱을 새로 고치고 필터가 읽지 않은 항목을 숨기지 않는지 확인하세요.

다음에 해야 할 일: 동작이 변경되거나 새 컨트롤이 나타나면 App Updates을(를) 검토하세요.

앱 업데이트

앱 업데이트를 사용하여 제품 변경 사항 이해

용도: 팀원이 새로운 기능을 사용하기 전에 변경된 사항을 알아야 할 때 이 기능을 사용하세요.

시작하기 전에
  • 주요 릴리스 이후 또는 UI가 변경되면 업데이트를 엽니다.
  • 지원 및 영업 사용자와 관련 업데이트 노트를 공유하세요.
  • 주요 변경 후 중요한 워크플로를 다시 테스트합니다.
1

App Updates 열기

사이드바에서 App Updates을(를) 클릭하세요.

예상 결과: 업데이트 피드에는 새로운 기능, 수정 사항 및 릴리스 정보가 표시됩니다.
2

최신 업데이트 읽기

최신 업데이트 카드 또는 세부정보 보기를 엽니다.

예상 결과: 변경된 내용과 영향을 받는 워크플로를 확인할 수 있습니다.
3

워크플로에 변경 사항 매핑

업데이트가 봇, 위젯, 지원, 예약, 청구 또는 개발자에 영향을 미치는지 식별합니다.

예상 결과: 올바른 팀원은 무엇을 확인해야 할지 알고 있습니다.
4

중요 경로 다시 테스트

업데이트가 프로덕션 워크플로우에 영향을 미치는 경우 이 문서의 관련 수동 단계를 반복하십시오.

예상 결과: 팀에서는 변경된 워크플로가 여전히 작동하는지 확인합니다.
5

내부적으로 공유

영향을 받는 지역을 소유한 사용자에게 업데이트 요약을 보냅니다.

예상 결과: 팀 채택이 더 원활해지고 지원 질문이 줄어듭니다.
테스트 방법: 관련 업데이트 후 영향을 받는 기능에 대한 가이드를 반복하고 스크린샷이나 단계 이름이 여전히 일치하는지 확인하세요.
문제수정
업데이트에 잠긴 기능이 언급되어 있습니다.Billing을 열어 현재 요금제에 포함되어 있는지 확인하세요.
팀이 변경 사항을 놓쳤습니다.릴리스 또는 주간 작업 루틴에 App Updates 검토를 추가하세요.
업데이트 후 문서가 오래되어 보입니다.엔지니어 가이드를 사용하여 스크린샷과 단계를 업데이트하세요.

다음에 해야 할 일: 기능이 발전함에 따라 공개 문서를 최신 상태로 유지하세요.

13

개발자 레시피

API 키 생성, x-api-key 인증 사용, 작업 기반 엔드포인트 호출, 라이브 지원을 CRM에 연결, 웹훅 등록, 서명 확인, 코드에 위젯 삽입 등이 있습니다.

설정 / 개발자API 키, 빠른 시작 및 usage 탭
sem.chat 데모 워크스페이스의 실제 스크린샷
1API 키 탭에서 API 키를 생성하고 취소합니다.
2첫 번째 컬 예제에는 Quick Start을 사용하세요.
3대용량 자동화를 활성화하기 전에 사용량을 검토하세요.
API 빠른 시작

API 키를 생성하고 첫 번째 API 호출을 수행합니다.

용도: 이를 보고 스크립트, 맞춤형 앱, CRM 브리지, 외부 실시간 지원 또는 자동화에 사용하세요.

시작하기 전에
  • 서버 측 환경을 사용하십시오. 브라우저 JavaScript에 API 키를 노출하지 마세요.
  • 각 통합에 대해 별도의 키를 생성합니다.
  • 비밀은 한 번 표시되므로 키를 즉시 복사하세요.
1

오픈 개발자

설정을 열고 개발자를 선택하거나 가능한 경우 개발자 리디렉션을 사용하세요.

예상 결과: API 키, Quick Start, 문서 및 사용 탭이 표시됩니다.
2

키 생성

키 생성을 클릭하고 명확한 라벨을 지정한 후 즉시 복사하세요.

예상 결과: 키는 sk_live_로 시작하며 서버 측 요청에 사용할 수 있습니다.
3

x-api-key 헤더 보내기

모든 공개 API 요청에 x-api-key을 포함합니다.

예상 결과: 공개 API은 요청을 인증하고 범위를 소유자로 지정할 수 있습니다.
4

봇 나열

필요한 봇 ID를 찾으려면 action=list-bots을(를) 호출하세요.

예상 결과: 응답은 봇 ID, 이름, 활성 상태 및 구성 요약을 반환합니다.
5

chat 메시지 보내기

POST 작업 chat(botId 및 메시지 포함)

예상 결과: 응답은 회신, 모델 및 usage 정보를 반환합니다.
6

usage 확인

대용량 작업을 실행하기 전에 action=usage을(를) 호출하세요.

예상 결과: 자동화가 실행되기 전에 현재 계획과 usage 상태를 알 수 있습니다.
7

필요할 때 키 순환

사용하지 않는 키를 취소하고 변경된 공급업체 또는 서비스에 대해 새 키를 생성합니다.

예상 결과: 오래된 서비스는 오래된 자격 증명을 계속 사용할 수 없습니다.
테스트 방법: 로컬 터미널이나 서버 환경에서 list-bots 및 chat을 실행한 다음 chat이 전송된 경우 Chat History에 대화가 나타나는지 확인하세요.
문제수정
401 또는 승인되지 않은 응답x-api-key 철자를 확인하고 전체 키를 복사한 후 취소되지 않았는지 확인하세요.
봇을 찾을 수 없습니다list-bots을 다시 사용하고 봇이 API 키 소유자에 속해 있는지 확인하세요.
브라우저 CORS 문제API 호출을 백엔드로 이동합니다. API 키는 서버측 사용을 위한 것입니다.

다음에 해야 할 일: 집중된 엔드포인트 참조를 위해 /api-docs을 사용하고 이 페이지를 워크플로 지침으로 유지하세요.

봇 나열
curl -X GET "https://akhsrklbijflesmcqxur.supabase.co/functions/v1/public-api?action=list-bots" \
  -H "x-api-key: sk_live_your_key_here"
chat 메시지 보내기
curl -X POST "https://akhsrklbijflesmcqxur.supabase.co/functions/v1/public-api" \
  -H "x-api-key: sk_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "action": "chat",
    "botId": "YOUR_BOT_ID",
    "message": "What can you help me with?"
  }'
실시간 지원 CRM 브리지

실시간 지원 요청을 CRM으로 폴링하거나 푸시합니다.

용도: 상담원이 다른 시스템에서 작업하지만 sem.chat이 방문자 대화를 받는 경우 이 기능을 사용하세요.

시작하기 전에
  • CRM 브리지의 이름을 딴 전용 API 키를 만듭니다.
  • 폴링이나 웹후크가 인프라에 적합한지 결정하세요.
  • 향후 응답/해결을 위해 CRM에 대화 ID가 저장되어 있는지 확인하세요.
1

대기 중인 핸드오프 나열

GET 작업=live-support-list, 상태=요청 또는 상태=모두.

예상 결과: CRM은 사람의 주의가 필요한 공개 conversations을(를) 수신합니다.
2

메시지 가져오기

GET 작업=live-support-messages(conversationId 포함).

예상 결과: CRM에는 전체 스레드 컨텍스트와 방문자 세부정보가 있습니다.
3

답장하기 전에 소유권 주장

POST 작업=live-support-claim.

예상 결과: sem.chat은(는) 대화를 적극적으로 처리된 것으로 표시합니다.
4

상담원 답장 보내기

POST action=live-support-reply(conversationId, 메시지 및 에이전트 이름 포함)

예상 결과: 방문자는 사람의 응답을 받고 스레드가 업데이트됩니다.
5

해결 또는 반환

POST 작업=live-support-resolve 해결 방법 해결 또는 반환이 포함됩니다.

예상 결과: 대화가 대기 대기열을 벗어나거나 AI가 제어를 재개합니다.
6

CRM의 로그 상태

최신 핸드오프 상태, 메시지 ID 및 타임스탬프를 저장합니다.

예상 결과: CRM 및 sem.chat은(는) 감사 가능한 상태로 유지됩니다.
테스트 방법: 안전한 핸드오프를 생성하고 이를 CRM에 미러링하고 브리지에서 응답하고 방문자 스레드 업데이트를 확인합니다.
문제수정
CRM 티켓이 중복되었습니다.conversationId을 CRM 브리지의 멱등성 키로 사용하세요.
답글이 순서 없이 도착함메시지 타임스탬프를 저장하고 여러 시스템의 동시 응답을 방지합니다.
에이전트가 작업하는 동안 AI가 응답합니다.먼저 핸드오프를 요청하고 에이전트가 완료된 후에만 핸드오프를 요청하세요.

다음에 해야 할 일: 폴링이 너무 느리거나 비용이 많이 드는 경우 웹후크를 등록하세요.

웹훅

웹훅 등록 및 X-SemChat-Signature 확인

용도: 시스템에 핸드오프, 메시지 및 해상도 업데이트를 위한 실시간 이벤트가 필요할 때 이 기능을 사용하세요.

시작하기 전에
  • 웹훅 URL은 HTTPS이어야 하며 공개 인터넷에서 연결할 수 있어야 합니다.
  • 웹훅 비밀을 즉시 저장하세요. 한 번 표시됩니다.
  • 이벤트를 처리하기 전에 서명을 확인하세요.
1

웹훅 등록

POST 작업 webhook-register(URL 및 이벤트 포함)

예상 결과: 응답에는 웹훅 세부정보와 일회성 서명 비밀이 포함됩니다.
2

비밀을 저장하세요

서버 환경이나 비밀 관리자에 비밀을 저장하세요.

예상 결과: 향후 배송을 확인할 수 있습니다.
3

서명 확인

X-SemChat-Signature을 읽고 원시 요청 본문에 대한 HMAC SHA-256과 비교합니다.

예상 결과: 정품 sem.chat 배송만 허용됩니다.
4

재시도를 멱등적으로 처리

중복 처리를 방지하려면 이벤트 ID 또는 대화/메시지 ID를 사용하세요.

예상 결과: 재시도에서는 중복된 CRM 레코드가 생성되지 않습니다.
5

웹훅 나열

GET 작업 webhook-list을 수행하여 구성된 끝점을 감사합니다.

예상 결과: URLs, 이벤트, 활성화 상태 및 최근 전송 상태를 볼 수 있습니다.
6

오래된 웹훅 삭제

POST 작업 webhook-delete(웹훅 ID 포함)

예상 결과: 이전 엔드포인트는 이벤트 수신을 중지합니다.
테스트 방법: 테스트 엔드포인트를 등록하고, 실시간 지원 이벤트를 트리거하고, 서명을 확인하고, 핸들러가 2xx를 반환하는지 확인하세요.
문제수정
서명이 일치하지 않습니다.JSON을(를) 구문 분석하지 않은 원시 본문을 사용하고 올바른 웹훅 비밀을 확인하세요.
웹훅은 이벤트를 수신하지 않습니다.이벤트 목록에 테스트 중인 이벤트가 포함되어 있고 엔드포인트가 HTTPS인지 확인하세요.
웹훅 시간 초과신속하게 승인하고 긴 작업을 비동기식으로 처리합니다.

다음에 해야 할 일: 엔드포인트 세부정보 및 예시를 보려면 엔지니어를 /api-docs에 연결하세요.

웹훅 등록
curl -X POST "https://akhsrklbijflesmcqxur.supabase.co/functions/v1/public-api" \
  -H "x-api-key: sk_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "action": "webhook-register",
    "url": "https://your-crm.example.com/semchat/webhook",
    "events": ["handoff.requested", "message.user", "handoff.resolved"]
  }'
웹훅 서명 확인
import crypto from 'node:crypto';

function verifySemChatSignature(rawBody, signature, secret) {
  const expected = crypto
    .createHmac('sha256', secret)
    .update(rawBody)
    .digest('hex');

  return crypto.timingSafeEqual(
    Buffer.from(signature || ''),
    Buffer.from(expected)
  );
}
끝점 지도

작업 기반 공개 API을 올바르게 사용하세요.

용도: 기능에 적합한 작업을 선택할 때 이 기능을 사용하세요.

시작하기 전에
  • 모든 요청은 동일한 공개 API 함수 URL을 사용합니다.
  • GET 작업은 쿼리 매개변수를 사용합니다. POST 작업은 JSON 본문을 사용합니다.
  • 모든 요청에 대해 x-api-key을(를) 보냅니다.
테스트 방법: API 키 또는 엔드포인트 변경 후 연기 테스트로 usage 및 list-bots을 호출하세요.
문제수정
방법 불일치엔드포인트 테이블에 표시된 방법을 사용하세요. 일부 작업은 GET 전용 또는 POST 전용입니다.
필수 값이 누락되었습니다.botId, conversationId, 웹훅 ID 및 작업 철자를 확인하세요.

다음에 해야 할 일: 첫 번째 요청에는 Quick Start을 사용한 다음 전체 참조에는 /api-docs을 사용하세요.

방법액션목적
GETlist-botsAPI 키 소유자가 사용할 수 있는 모든 봇을 나열합니다.
GETget-bot봇 ID로 하나의 봇 구성을 가져옵니다.
POSTchat방문자 메시지를 봇에 보내고 AI 응답을 반환합니다.
GETconversations봇의 최근 conversations을(최대 100개 레코드) 나열합니다.
GETusage반품 계획, 크레딧, 봇 수, conversations 및 API 키 usage.
GETlive-support-list인간 에이전트가 대기 중이거나 처리하는 conversations을 나열합니다.
GETlive-support-messages메시지 및 방문자 정보가 포함된 핸드오프 스레드를 가져옵니다.
POSTlive-support-reply외부 시스템에서 인간 에이전트 응답을 보냅니다.
POSTlive-support-claim대기 중인 핸드오프 대화를 요청합니다.
POSTlive-support-resolve핸드오프를 해결하거나 제어권을 AI로 반환합니다.
POSTwebhook-registerHTTPS 웹훅 엔드포인트를 등록합니다.
GETwebhook-list비밀을 반환하지 않고 웹훅 등록을 나열합니다.
POSTwebhook-deleteID별 웹훅 등록을 삭제합니다.
14

엔지니어 가이드: 기능 추가

경로, 대시보드 탐색, 봇 빌더 설정, Supabase 테이블/함수/마이그레이션, API 문서, 공개 문서, SEO 확인 및 로컬 확인을 추가합니다.

앱 기능 워크플로

앱 경로, 페이지, 탐색 항목 및 문서 항목 추가

용도: 새로운 고객 대면 대시보드 기능을 추가할 때 이 기능을 사용하세요.

시작하기 전에
  • 편집하기 전에 브랜치를 생성하세요.
  • 기능이 앱 저장소에 속하는지 또는 공개 sem.chat 프런트엔드 저장소에 속하는지 식별합니다.
  • 새 구조를 추가하기 전에 기존 경로, 사이드바, i18n 및 설정 패턴을 검사하세요.
1

경로 추가

고객 페이지에 대한 보호된 경로 또는 페이지가 공개되어야 하는 경우에만 공개 경로로 src/App.tsx를 업데이트하세요.

예상 결과: URL은 NotFound를 누르지 않고 앱에서 해결됩니다.
2

페이지 구성 요소 만들기 또는 업데이트

기존 페이지 패턴, 데이터 로드, 빈 상태, 로드 상태 및 권한을 사용합니다.

예상 결과: 이 기능은 대시보드와 일관되게 작동합니다.
3

대시보드 탐색 추가

필요한 경우 레이블, 아이콘, 경로 및 계획 게이트로 사이드바/탐색 소스를 업데이트합니다.

예상 결과: 사용자는 앱 셸에서 새 페이지를 검색할 수 있습니다.
4

봇 빌더 탭 또는 설정 추가

기능이 봇에 속하는 경우 Bot Builder 탭 내에 추가하고 기존 저장 흐름을 통해 유지하세요.

예상 결과: 봇별 구성은 로컬 상태에 머무르지 않고 봇과 함께 저장됩니다.
5

Supabase 스키마/함수 변경 사항 추가

서버 측 작업을 위한 테이블/정책 및 에지 기능에 대한 마이그레이션을 만듭니다.

예상 결과: 데이터베이스 및 서버 동작은 반복적으로 배포될 수 있습니다.
6

공개인 경우 API 모양 업데이트

supabase/functions/public-api/index.ts에 작업 처리를 추가하거나 확장하고 x-api-key 동작을 문서화하세요.

예상 결과: 통합에서는 해당 기능을 안전하게 사용할 수 있습니다.
7

앱 문서 및 공개 문서 업데이트

인앱 개발자 문서와 이 /documentation 페이지를 스크린샷과 클릭별 단계로 업데이트하세요.

예상 결과: 사용자와 엔지니어는 두 위치 모두에서 기능을 볼 수 있습니다.
8

검사 실행

앱 테스트/빌드, 공개 사이트의 SEO 최적화, 사이트맵 확인 및 브라우저 확인을 실행합니다.

예상 결과: 이 기능은 로컬에서 작동하며 공개 사이트는 크롤링 가능한 상태로 유지됩니다.
테스트 방법: 새 경로를 열고, 엔드 투 엔드 기능을 사용하고, 콘솔/네트워크 오류를 검사하고, UI에서 데이터베이스 변경 사항을 확인하세요.
문제수정
경로는 작동하지만 탐색이 강조표시되지 않습니다.사이드바 경로 일치 및 리디렉션 경로를 확인하세요.
데이터는 로컬에서 작동하지만 배포되지는 않습니다.마이그레이션, RLS 정책 및 Edge 기능 환경 변수를 확인합니다.
사이트맵에서 공개 문서가 누락되었습니다.SEO 최적화 프로그램을 실행하고 sitemap.xml에서 표준 URL을 검사하세요.

다음에 해야 할 일: UI가 변경될 때마다 문서 스크린샷을 캡처하거나 재생성합니다.

문서 관리 워크플로

제품 변경 후 이 공개 문서 페이지를 업데이트하세요.

용도: 스크린샷, 작업 흐름, API 동작 또는 탐색 변경 시 이 기능을 사용하세요.

시작하기 전에
  • 안전한 데모 데이터만 사용하세요.
  • 실제 고객, 이메일, 결제 세부정보, API 키 또는 비공개 conversations을 노출하지 마세요.
  • 먼저 영어 매뉴얼을 업데이트한 다음 SEO 검사 전에 각 현지화된 문서 페이지를 새로 고칩니다.
1

변경된 경로 감사

앱 경로를 열고 시각적으로나 절차적으로 변경된 사항을 확인하세요.

예상 결과: 편집이 필요한 가이드, 스크린샷, 문제 해결 행을 알고 있습니다.
2

안전한 스크린샷을 캡처하거나 생성하세요

WebP 자산을 자산/문서 아래에 저장하기 전에 데모 작업 공간과 마스크 비밀을 사용하세요.

예상 결과: 스크린샷은 정확하고 게시해도 안전합니다.
3

가이드 업데이트

관련 용도, 시작하기 전, 단계, 예상 결과, 테스트, 문제 해결 및 다음 섹션을 편집합니다.

예상 결과: 가이드는 사용자에게 클릭할 내용과 클릭할 때마다 어떤 일이 발생해야 하는지 알려줍니다.
4

필요한 경우 탐색 업데이트

주요 페이지인 경우 고정 목차, 모바일 섹션 선택기 및 시각적 색인에 섹션을 추가합니다.

예상 결과: 독자는 새로운 콘텐츠를 빠르게 찾을 수 있습니다.
5

SEO 도구 실행

node tools/seo-optimize-static-pages.js 및 node tools/seo-optimize-static-pages.js --check를 실행하세요.

예상 결과: 표준, 메타데이터, 사이트맵 및 로봇 출력은 올바르게 유지됩니다.
6

정리 및 차이점 확인 실행

node tools/static-translation-cleanup.js --audit 및 git diff --check를 실행합니다.

예상 결과: 정적 번역과 공백이 깨끗합니다.
7

브라우저 확인

사이트를 로컬로 제공하고 데스크톱 및 모바일에서 테스트/문서화합니다.

예상 결과: 이미지 로드, 검색 작업, 복사 버튼 작업, TOC 하이라이트 및 레이아웃이 쿠키 배너와 겹치지 않습니다.
테스트 방법: /documentation에서 변경된 기능 이름을 검색하고 올바른 가이드 블록이 나타나는지 확인하세요.
문제수정
모바일에서 스크린샷 마커가 드리프트됩니다.스크린샷 이미지 내부에 마커를 유지하거나 반응형 마커 좌표를 사용하세요.
검색에서 새로운 가이드가 누락되었습니다.data-title에 유용한 키워드를 추가하고 사용자가 검색하는 정확한 제품 용어를 포함하세요.
현지화된 문서가 오래됩니다영어 매뉴얼을 편집한 후 각 현지화된 문서 페이지를 새로 고치고 SEO 최적화 도구를 다시 실행한 다음 sitemap.xml에 모든 문서 URL이 포함되어 있는지 확인합니다.

다음에 해야 할 일: 문서 페이지, 자산, 머리글/바닥글 링크, .htaccess 및 사이트맵 변경 사항을 함께 커밋합니다.

집중된 API 참조가 필요합니까?

이전 /api-docs 페이지는 엔드포인트 수준 API 세부정보에 계속 사용할 수 있습니다.

API 문서 열기