Published at: 2025-10-30
Integrating with Tianrun Rongtong
1. ShareCRM-side Call Center Initialization
Configuration path: Management → Business Plugin Management → Call Center
- After tenant initialization succeeds, the following changes occur:
① A new Role “Call Center Agent” is added under Management → Roles & Permissions → Business Feature Permissions → Role Permission Settings.
② A new lookup field “Call Record” is added to the Work Order object.
③ A preset CRM object “Call Record” is created.
2. Obtain Call Center Encryption Key Pair
- TienRun (Tianrun/TianrunRongtong) key retrieval path
System Settings → Security Settings → API Keys
picture coming soon:
Note: The key is shown only once when generated. Save it immediately — you will need it later when configuring in ShareCRM.
- Permission assignment
After generating the key pair, assign permissions by checking all permission options.
picture coming soon:
picture coming soon:
- TienRun Enterprise ID retrieval path: Home → Company Info tab → Enterprise ID
picture coming soon:
Note: Save all information above. You will need these values when configuring the enterprise in ShareCRM.
3. TienRun-side: Configure Event Subscriptions
Note: Call center functionality heavily depends on correctly configured event subscriptions. Follow these instructions precisely.
- Event configuration list: Message push event configuration path is System Settings → Call Center → System Integration → Data Push. Incoming call push, outbound call push, and agent status push are mandatory event types. There are nine required event types in total (see images). Note: Do NOT configure the outbound customer ringing event.
picture coming soon:
picture coming soon:
picture coming soon:
Notes:
- Push endpoints:
- Incoming call and outbound call push endpoint: https://www.fxiaoke.com/open/callcenter/tinet/pushData
- Agent status push endpoint: https://www.fxiaoke.com/open/callcenter/tinet/receiveSeatDetail
-
Recommended timeout: 10s
-
Recommended retry count: 3
-
Push method: POST; Content-Type: application/json
- Add all listed push parameters; include every parameter item shown in the list.
- In addition to the nine events above, if call transfer is involved, configure the “Transferred Call Record” (from-ticket) push event to receive transferred call records. Besides selecting all available fields, manually add the field “detailStatus” (call answer status).
picture coming soon: Caption: From-ticket push
Configuration:
-
Endpoint: https://www.fxiaoke.com/open/callcenter/tinet/pushTicketData
-
Push type: Ticket Push — From-ticket push. Timeout: 10s. Retry: 3. Method: POST. Content-Type: application/json
-
Select all fields, then manually add the field: detailStatus (call answer status). Click Save next to the field, then click the overall Save button.
- To ensure call recordings are stored correctly, configure the recording status push event.
picture coming soon:
-
Endpoint: https://www.fxiaoke.com/open/callcenter/tinet/pushRecordFile
-
Push type: Recording Status Push. Timeout: 10s. Retry: 3. Method: POST. Content-Type: application/json
Note: All endpoints above use the ShareCRM cloud domain. If you use Huawei Cloud, replace every occurrence of https://www.fxiaoke.com with https://hwcloud.fxiaoke.com. For other clouds, contact the product manager for the correct endpoints.
4. ShareCRM-side Configuration Guide
- Enable the ShareCRM call center plugin: Management → Business Plugin Management → Call Center
Caption: Call Center Plugin
Notes:
-
Service Provider: select Service Provider = TienRun RongTong Call Center.
-
AccessKeySecret: the private access key obtained from TienRun.
-
AccessKeyId: the access key ID obtained from TienRun.
-
account: the customer ID obtained from TienRun.
Notes:
① TienRun operates two platforms — Beijing (bj) and Shanghai (sh). The login URL typically contains “bj” for Beijing or “sh” for Shanghai. Confirm with TienRun before selecting the platform option.
② TienRun supports two integration modes; differences are as follows:
- Backend API Integration:
- Pros: The same account can log into both TienRun and ShareCRM simultaneously.
- Cons: Does not support softphone call capabilities.
- The phone control bar supports only the following button functions: Hold, Hang Up, Transfer to Agent, Mute, Consult (Whisper/Consult), and Satisfaction. No further button expansion is supported.
- Frontend SDK Integration:
- Pros: Supports softphone call capabilities.
- The phone control bar’s operation buttons can be extended (limited to vendor-provided phone-bar buttons).
- Cons: The same account cannot be simultaneously online in both TienRun and ShareCRM.
- Bind user accounts between ShareCRM employees and TienRun agents on the ShareCRM side.
picture coming soon: Caption: Account Binding
- Complete agent settings in ShareCRM. Refer to the image for configuration options.
picture coming soon:
5. Satisfaction (CSAT) Push Configuration
Satisfaction surveys can be executed either manually by the agent or automatically on hang-up by the agent. Only when the survey mode is set to “Agent Manual” will the satisfaction survey button be visible in ShareCRM.
Configuration path: Company Settings → Call Center → Feature Configuration
picture coming soon:
To receive satisfaction records in ShareCRM, also configure the satisfaction event push.
picture coming soon:
Push endpoint: https://www.fxiaoke.com/open/callcenter/tinet/pushSatisfactionData
6. One-Click Outbound Call
When agents need to initiate outbound calls directly from the CRM, configure outbound calling in ShareCRM to enable one-click outbound.
6.1 The system presets the following objects as outbound-call-enabled: Account, Leads, Contact. To enable outbound calling for these objects, perform the following two steps:
6.1.1 Add a custom button to each object. The button API name must be: button_e_call_out__c.
6.1.2 Configure outbound call fields under Outbound Call Settings (see image).
picture coming soon:
6.2 If you need outbound calling on other objects, perform the following:
6.2.1 Add the target object under Outbound Call Settings.
picture coming soon:
picture coming soon:

Note: Adding the outbound button consumes custom button quota. If quota is insufficient, initialization may fail. After increasing quota, manually add the custom button with API name: button_e_call_out__c
6.2.2 Configure outbound call fields under Outbound Call Settings as in step 6.1.2.