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

Bitrix24 là một nền tảng CRM hỗ trợ doanh nghiệp quản lý toàn diện và hiệu quả hoạt động kinh doanh. Luôn được đánh giá là top những nền tảng CRM tốt nhất thế giới. 

Hiện Gcalls đã có thể tích hợp với Bitrix24, góp phần mang đến một giải pháp all-in-one toàn diện hơn nữa cho các doanh nghiệp. 

Để có thể thực hiện việc tích hợp giữa Gcalls với Bitrix, CS thao tác theo các bước sau đây:

 1. Thao tác trên Bitrix24

• Đăng nhập Bitrix24 bằng tài khoản admin
• Chọn Developer resources -> Other

• Chọn Inbound Webhook

• Tại Assign permissions -> chọn CRM và User -> save -> gửi mình lại link webhook (link được tô đậm trong hình)

2. Thao tác trên Portal

• Đăng nhập Portal
• Chọn tab Integration
• Gõ chữ bitrix24 vào thanh search như hình 
• Bấm chọn icon mắt ở tích hợp bitrix

• Chọn Add Integrator và điền thông tin vào các trường ở popup bên dưới
• ID Callcenter: nhập ID tổng đài khách hàng cần tích hợp
• Host: điền domain bitrix của KH, lưu ý bỏ phần http, https (nếu có)

Ví dụ: domain KH là https://adigitrans.bitrix24.com/, ta điền adigitrans.bitrix24.com

• Description: điền tổng đài khách hàng
• Info: copy toàn bộ nội dung này

