Hướng dẫn tích hợp Pipedrive
1. Thao tác trên Pipedrive
- Đăng nhập vào Pipedrive
- Chọn phần Người Dùng -> chọn tab Settings -> chọn tab Personal Preferences -> chọn tab API và copy phần token đó.
2. Thao tác trên portal
Sau khi có được thông tin API Token, tiến hành truy cập portal để tích hợp
- Vào link https://portal.gcalls.co/integration
- Search tìm nền tảng Pipedrive => chọn icon mắt
- Bấm vào Add Integrator và nhập các thông tin vào các trường ở popup lên như sau
- ID Call Center: nhập ID của tổng đài đang tích hợp
- Host: nhập tên miền của pipedrive đang tích hợp
- Description: nhập tên tổng đài đang tích hợp
- Info: copy chính xác đoạn script sau dán vào
{"renderTooltip":[{"path":"/leads","element":"div[role='row']>div>div,div.caller-field>div>span>a"},{"path":"/deal","element":"div.caller-field>div>span>a"},{"path":"/person","element":"div.caller-field>div>span>a"},{"path":"/activities","element":"div.caller-field>div>span>a"}],"dataFunction":[{"objectName":"ContactPipeDrive","templateName":"pipedrive","endpointName":"search_contact_pipedrive","arrayResponse":"","responseData":[{"id":"data?.items[0].item?.id"},{"emails":"data?.items?.at(0)?.item?.emails"},{"name":"data?.items?.at(0)?.item?.name"},{"phones":"data?.items?.at(0)?.item?.phones"},{"primary_email":"data?.items?.at(0)?.item?.primary_email"}],"data":{"term":"{phone}","limit":1},"replaceData":[{"{phone}":"iframeDatas?.phone"}]},{"objectName":"DetailContactPipeDrive","templateName":"pipedrive","endpointName":"detail_contact_pipedrive","arrayResponse":"","responseData":[{"id":"data.id"},{"name":"data?.name"},{"company_id":"data?.company_id"},{"owner_id":"data?.owner_id"},{"owner_name":"data?.owner_name"},{"add_time":"data?.add_time"}],"data":{"id":"{id}"},"replaceData":[{"{id}":"checkValue('eval','ie','iframeDatas?.ContactPipeDrive[0]?.id','iframeDatas?.ContactPipeDrive[0]?.id','getText(0)')"}]},{"objectName":"LeadPipeDrive","templateName":"pipedrive","endpointName":"search_lead_pipedrive","arrayResponse":"","responseData":[{"id":"data[0].id"},{"add_time":"data?.at(0)?.add_time"},{"title":"data?.at(0)?.title"},{"owner_id":"data?.at(0)?.owner_id"}],"data":{"person_id":"{person_id}","limit":1,"sort":"add_time DESC"},"replaceData":[{"{person_id}":"checkValue('eval','ie','iframeDatas?.ContactPipeDrive[0]?.id','iframeDatas?.ContactPipeDrive[0]?.id','getText(0)')"}]},{"objectName":"LeadUserPipeDrive","templateName":"pipedrive","endpointName":"get_user_pipedrive","arrayResponse":"","responseData":[{"id":"data.id"},{"name":"data?.name"},{"email":"data?.email"},{"phone":"data?.phone"}],"data":{"id":"{id}"},"replaceData":[{"{id}":"iframeDatas?.LeadPipeDrive[0]?.owner_id"}]},{"objectName":"DealPipeDrive","templateName":"pipedrive","endpointName":"get_deals_pipedrive","arrayResponse":"","responseData":[{"id":"data[0].id"},{"title":"data?.at(0)?.title"},{"owner_name":"data?.at(0)?.owner_name"},{"weighted_value":"data?.at(0)?.weighted_value"},{"formatted_weighted_value":"data?.at(0)?.formatted_weighted_value"},{"weighted_value_currency":"data?.at(0)?.weighted_value_currency"},{"add_time":"data?.at(0)?.add_time"}],"data":{"id":"{id}","limit":1,"sort":"add_time DESC"},"replaceData":[{"{id}":"checkValue('eval','ie','iframeDatas?.ContactPipeDrive[0]?.id','iframeDatas?.ContactPipeDrive[0]?.id','getText(0)')"}]},{"objectName":"NotePipeDrive","templateName":"pipedrive","endpointName":"get_notes_pipedrive","arrayResponse":"","responseData":[{"id":"data[0].id"},{"content":"data?.at(0)?.content"},{"user_id":"data?.at(0)?.user_id"},{"add_time":"data?.at(0)?.add_time"}],"data":{"person_id":"{id}","limit":1,"sort":"add_time DESC"},"replaceData":[{"{id}":"checkValue('eval','ie','iframeDatas?.ContactPipeDrive[0]?.id','iframeDatas?.ContactPipeDrive[0]?.id','getText(111111111)')"}]}],"logFunction":[{"templateName":"pipedrive","endpointName":"create_calllog_pipedrive","data":{"subject":"{Subject}","outcome":"{outcome}","duration":"{duration}","from_phone_number":"{from_phone_number}","to_phone_number":"{to_phone_number}","start_time":"{startTime}","end_time":"{endTime}","deal_id":"{deal_id}","note":" Record URL: {RecordUrl}connected||status==success)','getText(connected)','checkValue(,ie,direction==\"outgoing\",busy,no_answer)')"},{"{startTime}":"handleTimePipedrive2(start)"},{"{endTime}":"handleTimePipedrive2(end)"},{"{deal_id}":"iframeData?.DealPipeDrive[0]?.id"},{"{from_phone_number}":"checkValue('eval','ie','direction===outgoing','agentName','phone')"},{"{to_phone_number}":"checkValue('eval','ie','direction===outgoing','phone','agentName')"},{"{duration}":"duration"},{"{RecordUrl}":"record_url"}]}],"smsFunction":[{"templateName":"pipedrive","endpointName":"create_note_pipedrive","data":{"content":"{content}","person_id":"{person_id}"},"replaceData":[{"{content}":"contentHtml"},{"{person_id}":"objectData?.ContactPipeDrive[0]?.id"}]}]}
- Iframe: copy chính xác đoạn script sau dán vào
[{"col":"3","label":"Contact","objectName":"ContactPipeDrive","arrayData":"","fields":[{"Name":"name","quickOpenUrl":{"Url":":originCrm/person/:ContactId","replaceData":[{":ContactId":"data?.ContactPipeDrive?.at(0)?.at(0)?.id"},{":originCrm":"parrentHostname2"}]}},{"Phone":"data?.ContactPipeDrive?.at(0)?.at(0)?.phones?.at(0)","Eval":"true"},{"Owner":"data?.DetailContactPipeDrive?.at(0)?.at(0)?.owner_name","Eval":"true"},{"Email":"primary_email"}]},{"col":"3","label":"Lead","objectName":"LeadPipeDrive","arrayData":"","fields":[{"Name":"title","quickOpenUrl":{"Url":":originCrm/leads/inbox/:LeadId","replaceData":[{":LeadId":"data?.LeadPipeDrive?.at(0)?.at(0)?.id"},{":originCrm":"parrentHostname2"}]}},{"Owner":"data?.LeadUserPipeDrive?.at(0)?.at(0)?.name","Eval":"true"},{"Create At":"add_time"}]},{"col":"3","label":"Latest Deal","objectName":"DealPipeDrive","arrayData":"","fields":[{"Name":"title","quickOpenUrl":{"Url":":originCrm/deal/:DealId","replaceData":[{":DealId":"data?.DealPipeDrive?.at(0)?.at(0)?.id"},{":originCrm":"parrentHostname2"}]}},{"Value":"formatted_weighted_value"},{"Create At":"add_time"}]},{"col":"1","label":"Latest Note","objectName":"NotePipeDrive","arrayData":"","fields":[{"":"content","colWidth":"1","Wrap":"true"}]}]
- domain: nhập tên domain pipedrive của khách hàng
- api_token: dán API Token đã copy từ Pipedrive
Bấm OK để hoàn tất 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 nền tảng Pipedrive với Gcalls. Sau khi hoàn tất tích hợp, anh chị vào các bạn hãy thực hiện testing kỹ theo bảng test case đối với các trường hợp tích hợp. Hy vọng bài viết sẽ giúp ích được nhiều cho anh chị và các bạn. Nếu có ý kiến đóng góp hoặc thắc mắc gì, anh chị và các bạn vui lòng để lại ở phần bình luận