
FreeScout용 Stripe 커넥터
호환 대상 Stripe
Stripe 커넥터는 FreeScout 대화 옆에 고객 결제 및 구독 맥락을 제공합니다. 제한된 읽기 전용 Stripe API 키를 사용하므로 Stripe에서 아무것도 변경하지 않고 정보를 조회할 수 있습니다.
개요를 찾고 계신가요?
커넥터가 보여주는 것
FreeScout 대화에 고객 이메일 주소가 있으면 커넥터가 Stripe에서 일치하는 고객 및 최근 결제 기록을 검색합니다. 발견된 내용에 따라 사이드바에 다음이 표시될 수 있습니다:
- Stripe 고객에 연결된 이름과 이메일, 고객 시작 날짜를 포함한 고객 신원.
- Stripe에서 구독을 여는 링크 아이콘, 기간, 색상 상태 점, 결제 주기가 포함된 첫 번째 항목의 단가를 표시하는 구독(예:
€49/m또는€120/y, 그리고 제품 이름(가격 별명, 그다음 일반 레이블로 대체). Cancels, Trial end, Discount 같은 열은 플랜에 해당 항목이 있을 때만 표시됩니다. - 주문 스타일 표의 결제: Stripe에서 결제를 여는 링크 아이콘, 날짜, Radar 위험 및 카드 확인 아이콘이 있는 상태 점, 총액, 그리고 구매한 항목의 잘린 목록.
- 환불 및 분쟁은 해당 결제 행의 세부 정보로 표시됩니다. 세부 정보 열은 하나 이상의 행에 표시할 내용이 있을 때만 나타납니다.
- 사용 가능한 거절 사유가 있는 실패한 결제가 동일한 세부 정보 열에 표시됩니다.
- 통화 기호가 있는 경우 해당 기호가 포함된 금액, 예:
€61또는$12.50, 그렇지 않으면 통화 코드; 날짜는 다음과 같이 간결하게 표시됩니다Sep 24 '26. - 로드된 결제에 대한 캡처됨, 환불 및 순 합계입니다.
- 이메일 연결: 고객이 Stripe에 있는 주소와 다른 주소로 작성하는 경우 Stripe 이메일을 스레드에 연결하면 패널에 해당 고객의 결제가 표시됩니다.
- 저장된 결제 수단의 브랜드, 마지막 네 자리 및 만료일입니다.
커넥터가 결제 기록의 일부만 볼 수 있는 경우 합계 아래의 단일 메모가 합계가 로드된 결제만 포함한다고 표시합니다. 모든 합계에 반복되지 않습니다.
커넥터는 각 조회를 제한하고 해당 고객과 연결된 레코드만 확인합니다. 분쟁이나 결제 기록을 위해 전체 Stripe 계정을 스캔하지 않습니다. 비어 있거나 부분적인 결과가 Stripe에 다른 레코드가 없다는 것을 증명하지 않습니다.
사전 요구 사항
시작하기 전에 다음이 있는지 확인하세요:
- 작동하는 FreeScout 설치입니다.
- 제한된 API 키를 생성할 수 있는 Stripe 대시보드 접근 권한.
- 활성 ReplyRabbit Pro 또는 Team 라이선스, 또는 독립형 Stripe Connector 라이선스. 독립형 라이선스는 FreeScout 설치당 일회성 구매로 18 EUR입니다.
- 초안에 선택적이고 명시적으로 활성화된 AI 커머스 컨텍스트를 원하는 경우에만 ReplyRabbit을 설치하세요.
로그인 ReplyRabbit 대시보드. 활성 ReplyRabbit Pro 또는 Team 플랜에는 커넥터 다운로드가 포함됩니다. 두 플랜이 없으면 거기서 독립형 라이선스를 구매한 후 커넥터를 다운로드하고 라이선스 키를 대시보드에 보관하세요.
제한된 Stripe API 키 생성
커넥터에는 Stripe 제한된 키, 비밀 키가 아닙니다. Stripe 대시보드에서 새 제한 키를 만드세요. 설정 고객, 구독, 인보이스, 청구, PaymentIntents, PaymentMethods, 그리고 분쟁 다음으로 읽기, 그리고 설정 제품 다음으로 읽기 구독 플랜 이름을 표시하려면. Products 읽기 권한이 없으면 구독은 가격 닉네임이나 일반 레이블로 대체됩니다. 관련 없는 모든 권한 세트는 다음으로 두세요 없음.
비밀 키를 붙여넣지 마십시오
Stripe가 표시할 때 제한된 키를 복사하세요. 비밀번호처럼 취급하세요. 커넥터는 저장 시 암호화하며 전체 값을 다시 표시하지 않습니다.
커넥터 설치
Stripe Connector 다운로드
로그인 위치 app.replyrabbit.app. 활성 ReplyRabbit Pro 또는 Team 플랜을 통해 커넥터를 다운로드하거나 먼저 독립형 Stripe Connector 라이선스를 구매하세요.FreeScout에 업로드
FreeScout에서 다음을 여세요 모듈, 업로드 컨트롤을 사용하여 ZIP을 선택하고 설치합니다.모듈 활성화
활성화 Stripe 커넥터 FreeScout 모듈 목록에서.
메일박스 구성
Stripe Connector 설정 열기
Stripe 결제 컨텍스트를 표시해야 하는 FreeScout 메일함을 연 다음 선택하세요 Stripe 커넥터 설정 메뉴에서.제한된 키 붙여넣기
커넥터를 활성화하고 제한된 읽기 전용 Stripe 키를 붙여넣으세요. 독립형 커넥터 라이선스를 구매한 경우 ReplyRabbit 계정의 라이선스 키도 붙여넣으세요. 설치된 ReplyRabbit Pro 또는 Team 라이선스는 Stripe 커넥터를 자동으로 잠금 해제합니다. 설정을 저장하세요.저장된 키 테스트
사용 저장된 키 테스트 Stripe가 키와 고객 읽기 권한을 수락하는지 확인하세요.일치하는 대화 확인
고객 이메일이 Stripe에 존재하는 대화를 열고 사이드바에 Stripe 패널이 나타나는지 확인하세요.
각 FreeScout 메일박스는 자체 암호화된 Stripe 키를 저장합니다. 서로 다른 Stripe 계정을 서로 다른 메일박스에 연결할 수 있습니다.
다른 이메일로 작성하는 고객 매칭
Stripe는 대화의 이메일 주소로 매칭합니다. 동료가 작성하거나 고객이 Stripe 고객에 등록된 주소와 다른 주소를 사용하는 경우 스레드에 올바른 이메일을 연결하세요:
Stripe 패널 찾기
대화를 열고 사이드바에서 Stripe 패널을 찾으세요.다른 이메일 연결
선택 다른 이메일 연결, 그런 다음 스레드에서 주소를 선택하거나 Stripe에 사용된 청구 주소를 입력하세요.패널 확인
패널은 이제 해당 고객의 결제를 표시하고 연결 대상 주소, 그리고 제공 링크 제거. 커넥터 설정은 저장된 모든 링크를 다음과 함께 나열합니다 제거 주소당 action.
연결하면 스레드의 모든 비메일함 주소, 발신자, To, Cc가 선택한 Stripe 이메일에 매핑됩니다. 이 연결은 메일함에 저장되므로, 이후 해당 주소 중 어디서든 오는 대화는 동일한 Stripe 고객으로 확인됩니다. 커넥터는 여전히 Stripe 데이터만 읽습니다.
선택적 ReplyRabbit 초안 컨텍스트
사이드바는 ReplyRabbit 없이도 작동합니다. ReplyRabbit은 AI 초안 생성 시 최근 Stripe 세부 정보를 사용하려는 경우에만 필요합니다.
옵트인하려면 다음을 설정하세요 STRIPEINTEGRATION_COMMERCE_CONTEXT_ENABLED=true FreeScout 환경에서, 그런 다음 메일박스에 대해 커넥터를 활성화하세요. ReplyRabbit 측에서는 다음을 설정하거나 REPLYRABBIT_COMMERCE_CONTEXT_ENABLED=true 모든 메일박스에 대해, 또는 메일박스 설정, 제품, 초안의 스토어 데이터에서 한 메일박스에 대해 켜기를 선택하세요. 해당 행은 메일박스에 스토어 커넥터가 사용 가능해지면 Essentials 보기에 표시됩니다. 그 전에는 모든 설정으로 전환하여 찾으세요. FreeScout 관리자만 변경할 수 있습니다. 메일박스 선택은 서버 설정을 재정의하며, "기본 설정 사용"(기본값)은 이를 따릅니다. 두 설정 모두 기본적으로 꺼져 있습니다. 환경 값을 변경한 후 다음을 실행하세요 php artisan config:clear FreeScout 디렉터리에서 FreeScout이 캐시된 구성 대신 새 값을 선택하도록 합니다.
Stripe는 해당 사서함의 유일한 활성 전체 맥락 제공자여야 합니다. Shopify도 전체 커머스 맥락을 제공하는 경우 ReplyRabbit은 하나만 활성화된 상태가 될 때까지 초안에서 커머스 데이터를 제외합니다. Magento 및 WooCommerce 자격 조회는 충돌하지 않습니다. Stripe 사이드바는 지원 상담원이 계속 사용할 수 있습니다.
데이터 처리 및 제한
커넥터는 일치하는 고객 범위 레코드를 찾기 위해 HTTPS를 통해 대화 이메일을 Stripe로 전송합니다. 제한된 키는 암호화되어 저장됩니다. 전체 카드 번호, 원시 Stripe 페이로드, 청구 주소, 메타데이터, 결제 인텐트 시크릿 또는 영수증 URL을 캐시하지 않습니다.
Stripe 요청은 고정된 2026-02-25.clover API 버전. Customer 레코드가 일치하지 않으면 커넥터는 지난 90일 동안의 최근 청구 200건 이하를 검사하고 이메일을 로컬에서 정확히 일치시킵니다. 이 게스트 결제 폴백은 의도적으로 불완전합니다.
제한된 조회는 사이드바의 응답성을 유지하고 불필요한 데이터 액세스를 줄입니다. 합계 아래의 단일 메모는 커넥터가 로드한 결제만 포함하는 경우를 설명합니다. 전체 계정 감사의 경우 Stripe 대시보드를 사용하세요.
문제 해결
| 증상 | 확인할 것 |
|---|---|
| Stripe가 키를 거부함 | 필요한 읽기 권한으로 새 제한된 키를 생성하세요. 전체 시크릿 키를 사용하지 마세요. |
| 알려진 구매자에 대해 사이드바가 비어 있습니다 | FreeScout 대화 이메일이 구매자의 Stripe 이메일과 정확히 일치하는지 확인하세요. 게스트 결제는 제한된 90일, 200건 청구 대체 범위 내에서만 확인됩니다. |
| 환불 또는 분쟁이 누락됨 | 커넥터는 해당 고객의 최근 레코드 중 제한된 집합만 확인합니다. 전체 계정 기록은 Stripe 대시보드에서 확인하세요. |
| ReplyRabbit 초안에는 결제 컨텍스트가 포함되지 않습니다 | 두 커머스 컨텍스트 환경 플래그가 다음인지 확인하세요 true, Stripe 커넥터를 메일함에서 사용할 수 있으며 다른 커머스 제공업체가 활성화되어 있지 않습니다. |
| 일부 결제 세부 정보를 사용할 수 없음 | 독립형 구매의 경우 Stripe 커넥터 라이선스 키가 커넥터 설정에 저장되어 있고 의도한 FreeScout 도메인에 대해 활성 상태인지 확인하세요. 번들 액세스의 경우 동일한 FreeScout 사이트에 활성 ReplyRabbit Pro 또는 Team 라이선스가 설치되어 있는지 확인하세요. |
다음 단계
- 읽기 ReplyRabbit 설정 방법 메일박스에 여전히 AI 제공자 또는 초안 설정이 필요한 경우.
- 보기 Shopify 커넥터, WooCommerce 커넥터, 또는 Magento 커넥터 다른 커머스 플랫폼용 가이드.
FAQ
Stripe Connector가 Stripe에 쓰나요?
아니요. 커넥터는 문서화된 읽기 권한만 있는 Stripe 제한 API 키를 사용합니다. 환불 생성, 구독 취소, 결제 재시도 또는 Stripe 데이터 변경을 하지 않습니다.
환불이나 분쟁이 표시되지 않는다면 Stripe에 존재하지 않는다는 뜻인가요?
아니요. 커넥터는 해당 고객의 최근 기록 중 제한된 세트를 확인합니다. 빈 패널은 해당 기록만 설명하며 전체 Stripe 계정 기록이 아닙니다.
Stripe 데이터를 ReplyRabbit 초안에 사용할 수 있나요?
예, ReplyRabbit과 Stripe Connector 커머스 컨텍스트를 모두 활성화하고 Stripe가 사서함의 유일한 활성 전체 컨텍스트 공급자인 경우입니다. Shopify도 전체 커머스 컨텍스트를 제공하는 경우 ReplyRabbit은 하나만 활성화된 상태로 남을 때까지 초안에서 커머스 데이터를 제외합니다. Magento 및 WooCommerce 자격 조회는 충돌하지 않습니다.
Stripe 커넥터 비용은 얼마인가요?
Stripe 커넥터는 활성 ReplyRabbit Pro 또는 Team 플랜에 포함됩니다. 그렇지 않은 경우 FreeScout 설치 하나에 대한 일회성 라이선스로 18 EUR입니다.
다른 이메일로 작성하는 고객을 일치시킬 수 있나요?
예. 대화를 열고 Stripe 패널에서 다른 이메일 연결을 선택한 다음 스레드에서 주소를 고르거나 직접 입력하세요. 연결은 메일함에 대해 기억되므로 연결된 주소에서 오는 향후 대화는 동일한 Stripe 고객을 표시합니다. 그러면 패널에 수동 연결됨이 표시되며, 거기서 연결을 해제할 수 있습니다.