{"renderTooltip":[{"path":"/crm/","element":".crm-client-contacts-block-text"},{"path":"/crm/lead/detail","element":"[data-cid='PHONE']"},{"path":"/crm/","element":".crm-entity-widget-client-contact-item.crm-entity-widget-client-contact-phone"},{"path":"/crm/contact/detail","element":"[data-cid='PHONE']"},{"path":"/crm/company/detail","element":"[data-cid='PHONE']"}],"dataFunction":[{"objectName":"ContactsBitrix","templateName":"bitrixselfhost","endpointName":"search_contact_bitrix","arrayResponse":"","responseData":[{"id":"result[0].ID"},{"name":"result[0]?.NAME"},{"lastName":"result[0]?.LAST_NAME"},{"assignedId":"result[0]?.ASSIGNED_BY_ID"},{"companyId":"result[0]?.COMPANY_ID"},{"dateCreate":"result[0]?.DATE_CREATE"}],"data":{"filter":{"PHONE":"{phone}"}},"replaceData":[{"{phone}":"iframeDatas?.phone"}]},{"objectName":"ContactAssignedBitrix","templateName":"bitrixselfhost","endpointName":"get_user_by_id","arrayResponse":"","responseData":[{"id":"result[0].ID"},{"name":"result[0]?.NAME"},{"lastName":"result[0]?.LAST_NAME"}],"data":{"id":"{userId}"},"replaceData":[{"{userId}":"iframeDatas?.ContactsBitrix?.at(0)?.at(0)?.assignedId"}]},{"objectName":"ContactCommentBitrix","templateName":"bitrixselfhost","endpointName":"search_comment_bitrix","arrayResponse":"","responseData":[{"comment":"result[0].COMMENT"},{"dateCreate":"result[0]?.CREATED"}],"data":{"filter":{"ENTITY_ID":"{contactId}","ENTITY_TYPE":"contact"},"order":{"CREATED":"DESC"}},"replaceData":[{"{contactId}":"iframeDatas?.ContactsBitrix?.at(0)?.at(0)?.id"}]},{"objectName":"DealsBitrix","templateName":"bitrixselfhost","endpointName":"get_list_deal","arrayResponse":"","responseData":[{"id":"result[0].ID"},{"dealName":"result[0]?.TITLE"},{"dealValue":"result[0]?.OPPORTUNITY"},{"dealDateCreate":"result[0]?.DATE_CREATE"}],"data":{"filter":{"CONTACT_ID":"{contactId}"}},"replaceData":[{"{contactId}":"iframeDatas?.ContactsBitrix?.at(0)?.at(0)?.id || '18416'"}]},{"objectName":"ContactCompanyBitrix","templateName":"bitrixselfhost","endpointName":"get_company_by_id","arrayResponse":"","responseData":[{"company":"result.TITLE"}],"data":{"id":"{companyId}"},"replaceData":[{"{companyId}":"iframeDatas?.ContactsBitrix?.at(0)?.at(0)?.companyId"}]},{"objectName":"LeadsBitrix","templateName":"bitrixselfhost","endpointName":"search_lead_bitrix","arrayResponse":"","responseData":[{"id":"result[0].ID"},{"lead":"result[0]?.TITLE"},{"companyLead":"result[0]?.COMPANY_TITLE"},{"companyId":"result[0]?.COMPANY_ID"},{"assignedId":"result[0]?.ASSIGNED_BY_ID"}],"data":{"filter":{"PHONE":"{phone}"}},"replaceData":[{"{phone}":"iframeDatas?.phone"}]},{"objectName":"LeadCompanyBitrix","templateName":"bitrixselfhost","endpointName":"get_company_by_id","arrayResponse":"","responseData":[{"company":"result.TITLE"}],"data":{"id":"{companyId}"},"replaceData":[{"{companyId}":"iframeDatas?.LeadsBitrix?.at(0)?.at(0)?.companyId"}]},{"objectName":"LeadAssignedBitrix","templateName":"bitrixselfhost","endpointName":"get_user_by_id","arrayResponse":"","responseData":[{"name":"result[0].NAME"},{"lastName":"result[0]?.LAST_NAME"}],"data":{"id":"{assignedId}"},"replaceData":[{"{assignedId}":"iframeDatas?.LeadsBitrix?.at(0)?.at(0)?.assignedId"}]}],"handleCreate":[{"templateName":"bitrixselfhost","endpointName":"create_contact_bitrix","data":{"fields":{"NAME":":name","TYPE_ID":"CLIENT","PHONE":[{"VALUE":":phone","VALUE_TYPE":"WORK"}]}},"replaceData":[{":name":"objectValue?.userName"},{":phone":"iframeData?.phone"}],"inputElm":[{"id":"userName","type":"input","placeholder":"Name"}],"quickOpenUrl":{"Url":"https://:hostName/crm/contact/details/:contactId/","replaceData":[{":contactId":"res?.data?.result"},{":hostName":"parrentHostname"}]}}],"logFunction":[{"templateName":"bitrixselfhost","endpointName":"create_calllog","data":{"fields":{"OWNER_TYPE_ID":":typeObjectEnum","OWNER_ID":":ownerId","TYPE_ID":2,"SUBJECT":":contentData","START_TIME":":calllogStartTime","END_TIME":":calllogEndTime","COMPLETED":"N","PRIORITY":3,"RESPONSIBLE_ID":1,"DESCRIPTION":"Link record: :RecordUrl","DESCRIPTION_TYPE":3,"DIRECTION":":directionEnum","COMMUNICATIONS":[{"VALUE":":phone","ENTITY_ID":":ownerId","ENTITY_TYPE_ID":":typeObjectEnum"}]}},"replaceData":[{":phone":"iframeData?.phone"},{":ownerId":"checkValue('eval','ie','iframeData?.ContactsBitrix?.at(0)?.at(0)?.id','iframeData?.ContactsBitrix?.at(0)?.at(0)?.id','iframeData?.LeadsBitrix?.at(0)?.at(0)?.id')"},{":typeObjectEnum":"checkValue('','ie','iframeData?.ContactsBitrix?.at(0)?.at(0)?.id',3,1)"},{":contentData":"TextContent"},{":calllogStartTime":"handleTimeBitrix2(calllog_info?.start, false)"},{":calllogEndTime":"handleTimeBitrix2(calllog_info?.end, false)"},{":RecordUrl":"record_url"},{":directionEnum":"directionEnum"}]}]}

