Magento 커넥터
호환 대상 Magento
Magento 2 또는 Adobe Commerce를 FreeScout에 연결하여 대화에 일치하는 고객 주문과 구매 컨텍스트가 표시되도록 하세요. 작은 읽기 전용 Magento 모듈이 Magento REST API를 통해 지원 요약을 노출하고, FreeScout 커넥터가 이를 대화 사이드바에 표시합니다. ReplyRabbit은 또한 제품 소유권 컨텍스트를 AI 계층에 제공하여 초안이 고객이 구매한 내용을 참조할 수 있도록 합니다.
개요를 찾고 계신가요?
개요
Magento 커넥터는 FreeScout 대화에 주문 사이드바를 추가합니다. 대화에 고객 이메일 주소가 있으면 커넥터는 다음을 호출합니다 moo-support/summary Magento 스토어의 엔드포인트로 주문을 매칭하고 대화 옆에 표시합니다.
사이드바에 고객 패널, 전체 주문 내역, 수량과 가격이 포함된 주문별 품목, 재무 합계, 고객 생애 가치(CLV), 평균 주문 가치(AOV), 그리고 더 관련성 높은 초안을 위해 ReplyRabbit AI 컨텍스트로 흘러가는 제품 소유 권한이 표시됩니다.
설치할 두 가지 구성 요소가 있습니다:
- 그 ReplyRabbit Connector 모듈 Magento 2용. 두 개의 읽기 전용 REST 엔드포인트를 추가합니다 (
/rest/V1/moo-support/summary그리고/rest/V1/moo-support/purchased-products) 전용 관리 권한 뒤에 있는 ReplyRabbit Connector API. 스토어프론트나 결제는 변경하지 않습니다. - 그 FreeScout Magento 커넥터 모듈. Magento 통합 액세스 토큰을 사용하여 HTTPS를 통해 해당 엔드포인트를 호출하고 주문 사이드바를 렌더링합니다. FreeScout에 자체 메일함별 설정 페이지가 있습니다.
주문 사이드바는 자체적으로 작동합니다. AI 초안으로 흐르는 제품 소유 권한이 ReplyRabbit을 사용하는 부분입니다.
사전 요구 사항
시작하기 전에 다음이 있는지 확인하세요:
- 작동하는 FreeScout 설치입니다.
- HTTPS로 접근 가능한 Magento 2.4 이상 스토어(Magento Open Source 또는 Adobe Commerce)로, Magento CLI 명령을 실행할 수 있는 SSH 접근 권한이 필요합니다.
- Integration을 생성할 Magento 관리자 접근 권한.
- AI 초안에 제품 소유권 컨텍스트를 원하는 경우 ReplyRabbit을 설치하고 활성화하세요.
- Magento Connector 라이선스(FreeScout 설치 1개당 18 EUR 일회성) 또는 이를 포함하는 활성 ReplyRabbit Pro 또는 Team 요금제입니다.
ReplyRabbit이 아직 설치되지 않았다면 다음으로 시작하세요 ReplyRabbit 모듈 설치 방법, 그런 다음 완료 ReplyRabbit 설정 방법.
Magento 모듈 설치
Magento 모듈 다운로드
로그인 위치 app.replyrabbit.app 그리고 Magento 커넥터 카드에서 Magento 모듈 ZIP을 다운로드하세요.app/code에 압축 해제하세요
ZIP을 Magento 루트에 업로드하고 압축을 푸세요. 다음이 생성됩니다app/code/Moogento/SupportData.모듈 활성화
Magento 루트에서 실행:프로덕션 모드의 스토어에서는 다음도 실행하세요bashbin/magento module:enable Moogento_SupportData bin/magento setup:upgrade bin/magento setup:di:compile bin/magento cache:flushbin/magento setup:static-content:deploy모든 모듈 설치와 마찬가지로.
Composer 설치
moogento/m2-supportdata Moogento 패키지 저장소에서. 위의 ZIP 설치는 Composer 자격 증명이 필요하지 않습니다.Magento 통합 토큰 생성
커넥터는 Magento 통합의 액세스 토큰으로 인증합니다. 모듈의 읽기 전용 권한으로 범위가 지정된 토큰을 생성하세요.
통합 열기
Magento 관리자에서 다음으로 이동하세요 시스템, 그런 다음 확장, 그런 다음 통합, 그리고 클릭 새 통합 추가.이름 지정 및 API 범위 설정
"ReplyRabbit Connector"와 같은 이름과 관리자 비밀번호를 입력하세요. 다음에서 API 탭에서 설정하세요 리소스 액세스 다음으로 사용자 정의 그리고 체크만 ReplyRabbit Connector API (최상위 관리 트리 아래). 저장합니다.액세스 토큰 활성화 및 복사
클릭 활성화 새 통합 옆에서, 그런 다음 허용. 복사 액세스 토큰. Magento는 통합 세부 정보에 토큰을 표시하므로 나중에 다시 볼 수 있습니다.
읽기 전용 액세스
FreeScout 커넥터 모듈 설치
FreeScout Magento 커넥터 모듈은 Magento 엔드포인트를 호출하고 대화에서 주문 사이드바를 렌더링합니다. ReplyRabbit과 별개인 자체 설정이 있는 자체 모듈입니다.
커넥터 모듈 다운로드
로그인 위치 app.replyrabbit.app FreeScout 커넥터 모듈 ZIP을 다운로드하세요. 커넥터를 구매했거나 활성 ReplyRabbit Pro 또는 Team 플랜을 보유하면 두 다운로드가 모두 나타납니다.FreeScout에 업로드
FreeScout에서 다음으로 이동하세요 모듈, 업로드 버튼을 클릭하고 ZIP을 선택한 후 설치합니다.모듈 활성화
다음을 활성화하세요 Magento 통합 모듈 목록에서 모듈.
메일박스별 구성
모듈이 설치된 후 커넥터 자체의 메일박스별 설정 페이지에서 스토어에 연결하세요.
커넥터 설정 열기
FreeScout에서 Magento 주문 데이터를 표시해야 하는 사서함을 열고 사서함 설정 메뉴를 열고 다음을 선택하세요 스토어 커넥터. 이것은 Magento 커넥터의 설정 페이지이며 ReplyRabbit 설정 내부의 섹션이 아닙니다.Magento 기본 URL 입력
HTTPS를 통해 Magento 스토어의 기본 URL을 붙여넣으세요. 예:https://your-store.com. 끝의 슬래시는 필요하지 않습니다.액세스 토큰 입력
다음을 붙여넣으세요 액세스 토큰 Magento 통합에서. 암호화되어 저장되며, 저장 후에는 마스킹된 미리보기만 표시됩니다.스토어 ID 설정 (선택 사항)
모든 스토어의 주문을 일치시키려면 비워 두세요. 사이드바를 하나의 스토어 또는 스토어 뷰로 제한하려면 Magento 스토어 ID를 입력하세요.커넥터 라이선스 키 추가
커넥터를 구매했다면 라이선스 키를 입력하세요. 활성 ReplyRabbit Pro 또는 Team 요금제가 설치를 포함한다면 이 단계를 건너뛰세요.저장 및 테스트
설정을 저장하세요. 고객 이메일이 Magento 주문과 일치하는 FreeScout 대화를 열고 주문 사이드바가 나타나는지 확인하세요.
각 FreeScout 메일박스는 자체 기본 URL, 액세스 토큰 및 스토어 ID를 저장하므로 서로 다른 메일박스를 서로 다른 Magento 스토어 또는 스토어 뷰에 연결할 수 있습니다.
커넥터가 보여주는 것
- 대화 담당자를 위한 고객 패널입니다.
- 주문 번호, 날짜, 상태 및 총액이 포함된 전체 주문 내역.
- 수량 및 가격이 포함된 주문별 품목.
- 재무 합계(소계, 할인, 배송, 세금, 환불).
- 고객 생애 가치(CLV) 및 평균 주문 가치(AOV).
- AI 초안을 위한 제품 소유권 자격.
커넥터를 얻는 방법
Magento Connector는 유료 모듈입니다. 두 가지 방법으로 얻을 수 있습니다:
- FreeScout 설치 하나에 대한 일회성 라이선스로 18 EUR에 Magento Connector를 구매한 후 커넥터 설정에 라이선스 키를 붙여넣으세요.
- 커넥터가 추가 비용 없이 포함된 활성 ReplyRabbit Pro 또는 Team 플랜을 사용하세요.
라이선스를 구매하거나 다음에서 커넥터를 다운로드하세요 ReplyRabbit 대시보드. 방문 가격 페이지 ReplyRabbit 플랜 옵션. 활성 ReplyRabbit Pro 또는 Team 플랜이 설치를 포함하면 커넥터는 구성 후 별도 라이선스 키 없이 작동합니다.
문제 해결
| 증상 | 확인할 것 |
|---|---|
| 주문 사이드바가 표시되지 않음 | 커넥터 설정의 기본 URL 및 액세스 토큰이 올바른지, 메일박스 패널이 활성화되어 있는지 확인하세요. |
| 스토어에서 HTTP 404 | ReplyRabbit Connector 모듈이 설치되지 않았거나 활성화되지 않았습니다. 다음을 다시 실행하세요 bin/magento module:enable Moogento_SupportData 그리고 bin/magento setup:upgrade, 그런 다음 캐시를 비웁니다. |
| 스토어에서 HTTP 401 또는 403 | 통합이 활성화되지 않았거나, 토큰이 재생성되었거나, 통합에 ReplyRabbit Connector API 리소스. 통합을 다시 활성화하고 현재 토큰을 붙여넣으세요. |
| "Connection refused" 또는 시간 초과 오류 | FreeScout 서버가 HTTPS를 통해 스토어 URL에 접근할 수 있는지 확인하세요. 방화벽, IP 허용 목록 또는 유지 관리 모드가 요청을 차단할 수 있습니다. |
| 기본 URL이 거부됨 | 스토어는 HTTPS로 제공되어야 합니다. 일반 http:// URL 또는 연결할 수 없는 호스트는 거부됩니다. |
| 알려진 고객에 대해 주문이 비어 있음 | FreeScout 대화의 고객 이메일이 Magento 주문의 이메일과 일치하는지, 그리고 스토어 ID(설정된 경우)가 주문한 스토어와 일치하는지 확인하세요. |
| 품목, 재무 또는 CLV가 표시되지 않음 | 커넥터 라이선스 키가 저장되었는지, 또는 활성 ReplyRabbit Pro 또는 Team 요금제가 설치를 포함하는지 확인하세요. |
| 초안에 제품 소유권 컨텍스트가 표시되지 않음 | 커넥터가 라이선스되었는지, ReplyRabbit이 설치되었는지, 커넥터가 주문을 반환하는지, 메일박스에 대해 AI 컨텍스트 기능이 활성화되어 있는지 확인하세요. |
더 광범위한 문제는 다음을 참조하세요 ReplyRabbit 문제 해결.
개인정보 및 데이터 처리
커넥터가 Magento를 쿼리하면 HTTPS를 통해 고객 이메일 주소를 귀하의 Magento 스토어로 전송합니다. 스토어에서 반환된 주문 데이터가 FreeScout 사이드바를 채우고 ReplyRabbit과 함께 초안용 AI 컨텍스트를 구축합니다.
통합 토큰에는 읽기 전용 ReplyRabbit Connector API 리소스이므로 커넥터는 스토어에 절대 쓰지 않습니다. 토큰은 FreeScout에 암호화되어 저장되며, 아웃바운드 요청은 TLS를 검증하고 리디렉션을 따르지 않습니다.
Magento 주문 데이터는 메일함에 선택된 AI 제공자를 통하지 않고는 제3자에게 전송되지 않으며, AI 컨텍스트 기능이 사용할 때만 전송됩니다. 정책상 주문 데이터가 전적으로 자체 서버에 있어야 하는 경우 메일함에 로컬 AI 제공자(예: Ollama)를 사용하세요.
다음 단계
- 완료 ReplyRabbit 설정 방법 메일박스에 여전히 제공자, 컨텍스트 또는 스타일 설정이 필요한 경우.
- WooCommerce에서도 사용 중이신가요? 다음을 참조하세요 WooCommerce 커넥터 가이드.
FAQ
커넥터에 Magento 모듈이 필요한가요?
예. 커넥터는 ReplyRabbit Connector 모듈이 Magento 2 REST API에 추가하는 지원 요약 엔드포인트를 읽습니다. 두 개의 다운로드가 있으며, Magento 모듈과 FreeScout Magento 커넥터 모듈 모두 ReplyRabbit 계정에서 사용할 수 있습니다.
어떤 Magento 버전이 지원되나요?
PHP 8.0부터 8.4까지의 Magento 2.4 이상(Magento Open Source 및 Adobe Commerce 포함). Magento 1은 지원되지 않습니다.
Magento 커넥터 비용은 얼마인가요?
Magento Connector는 활성 ReplyRabbit Pro 또는 Team 플랜에 포함됩니다. 그렇지 않은 경우 하나의 FreeScout 설치에 대해 18 EUR 일회성 라이선스 비용이 듭니다. 구매한 경우 라이선스 키를 커넥터 설정에 붙여넣으세요.
액세스 토큰에 필요한 권한은 무엇인가요?
읽기 전용인 ReplyRabbit Connector API 리소스만. 커넥터는 스토어에 절대 쓰지 않으므로 통합에는 다른 관리자 권한이 필요하지 않습니다.
각 FreeScout 메일박스를 서로 다른 Magento 스토어에 연결할 수 있나요?
예. 각 메일함은 커넥터 설정에 자체 기본 URL, 액세스 토큰, 선택적 스토어 ID를 저장하므로 서로 다른 스토어나 스토어 뷰를 서로 다른 메일함에 연결할 수 있습니다.