Suite | Professional, Enterprise 또는 Enterprise Plus |
대화 연동을 통해 기업은 모든 채널, 챗봇 또는 타사 앱의 메시지를 단일 대화로 통합하고 모든 곳에서 인터랙티브 경험을 구축할 수 있습니다.
- 웹훅.
- (선택 사항) 연동 범주에서 공개 API와 상호작용하기 위한 API 키 집합. API 키를 만드는 데 대한 자세한 내용은 대화 API 키 사용하기를 참조하세요.
참고: 대화 연동은 이전에 Sunshine Conversations 대시보드에서 웹훅으로 알려졌습니다.
관리 센터의 대화 연동 페이지를 통해 대화 연동을 만들 수 있습니다.
curl 또는 Postman을 사용하여 연동을 만들 수도 있습니다.
이 문서는 다음 섹션으로 구성되어 있습니다.
관리 센터에서 대화 만들기 및 구성하기
대화 연동 페이지에서 다음과 같은 작업을 할 수 있습니다.
새 대화 연동 만들기
-
관리 센터의 사이드바에서
앱 및 연동 서비스를 클릭한 다음 연동 서비스 > 대화 연동을 선택합니다. 대화 연동 페이지가 열립니다. 이전에 만든 모든 대화가 목록에 나타납니다.
관리 센터에서 연동 서비스를 만드는 것이 이번이 처음이라면 연동 서비스 만들기를 클릭하여 대화 연동 페이지를 봅니다.
- 연동 서비스 만들기를 클릭합니다. 연동 서비스 만들기 페이지가 열립니다.
- 연동 서비스를 식별하기 위한 고유한 이름을 입력합니다.
- 웹훅 섹션에서 다음 정보를 입력합니다.
-
웹훅 엔드포인트 URL: 대상 URL입니다. 트리거 이벤트가 일어날 때 웹훅이 이벤트를 보고 대상 URL에 데이터를 보냅니다. 대상 URL은
https://www.yourdomain.com/path
형식을 사용합니다. - 웹훅 본문 데이터: 확인란을 사용하여 웹훅 데이터에 사용자 스키마와 클라이언트 및 기기 정보를 포함할지 여부를 나타냅니다.
- 웹훅 구독: 알림을 받으려는 이벤트를 선택합니다.
-
웹훅 엔드포인트 URL: 대상 URL입니다. 트리거 이벤트가 일어날 때 웹훅이 이벤트를 보고 대상 URL에 데이터를 보냅니다. 대상 URL은
- 저장을 클릭합니다. 공유 비밀키 복사 창이 열립니다.
- (선택 사항) 웹훅 ID와 공유 비밀키를 복사합니다. 이는 개발자가 또 다른 인증 계층을 추가하는 데 사용하며 필수는 아닙니다.
- 다음을 클릭합니다. 연동의 구성 페이지가 열립니다. 필요하면 여기에서 API 키를 추가할 수 있습니다.
API 키 추가하기
API 키 탭에서 연동에 대한 인증을 구성할 수 있습니다. API 키는 애플리케이션이나 사용자를 식별하고 인증하며 다음의 세 부분으로 구성됩니다.
- 앱 ID는 Zendesk 계정을 식별합니다.
- 비밀 키와 함께 사용되는 키 ID는 JWT 및 API 호출을 인증하는 데 사용되는 자격 증명입니다.
- 비밀 키는 인증 비밀번호입니다.
API 키를 만들고 공유하려면 다음과 같이 하세요.
-
관리 센터의 사이드바에서
앱 및 연동 서비스를 클릭한 다음 연동 서비스 > 대화 연동을 선택합니다. 대화 연동 페이지가 열립니다.
- API 키 탭을 클릭합니다.
- API 키 만들기를 클릭합니다. 처음 키를 만드는 경우에는 이 버튼이 페이지 맨 아래에 나타나고, 이전에 키를 만든 경우에는 오른쪽 위에 나타납니다.
- 새 키 만들기 대화 상자에 키를 식별하는 이름을 입력한 후 다음을 클릭합니다.
- 공유 비밀키 복사 대화 상자에서 각 ID와 비밀키에 대해 복사를 클릭하여 클립보드에 저장한 후 다음을 클릭합니다. API 창에 돌아오면 목록에 새 키가 나타납니다.
새 키를 생성하지만 10개 키 제한에 도달한 경우에는 사용하지 않는 키를 삭제하라는 알림이 나타납니다.
사용하지 않는 키를 삭제하려면 다음과 같이 하세요.
- 관리 센터의 사이드바에서
앱 및 연동 서비스를 클릭한 다음 연동 서비스 > 대화 연동을 선택합니다.
- API 키 탭을 클릭합니다.
- 삭제하려는 키에 마우스 포인터를 갖다 댄 다음 옵션 메뉴(
)를 클릭하고 삭제를 선택합니다.
연동 보기, 편집하기 또는 삭제하기
기존 연동으로 작업하려면 다음과 같이 하세요.
-
관리 센터의 사이드바에서
앱 및 연동 서비스를 클릭한 다음 연동 서비스 > 대화 연동을 선택합니다. 대화 연동 페이지가 열립니다.
- 업데이트하려는 연동에 커서를 갖다 대고 옵션 아이콘(
)을 클릭한 다음 다음과 같은 옵션을 선택합니다.
- 자세히 보기: 앱, 연동 및 웹훅 ID는 물론 공유 비밀키, 웹훅 세부정보, API 키를 볼 수 있는 연동의 세부 정보 페이지가 표시됩니다.
- 편집: 연동의 이름 및 웹훅 세부 정보를 업데이트할 수 있는 연동 서비스 만들기 페이지가 열립니다.
- 삭제: 삭제 마법사를 시작합니다. 언제든 마법사를 취소하고 나갈 수 있습니다.
기타 연동 방법
다음 방법은 Zendesk Suite Professional 이상에 제공되는 라이선스가 아니라 별도의 Sunshine Conversations 라이선스가 있는 사용자만 사용할 수 있습니다.
curl을 사용하여 대화 연동을 만들려면 다음과 같이 하세요.
-
연동 서비스 만들기 API를 사용하여 연동을 만들고
type
을custom
으로 설정합니다. - API에서 지정된 대로 필수 매개변수를 제공합니다. 대상은 서버의 URL이며 트리거 목록은 어떤 이벤트를 수신할지 결정합니다.
Postman을 사용하여 대화 연동을 만들려면 다음과 같이 하세요.
-
연동 서비스 만들기 API를 사용하여 연동을 만들고
type
을custom
으로 설정합니다. - Postman 애플리케이션을 다운로드하여 설치합니다.
- Sunshine Conversations Postman 컬렉션을 다운로드하여 환경을 설정합니다.
- Postman에서 Smooch > Integrations > Create Integrations를 선택합니다.
- 연동 유형에 지정된 대로 필수 매개변수를 제공합니다.
Sunshine Conversations API에 대한 자세한 내용은 연동을 참조하세요.
메시지 보내기 및 받기에 대한 가이드도 참조하세요. REST API를 사용하여 웹훅을 구성하는 것도 좋습니다.
댓글 7개
Ayinde Arnett
1263082350349 Hi, I'm wondering if there is any way to leverage an existing marketplace integration within the conversations integration. Our org already has mixpanel integrated via marketplace and we pull in user profile information and activity into our human agent chats.
We recently rolled out an AI chatbot and would like to also pull in mixpanel data to use as prompts in our AI agent repsonses. I have not found any path forward on this, but hoping you may provide a solution?
Thanks,
0
raymond chrisandy
Is there any way to add authentication(bearer token, etc) on the webhook of this conversation Integration?
Thank you
0
Megan Covens
Hello Ahmed Zaid
Customers can now view their Sunshine Conversations logs in Admin Center within their Integration Logs. These can be found under Apps and Integrations -> Integrations -> Logs
Hope this helps!
0
Marry Jane Dulay
Error:
WHATSAPP_BUSINESS_API_INBOX_ONBOARDING
0
Marry Jane Dulay
Error: "GraphQL server responded with error 3441003: please retry in some time or reach support to get the issue fixed"
please help me to solve the WHATSAPP API Business Account creation error
0
Taylor Bowser
Hi Shameen Rana,
Thanks for your comment! After creation, the integration will be linked to the Sunshine Conversations app linked to your Zendesk subdomain. However, for new users this will only be accessible via the Conversations Integration page in the Admin Center.
Only legacy Sunshine Conversation users will have access to the Sunshine Conversations dashboard.
Hope this helps!
0
Shameen (Dev)
Hi Gary Beichler,
Where does that integration/app go after creation?
Like in sunshine dashboard we can see app and their linked integrations, does this app goes to some sunshine account that is linked to this support account?
Kindly guide me the purpose of this feature.
Thanks.
0
로그인하세요.