Iframe

[{"col":"3","label":"Contact","objectName":"ContactsBitrix","arrayData":"","fields":[{"Name":"data?.ContactsBitrix?.at(0)?.at(0)?.name + ' ' + data?.ContactsBitrix?.at(0)?.at(0)?.lastName","Eval":"true","quickOpenUrl":{"Url":":originCrm/crm/contact/details/:contactId/","replaceData":[{":contactId":"data?.ContactsBitrix?.at(0)?.at(0)?.id"},{":originCrm":"parrentHostname2"}]}},{"Company":"data?.ContactCompanyBitrix?.at(0)?.at(0)?.company","Eval":"true"},{"Assignee":"data?.ContactAssignedBitrix?.at(0)?.at(0)?.name + ' ' + data?.ContactAssignedBitrix?.at(0)?.at(0)?.lastName","Eval":"true"}]},{"col":"3","label":"Lead","objectName":"LeadsBitrix","arrayData":"","fields":[{"Name":"lead","quickOpenUrl":{"Url":":originCrm/crm/lead/details/:leadId/","replaceData":[{":leadId":"data?.LeadsBitrix?.at(0)?.at(0)?.id"},{":originCrm":"parrentHostname2"}]}},{"Company":"companyLead"},{"Assignee":"data?.LeadAssignedBitrix?.at(0)?.at(0)?.name + ' ' + data?.LeadAssignedBitrix?.at(0)?.at(0)?.lastName","Eval":"true"}]},{"col":"3","label":"Deal","objectName":"DealsBitrix","arrayData":"","fields":[{"Name":"dealName","quickOpenUrl":{"Url":":originCrm/crm/deal/details/:dealId/","replaceData":[{":dealId":"data?.DealsBitrix?.at(0)?.at(0)?.id"},{":originCrm":"parrentHostname2"}]}},{"Value":"dealValue"},{"Date":"handleTimeCreate(data?.DealsBitrix?.at(0)?.at(0)?.dealDateCreate,true)","Eval":"true"}]},{"col":"2","label":"Comment","objectName":"ContactCommentBitrix","arrayData":"","fields":[{"Comment":"comment"},{"Created Date":"handleTimeCreate(data?.ContactCommentBitrix?.at(0)?.at(0)?.dateCreate,true)","Eval":"true"}]}]

• Domain: domain bitrix của KH, lưu ý bỏ phần http, https (nếu có)

Ví dụ: domain KH là https://adigitrans.bitrix24.com/, ta điền adigitrans.bitrix24.com

• idUserBitrix: lấy từ thông tin webhook đã copy ở phàn thao tác trên Bitrix

Ví dụ: https://test1.bitrix24.vn/rest/99/abcxxxyyyzzz, idUserBitrix là 99

• token: lấy từ thông tin webhook đã copy ở phàn thao tác trên Bitrix

Ví dụ: https://test1.bitrix24.vn/rest/99/abcxxxyyyzzz, token là abcxxxyyyzzz

• Sau đó bấm OK 

\ Sau khi hoàn tất tích hợp, CS thực hiện thông báo đến tech whitelist domain bitrix của khách vừa tích hợp và thực hiện testing theo các testcase được liệt kê trong bảng ở link này.

3. Kết luận 

Trên đây là bài viết hướng dẫn tích hợp Gcalls với CRM Bitrix. Hy vọng bài viết sẽ giúp ích được cho các bạn trong việc setup hệ thống và triển khai dịch vụ cho khách hàng. Nếu có bất kỳ thắc mắc gì, xin vui lòng để lại bình luận ở bên dưới bài viết.

Chúc các bạn thành công!