Skip to main content
Hậu Ngô
💬
0 discussions

Hướng dẫn tích hợp Zendesk

Zendesk là phần mềm có chức năng hỗ trợ khách hàng và được sử dụng rộng rãi trên toàn thế giới. Zendesk sở hữu nhiều tính năng vượt trội trong việc quản lý mail và ticket, giúp doanh nghiệp nâng cao hiệu suất đối ứng với những yêu cầu của khách hàng. Bên cạnh đó, Zendesk còn được phát triển với tính năng hỗ trợ chat, là cầu nối giữa doanh nghiệp và khách hàng một cách toàn diện nhất. 

Hiện tại Gcalls cũng đã tích hợp thành công với Zendesk, góp phần đưa đến một bộ giải pháp hỗ trợ toàn diện hơn khi kết hợp cả tổng đài CSKH.

1. Thao tác trên Zendesk​

  • Chọn Setting icon => Chọn Go to Admin Center

  • Chọn API and integrations => vào mục  APIs và thực hiện lấy API Token

Cách thao tác

Điền vào ô trống với nội dung <email_zendesk>:/token:<api_token>.

Với <email_zendesk> là email đăng nhập vô zendesk của khách hàng, còn <api_token> là api mà ta đã tạo ở trên sau đó bấm ENCODE

Ta lấy được Token sau khi bấm ENCODE

2. Thao tác trên Portal​

  • Chọn Add Integrator và nhập vào các thông tin tích hợp tương ứng

ID Call center: nhập ID của call center cần tích hợp

Host: tên miền zendesk cần tích hợp 

Description: Điền tên tổng đài tích hợp với zendesk

Info: Điền đoạn script sau

{"renderTooltip":[{"path":"/requested_tickets","element":"[class='value'] >[class='ember-view'] > [class='ember-view item'] > div"},{"path":"/requested_tickets","element":"[class='phone-text']"},{"path":"/tickets","element":"[class='sc-1edwvhc-0 iZXFIp']"},{"path":"/tickets","element":"[class='customercontext-userinfo-phonenumber-0']"}],"dataFunction":[{"objectName":"contact","templateName":"zendesk","endpointName":"search_contact_zendesk","arrayResponse":"users","responseData":[{"id":"id"},{"name":"name"},{"phone":"phone"}],"data":{"query":":phone"},"replaceData":[{":phone":"iframeDatas?.phone"}]},{"objectName":"organization","templateName":"zendesk","endpointName":"get_organization_zendesk","arrayResponse":"","responseData":[{"organization_name":"organizations[0]?.name"},{"id":"organizations[0]?.id"}],"data":{"id":":id"},"replaceData":[{":id":"iframeDatas?.contact[0][0]?.id"}]},{"objectName":"user","templateName":"zendesk","endpointName":"get_detail_zendesk","arrayResponse":"","responseData":[{"id":"user.id"},{"name":"user.name"},{"phone":"user.phone"},{"notes":"user.notes"},{"role":"user.role"}],"data":{"id":":id"},"replaceData":[{":id":"iframeDatas?.contact[0][0]?.id"}]},{"objectName":"tickets","templateName":"zendesk","endpointName":"get_latest_ticket_zendesk","arrayResponse":"tickets","responseData":[{"id":"id"},{"subject":"subject"},{"created_at":"created_at"},{"status":"status"}],"data":{"id":":id"},"replaceData":[{":id":"iframeDatas?.contact[0][0]?.id"}]},{"objectName":"tickets_organization","templateName":"zendesk","endpointName":"get_tickets_org_zendesk","arrayResponse":"tickets","responseData":[{"id":"id"},{"subject":"subject"},{"created_at":"created_at"},{"status":"status"}],"data":{"id":":id"},"replaceData":[{":id":"iframeDatas?.organization[0][0]?.id"}]}],"logFunction":[{"templateName":"zendesk","endpointName":"update_ticket_zendesk","data":{"ticket":{"comment":{"body":"contentData","public":true},"custom_fields":[{"id":8441228836249,"value":"calllogStartTime"},{"id":8441234894873,"value":"calllogEndTime"},{"id":8441236503833,"value":"calllogDuration"}]},"id":"idTicket"},"replaceData":[{"contentData":"TextContent"},{"idTicket":"iframeData?.ticket?.id"},{"calllogStartTime":"handleTimeCreate2(calllog_info?.start, false)"},{"calllogEndTime":"handleTimeCreate2(calllog_info?.end, false)"},{"calllogDuration":"callDuration"}]}],"preLogFunction":[{"templateName":"zendesk","endpointName":"create_ticket_zendesk","data":{"ticket":{"subject":"subjectData","comment":{"body":"contentData"},"requester_id":"requesterIdData","brand_id":5291908092441,"tags":["gcalls",":direction","answered"]}},"replaceData":[{"subjectData":"subjectTitle"},{"contentData":"TextContent"},{"requesterIdData":"iframeData?.contact[0][0]?.id"},{":direction":"directionCustom"}],"responseData":[{"ticket.id":"result?.data?.ticket?.id"}],"quickOpenUrl":{"Url":"[https://:hostName/agent/tickets/:ticketId","replaceData":[{":ticketId":"result?.data?.ticket?.id"},{":hostName":"parrentHostname"}]}}],"handleTicket":[{"label":"Ticket","templateName":"zendesk","endpointName":"create_ticket_zendesk","data":{"ticket":{"subject":"subjectData","comment":{"body":"contentData"},"requester_id":"requesterIdData","brand_id":5291908092441,"tags":["gcalls"]}},"replaceData":[{"subjectData":"objectValue?.subjectTicket"},{"contentData":"objectValue?.contentTicket"},{"requesterIdData":"iframeData?.contact[0][0]?.id"}],"inputElm":[{"id":"subjectTicket","type":"input","placeholder":"Subject"},{"id":"contentTicket","type":"textarea","placeholder":"Content"}],"quickOpenUrl":{"Url":"https://:hostName/agent/tickets/:ticketId","replaceData":[{":ticketId":"res?.data?.ticket?.id"},{":hostName":"parrentHostname"}]}}],"handleCreate":[{"templateName":"zendesk","endpointName":"create_contact_zendesk","data":{"user":{"name":":name","phone":":phone","role":"end-user"}},"replaceData":[{":name":"objectValue?.userName"},{":phone":"iframeData?.phone"}],"inputElm":{"id":"userName","type":"input","placeholder":"Name"}]}]}

