연동 서비스 빌더는 확장된 기술적 또는 프로그래밍 스킬 없이도 AI 상담사 모든 API 또는 데이터 소스에 연결할 수 있는 강력한 노코드 도구입니다. 이 문서에서는 연동 빌더에 대한 자주 묻는 질문(FAQ)을 다룹니다.
이 문서에서는 다음과 같은 주제를 다룹니다.
관련 문서:
매개변수 및 데이터 자주 묻는 질문(FAQ)
대화의 세션 데이터는 어떻게 수집되나요?
AI 상담사 대화의 세션 데이터 수집은 세션이 시작될 때 사용자 메타데이터의 자동 캡처로 시작하여 입력, 응답 및 엔터티가 캡처될 수 있는 AI 상담사 와의 상호작용을 통해 계속됩니다.
채팅 세션이 시작될 때, 특히 사용자가 로그인한 경우에는 특정 메타데이터가 자동으로 수집됩니다. 이 메타데이터는 일반적으로 사용자 ID 또는 계정 정보, 세션 ID, 위치, 타임스탬프 등을 포함할 수 있는 사용자별 세부 정보를 포함합니다. 그런 다음 이 데이터를 대화 작업 으로 저장할 수 있습니다.
대화 중 사용자로부터 특정 응답(자유로운 텍스트로 작성되거나 버튼으로 제출됨)을 캡처하도록 선택할 수 있습니다. 다음과 같이 할 수 있습니다.
- 조건부 블록에서 “매개변수 수집” 설정을 사용하는 매개변수
- 엔터티
그런 다음 이러한 매개변수를 연동 서비스에 전달하여 URL 엔드포인트나 요청 본문에서 요청 매개변수 로 사용할 수 있습니다.
URL 매개변수란 무엇이고 어떻게 사용하나요?
URL 매개변수는 대화에서 오는 요청 매개변수의 연동 서비스에 전달된 정보에 따라 변경되는 URL의 동적 매개변수입니다.
다음은 매개변수로 사용된 사용자 ID의 예입니다.
https://{{zendesk_subdomain}}.zendesk.com/api/v2/users/{{user_id}}이중 중괄호 안에는 user_id 매개변수가 URL에 추가됩니다.
API에서 사용할 대화의 데이터에 액세스하려면 어떻게 해야 하나요?
대화의 데이터를 사용하려면 위에서 설명한 대로 매개변수를 수집하거나 세션 데이터의 매개변수에 메타데이터를 저장하여 데이터를 매개변수로 세션에 저장해야 합니다. 데이터가 대화에서 오는 경우에는 연동 빌더에서 요청 매개변수로, 또는 API로 전송될 세션 데이터/메타데이터로 저장되어야 합니다. 그런 다음 요청 본문에서 해당 매개변수를 동적으로 보낼 수도 있습니다.
대화에 사용할 API 응답의 매개변수나 데이터에 액세스하려면 어떻게 해야 하나요?
API 응답의 매개변수나 데이터를 사용하려면 환경 에 세션 매개변수로 저장해야 합니다(대부분의 경우 성공 시나리오). 저장하고 API가 특정 시나리오에 도달하면 세션 매개변수에 액세스하여 AI 상담사 메시지에서 사용하거나 조건부 블록 의 매개변수로 사용할 수 있습니다.
- AI 상담사 메시지에서 다음으로 액세스됩니다.{{parameterName}} .
- 조건부 블록에서는 매개변수 이름으로 액세스합니다.
본문에서 요청 매개변수를 보내려면 어떻게 해야 하나요?
본문에 요청 매개변수를 보내려면 다음과 같이 이중 중괄호 안에 포함해야 합니다.
{{exampleParameter}}요청 본문에 배열을 보낼 수 있나요?
예, 요청 매개변수를 정의할 때 데이터 유형을 배열로 선택할 수 있습니다. 테스트할 때 반드시 JSONata 함수 $eval($) 로 값의 형식을 다시 지정하세요. 평가 함수는 JSON 표현식이나 JSONata 표현식을 포함하는 문자열을 마치 JSON인 것처럼 구문 분석하고 평가합니다.
이 경우에는 배열에 포함된 문자열을 $eval()을 사용하여 배열로 구문 분석합니다. 가장 일반적인 사용 사례는 주문 배열을 보낼 때입니다.
테스트할 때 요청 매개변수나 잘못된 매개변수를 받지 못하는 이유는 무엇인가요?
테스트 목적으로 연동 빌더의 요청 매개변수에 엔드포인트의 실제 데이터와 일치하는 테스트 값을 사용해야 합니다. 하지만 라이브 대화에서 이 매개변수의 값은 대화에서 가져옵니다. 테스트할 때 세션 데이터에서 매개변수와 값을 볼 수 없다면 에서 캡처하여 대화 상자에서 올바른 매개변수로 저장하고 있는지 확인해야 합니다.
삭제된 세션 데이터는 대화 로그에 표시되지 않습니다. 이 경우에는 대신 디버그하기 위해 AI 상담사 메시지에 임시로 로그인해야 할 수도 있습니다.
[개체, 개체]가 표시되는 이유는 무엇인가요?
[개체, 개체]가 표시되면 개체를 출력하려고 하지만 시스템에 개체를 표시할 수 있는 구조화된 방법이 없음을 의미합니다. 이 문제를 해결하려면 개체를 문자열 형식으로 변환해야 합니다.
성공한 통화를 기록하나요?
아니요, PII 및 GDPR 이유로 성공적인 데이터 호출은 로깅하지 않습니다. 필요한 경우 문제 해결 중 무엇이 잘못되었는지에 대한 자세한 정보를 제공할 수 있도록 실패한 통화를 기록합니다.
환경 관련 자주 묻는 질문(FAQ)
다른 환경이 필요한 이유는 무엇인가요?
연동 서비스를 테스트할 때 실제 데이터나 라이브 데이터를 사용하고 싶지 않을 수 있습니다. 샌드박스, 스테이징 또는 개발 환경에 액세스할 수 있는 경우(기술팀이나 API 문서에서 찾아보는 것이 좋습니다) 연동 빌더 내에서 설정할 수 있습니다.
환경은 요청 매개변수와 출력을 공유합니다. 하지만 엔드포인트와 인증 세부 정보가 다릅니다. 대화 빌더에서 API 노드의 환경 간에 쉽게 전환할 수 있습니다. 즉, 테스트할 때 하나의 대화만 구축한 다음 연동 서비스를 사용할 준비가 되면 프로덕션 환경으로 전환할 수 있습니다.
카드 및 회전 슬라이드 FAQ
최대 카드 수를 설정해야 하나요?
Sunshine Conversations 연동 서비스의 경우 최대 10개의 카드가 있습니다.
회전 슬라이드의 카드 수를 9개의 카드 또는 1개의 대체 카드가 있는 8개의 카드로 제한하는 것이 좋습니다. 대체 카드는 사용자가 회전 슬라이드에서 빠져나갈 수 있는 방법을 제공합니다(예를 들어, 항목이 보이지 않는 경우).
회전 슬라이드의 카드에 이미지를 표시해야 하나요?
예, 이미지는 필수 데이터 필드입니다. 동적 이미지(예: 제품당 이미지)가 필요하지 않은 경우에는 이미지 필드를 일반 이미지 링크로 채울 수 있습니다.
인증 자주 묻는 질문(FAQ)
어떤 인증 방법을 사용할 수 있나요?
다음과 같은 인증 방법을 사용할 수 있습니다.
- API 키
- 무기명 토큰
- 만료 토큰
- 기본 인증
- OAuth 2.0
- IP 허용 목록
연동 서비스 빌더의 인증을 시작하려면 연동 서비스 기술 요구 사항을 참조하세요.
허용 목록에 있는 엔드포인트와 연동 서비스를 구축할 수 있나요?
예. 그렇게 하려면 IP 주소를 허용 목록에 추가해야 합니다. IP 주소 목록은 IP가 AI 상담사를 CRM 에 연결할 수 있도록 허용하기를 참조하세요.
인증 전용 연동 서비스란 무엇이고 언제 필요한가요?
인증 전용 연동 서비스에 대해 자세히 알아보려면 연동 빌더로 사용자 지정 권한 부여 사용하기를 참조하세요.
호출 빈도 제한 및 제한을 구현할 수 있나요?
호출 빈도 제한 및 제한을 직접 적용하지 않습니다. 호출 빈도 제한은 일반적으로 백엔드 시스템과 같이 Zendesk가 연동하는 시스템이나 API에 의해 시행됩니다. 이러한 한도는 백엔드의 구성에 따라 다릅니다.
API가 응답하는 데 9초 이상 걸리면 어떻게 되나요?
AI 상담사 워크스페이스 API 응답에 9초 제한 시간을 적용합니다. API가 이 시간 내에 응답을 제공하지 않으면 요청 시간이 초과되어 ECONNABORTED 오류를 리턴합니다. 또한 응답 시간이 길면 사용자가 정보를 기다리는 일이 불편할 수 있으므로 사용자 경험에 부정적인 영향을 미칠 수 있습니다.
이 문제를 해결하기 위해 특정 API 응답에 9초 이상 걸릴 것으로 예상되는 경우에는 가능하면 대화를 시작할 때(예: Chat 시작 이벤트 시) 필요한 API 호출을 하고 관련 정보를 에 저장하는 것이 좋습니다. 세션. 이로써 대화 플로우 중 지연을 피하면서 필요할 때 데이터를 준비할 수 있습니다.
번역 고지 사항: 본 문서는 콘텐츠에 대한 기본적인 이해를 제공하기 위해 자동 번역 소프트웨어를 사용하여 번역되었습니다. 정확한 번역을 제공하고자 합당한 노력을 기울였으나 Zendesk는 번역의 정확성을 보장하지 않습니다.
번역된 문서에 포함된 정보의 정확성과 관련하여 질문이 있으시면 문서의 공식 버전인 영문 버전을 참조하시기 바랍니다.