Hướng dẫn tích hợp Freshdesk
Freshdesk là một giải pháp hỗ trợ khách hàng, quản lý ticket dạng đám mây giúp các công ty cung cấp dịch vụ và chăm sóc khách hàng của mình một cách tiện lợi và chuyên nghiệp hơn. Hiện tại Gcalls đã tích hợp thành công nền tảng này giúp cho việc sử dụng kết hợp giữa Helpdesk và Tổng đài CSKH được hiệu quả và năng suất hơn. Khi có KH sử dụng dịch vụ tổng đài của Gcalls và có nhu cầu tích hợp Freshdesk. CS thực hiện các thao tác như sau để tích hợp.
I. Thao tác trên Freshdesk
1. Tạo API Key
- Đăng nhập vào Freshdesk
- Bấm vào Avatar => chọn Profile Settings
- Copy API key tại đây
Note: Bước này nếu có thông tin account đăng nhập thì CS tự thực hiện, hoặc phía KH có thể lấy cho Sale chuyển giao lại cho CS và tiến hành tiếp các bước tiếp theo.
2. Chuyển đổi API Key
- Đăng nhập link https://www.base64encode.org/
- Tiến hành dán API vừa lấy được phía trên và chuyển đổi
II. Thao tác ở portal
- Tiến hành truy cập portal vào mục Integration theo đường link: https://portal.gcalls.co/integration
Điền các thông tin tích hợp như sau:
ID callcenter: điền ID call center cần tích hợp vào
Host: điền tên miền freshdesk của KH vào
Description: điền tên KH hoặc tên tổng đài KH vào
Info: dán đoạn script này vào
{"renderTooltip":[{"path":"/search/customers","element":"div[data-test-id='search-customer-item'] > span.customer-item__data"},{"path":"/contacts/filters","element":"a[data-test-id='trigger-telephone']"},{"path":"/tickets","element":"a[data-test-id='default-phone'];a[data-test-id='default-mobile']"},{"path":"/contacts","element":"div[data-test-id='fields-info-phone'] > div > div.contacts__fields--content > div.text__content;div[data-test-id='fields-info-mobile'] > div > div.contacts__fields--content > div.text__content"}],"dataFunction":[{"objectName":"ContactsFreshdesk","templateName":"freshdesk","endpointName":"get_contacts_freshdesk","arrayResponse":"","responseData":[{"id":"[0].id"},{"mobile":"[0]?.mobile"},{"phone":"[0]?.phone"},{"name":"[0]?.name"},{"email":"[0]?.email"},{"company":"[0]?.company?.name"},{"description":"[0]?.description"},{"created_at":"[0]?.created_at"},{"company_id":"[0]?.company_id"}],"data":{"include":"company","phone":"{phone}"},"replaceData":[{"{phone}":"iframeDatas?.phone"}]},{"objectName":"ContactsFreshdesk","templateName":"freshdesk","endpointName":"get_contacts_freshdesk","arrayResponse":"","responseData":[{"id":"[0].id"},{"mobile":"[0]?.mobile"},{"phone":"[0]?.phone"},{"name":"[0]?.name"},{"email":"[0]?.email"},{"company":"[0]?.company?.name"},{"description":"[0]?.description"},{"created_at":"[0]?.created_at"},{"company_id":"[0]?.company_id"}],"data":{"include":"company","mobile":"{phone}"},"replaceData":[{"{phone}":"iframeDatas?.phone"}]},{"objectName":"Agent","templateName":"freshdesk","endpointName":"get_current_agent_freshdesk","arrayResponse":"","responseData":[{"id":"[0].id"}],"data":{"email":":email"},"replaceData":[{":email":"JSON.parse(localStorage.getItem('gcalls-user'))?.email"}],"unCheckEmpty":"true"},{"objectName":"TicketFreshdesk","templateName":"freshdesk","endpointName":"get_tickets_freshdesk","arrayResponse":"none","responseData":[{"id":"id"},{"status":"status"},{"created_at":"created_at"},{"subject":"subject"}],"data":{"requester_id":"{id}","include":"description"},"replaceData":[{"{id}":"iframeDatas?.ContactsFreshdesk?.at(0)?.at(0)?.id || null"}]},{"objectName":"CompanyTicketFreshdesk","templateName":"freshdesk","endpointName":"get_tickets_freshdesk","arrayResponse":"none","responseData":[{"id":"id"},{"status":"status"},{"created_at":"created_at"},{"subject":"subject"}],"data":{"company_id":"{id}","include":"description"},"replaceData":[{"{id}":"iframeDatas?.ContactsFreshdesk?.at(0)?.at(0)?.company_id || null"}]}],"handleTicket":[{"label":"Ticket","templateName":"freshdesk","endpointName":"create_ticket_freshdesk","data":{"requester_id":11111,"source":3,"name":":name","phone":":phone","subject":"subjectData","description":"contentData","status":2,"priority":1,"responder_id":22222},"replaceData":[{"subjectData":"objectValue?.freshdeskSubjectTicket"},{"contentData":"objectValue?.freshdeskContentTicket"},{":phone":"iframeData?.phone"},{":name":"iframeData?.ContactsFreshdesk[0][0]?.name"},{"11111":"parseInt(iframeData?.ContactsFreshdesk[0][0]?.id)"},{"22222":"parseInt(iframeData?.Agent[0][0]?.id)"}],"inputElm":[{"id":"freshdeskSubjectTicket","type":"input","placeholder":"Subject"},{"id":"freshdeskContentTicket","type":"textarea","placeholder":"Content"}],"quickOpenUrl":{"Url":"https://saladin.freshdesk.com/a/tickets/:ticketId","replaceData":[{":ticketId":"res?.data?.id"}]}}],"preLogFunction":[{"templateName":"freshdesk","endpointName":"create_ticket_freshdesk","data":{"requester_id":11111,"source":3,"name":":name","phone":":phone","subject":"subjectData","description":"contentData","status":2,"priority":1,"tags":["gcalls",":direction","answered"],"responder_id":22222},"replaceData":[{"subjectData":"subjectTitle2"},{"contentData":"TextContent"},{":phone":"iframeData?.phone"},{":name":"iframeData?.ContactsFreshdesk?.at(0)?.at(0)?.name"},{"11111":"parseInt(iframeData?.ContactsFreshdesk?.at(0)?.at(0)?.id) || 1"},{":direction":"directionCustom"},{"22222":"parseInt(iframeData?.Agent[0][0]?.id)"}],"responseData":[{"ticketFreshdeskId.id":"result?.data?.id"}],"quickOpenUrl":{"Url":"https://saladin.freshdesk.com/a/tickets/:ticketId","replaceData":[{":ticketId":"result?.data?.id"}]}}],"logFunction":[{"templateName":"freshdesk","endpointName":"update_ticket_freshdesk","data":{"description":"contentData","id":"idTicket"},"replaceData":[{"contentData":"TextContent"},{"idTicket":"iframeData?.ticketFreshdeskId?.id"}]}],"handleCreate":[{"templateName":"freshdesk","endpointName":"create_contact_freshdesk","data":{"name":":name","phone":":phone"},"replaceData":[{":name":"objectValue?.freshdeskUsername"},{":phone":"iframeData?.phone"}],"inputElm":[{"id":"freshdeskUsername","type":"input","placeholder":"Name"}],"quickOpenUrl":{"Url":"https://saladin.freshdesk.com/a/contacts/:contactId","replaceData":[{":contactId":"res?.data?.id"}]}}]}
Iframe: dán đoạn script này vào
[{"col":"3","label":"Contact Info","objectName":"ContactsFreshdesk","arrayData":"","fields":[{"Name":"name"},{"Company":"company"},{"Work Phone":"phone"},{"Mobile":"mobile"},{"Email":"email"},{"Created at":"handleTimeCreate(data?.ContactsFreshdesk?.at(0)?.at(0)?.created_at)","Eval":"true"},{"About":"description"},{"Tags":"data?.ContactTagsFreshdesk?.at(0)?.at(0)?.tags?.join(', ')","Eval":"true"}],"quickOpenUrl":{"Url":"https://saladin.freshdesk.com/a/contacts/:ContactId","replaceData":[{":ContactId":"data?.ContactsFreshdesk?.at(0)?.at(0)?.id"}]}},{"col":"3","label":"Tickets","objectName":"TicketFreshdesk","arrayData":"TicketFreshdesk","fields":[{"Subject":"subject","quickOpenUrl":{"Url":"https://saladin.freshdesk.com/a/tickets/:TicketId","replaceData":[{":TicketId":"data?.TicketFreshdesk?.at(j)?.at(0)?.id"}]}},{"Created Date":"handleTimeCreate(data?.TicketFreshdesk?.at(j)?.at(0)?.created_at,true)","Eval":"true"},{"Status":"FRESHDESK_STATUS_TICKET[data?.TicketFreshdesk?.at(j)?.at(0)?.status]","Eval":"true"}]},{"col":"3","label":"Company Tickets","objectName":"CompanyTicketFreshdesk","arrayData":"CompanyTicketFreshdesk","fields":[{"Subject":"subject","quickOpenUrl":{"Url":"https://saladin.freshdesk.com/a/tickets/:TicketId","replaceData":[{":TicketId":"data?.CompanyTicketFreshdesk?.at(j)?.at(0)?.id"}]}},{"Created Date":"handleTimeCreate(data?.CompanyTicketFreshdesk?.at(j)?.at(0)?.created_at,true)","Eval":"true"},{"Status":"FRESHDESK_STATUS_TICKET[data?.CompanyTicketFreshdesk?.at(j)?.at(0)?.status]","Eval":"true"}]},{"col":"1","label":"Agent","objectName":"Agent","arrayData":"","fields":[{"AgentId":"id"}]}]
Lưu ý cho phần dán script ở Info và Iframe
- Những chỗ được tô đậm sẽ được thay thế bằng tên miền Freshdesk của KH
- Copy dán vào không để dư dấu cách (đặc biệt là ở 2 đầu đoạn script)
- domain: điền tên miền Freshdesk KH
- Authorization: điền Token vừa lấy được ở bước chuyển API Key
- Bấm OK
III. Kết luận
Như vậy chúng ta đã hoàn tất được việc tích hợp Gcalls với nền tảng Helpdesk Freshdesk. Sau đó CS cần test kỹ việc call và nhận call trên tích hợp Freshdesk xem đã đã ứng đầy đủ các testcase chưa rồi mới bàn giao lại cho Sale.
Lưu ý: Email user đăng nhập sử dụng Freshdesk cần phải trùng hợp với email đăng nhập vào Extension Gcalls.
Hi vọng bài viết sẽ giúp ích nhiều cho các bạn, nếu có bất kỳ ý kiến nào hoặc đóng góp gì, vui lòng để lại comment ở bên dưới.