Iframe:

[{"col":"3","label":"Contact","objectName":"contact","arrayData":"","fields":[{"Name":"name"},{"Phone":"phone"}],"quickOpenUrl":{"Url":"https://contreesdemo1655434725.zendesk.com/agent/users/:userId/","replaceData":[{":userId":"data?.contact[0][0]?.id"}]}},{"col":"3","label":"Organization","objectName":"organization","arrayData":"","fields":[{"Organization":"organization_name"}]},{"col":"3","label":"Detail","objectName":"user","arrayData":"","fields":[{"Phone":"phone"},{"Notes":"notes"},{"Role":"role"}]},{"col":"4","label":"Tickets","objectName":"tickets","arrayData":"tickets","fields":[{"ID":"id","quickOpenUrl":{"Url":"https://contreesdemo1655434725.zendesk.com/agent/tickets/:ticketId","replaceData":[{":ticketId":"value"}]}},{"Subject":"subject"},{"Date":"created_at"},{"Status":"status"}]},{"col":"4","label":"Organization Tickets","objectName":"tickets_organization","arrayData":"tickets_organization","fields":{"ID":"id","quickOpenUrl":{"Url":"[https://contreesdemo1655434725.zendesk.com/agent/tickets/:ticketId","replaceData":[{":ticketId":"value"}]}},{"Subject":"subject"},{"Date":"created_at"},{"Status":"status"}]}]

Note: những phần in đậm ở iframe sẽ được thay thế bằng sub domain của zendesk tương ứng đang tích hợp

Authorization: Điền đoạn Token đã access được ở phía trên theo cú pháp: Basic Token

Domain: Điền subdomain của zendesk đang tích hợp

Bấm OK để hoàn tất việc tích hợp.

3. Kết luận​

Trên đây là bài viết hướng dẫn tích hợp Zendesk. Sau khi đã hoàn tất việc tích hợp, CS tiến hành testing kết quả tích hợp bằng cách thực hiện các usecase testing được liệt kê tại đây.

Nếu có chỗ nào chưa work đúng, cần nhanh chóng kiểm tra lại để đảm bảo việc tích hợp hoạt động đúng và đáp ứng yêu cầu khách hàng.

Nếu có bất kỳ thắc mắc hoặc ý kiến đóng góp gì, anh chị và các bạn vui lòng để lại ý kiến ở phần bình luận nhé. Hi vọng bài viết sẽ giúp ích nhiều cho anh chị và các bạn.