| Info |
|---|
CloudCX's integration with HubSpot allows you to easily access customer information in the CloudCX Agent Console easily and synchronize data conveniently from CloudCX to HubSpot. The integration delivers a consistent customer information management experience and improves your agent efficiency. |
| Table of Contents |
|---|
...
CloudCX supports two ways for Tenant administrators to connect to HubSpot:
Connect to HubSpot with system configuration via Connector Hub Setting > HubSpot in the system administrator portal. You can find more details about integrate with HubSpot CRM Application-HubSpot.
Connect to HubSpot with custom configuration via App & Integrations > Settings > custom configuration. You can find more details about Custom Configure HubSpot in CloudCX Tenant https://cloudfon.atlassian.net/wiki/spaces/CX/pages/edit-v2/276660357?draftShareId=36a046ef-594b-4834-8c6f-7f8c2dfee4b2.
Connect CloudCX to HubSpot CRM
Prerequisites
To connect with HubSpot, your CloudCX system administrator needs to complete the integration in the CloudCX admin system > Connector Hub Settings > HubSpot. You can find more details about Integrate with HubSpot CRM
...
（1）Log in Application-HubSpot.
Step-by-Step Instructions
Go to your CloudCX system
CloudCX installation domain, and log in with the admin account.
...
From the left navigation menu, go to App & Integrations.
...
Select the HubSpot card, and click
...
on “Settings”.
...
...
Click on “Connect with
...
HubSpot” and then
...
login with your HubSpot
...
account.
...
Note: You need to have particular sets of permissions in your HubSpot account for the integration to work. It is recommended that you use an HubSpot Admin HubSpot account.
| Info |
|---|
CloudCX also supports you to custom integration with HubSpot. |
（1）HubSpot Configuration
Create or Login your HubSpot Developer Account：https://developers.hubspot.com/
Click to Create a developer account
...
Click to build an app
...
Select your job role and fill in your company information
...
When you're done, click on the Apps menu to create an app
...
Fill your App Info,copy Authorized Redirect URL and pasted to your App
Select the permission scope of the app,You can choose to turn advanced scope Settings on or off the Required scope.if you turn on the options,These required scopes must be included:
crm.lists.read
crm.lists.write
crm.object.companies.read
crm.object.companies.write
crm.object.contacts.read
crm.object.contacts.write
crm.object.owners.read
ouath
tickets
...
if you turn off the options,These required scopes should be included:
crm.object.companies.read
crm.object.companies.write
crm.object.contacts.read
crm.object.contacts.write
crm.object.owners.read
ouath
tickets
After you have created the App, copy the client ID and client secret,it will be used later.
...
（2）CloudCX Configuration
Click custom configuration.
...
Fill in the Client Id and Client Secret of your HubSpot application into Client-id and Client-Secret, and fill "https://app.hubspot.com/" into both Account Server Address and CRM address.
...
Clik connect with Hubspot,choose your Hubspot account.
...
Choose one account to connect with your CloudCX system, then click on “Choose Account”.
| Note |
|---|
Warning: Choose Standard HubSpot Accounts, don't please do not select the App Developer Account you just created, or you won't be able to connect successfully. |
...
Then you’re done the HubSpot Custom configuration.
...
...
Click on “Connect app” to approve the permission requests from your CloudCX system, the HubSpot connect page will be closed automatically.
...
The connected HubSpot account will be shown on the App & Integrations > Settings. Now, CloudCX will be able to save or update visitor’s information to the connected HubSpot account.
Configure HubSpot in CloudCX
After connecting CloudCX with your HubSpot, you need to choose select whether you want CloudCX to record WebChat Web Chat / Inbox data as Task details, Contact contact details, or create a Ticket in your HubSpot account.
Automatically Create Contact/Ticket/Task in Web Chat/Inbox
Select “Automatically”, then specify in each section what data the CloudCX will automatically create into the HubSpot.
| Sections | Actions |
|---|---|---|
Web Chat |
|
|
Inbox |
|
Sections | Actions |
|---|---|
When a Matching Contact is Found |
|
...
Configure the object fields mapping and display in Web Chat/Inbox
...
Click on “Customize Now” to enter the customize identification rules.
...
...
Configure customize rules to identify the HubSpot Account, Contact and Lead, then click on “Save”.
...
Click on “Save“ to save the HubSpot configuration.
...
For Sales: Record Visitors as Contacts and Chats/
...
Conversations as Tasks
A Contact contact will be automatically created for each visitor who cannot be found from the existing Contacts contacts in the HubSpot account, and a task is automatically created for each chat/message conversation of the visitor.
Create a Contact
If a visitor is can not be found by email or name the identification rule from the existing Contact contacts in your HubSpot account, a . A new contact will be automatically created for the visitor when a chat endsis starts, or an offline message is submitted.
...
is received, or a conversation is starts.
| Note |
|---|
Warning: If the new contact can not be created in your HubSpot account, please check whether the new contact’s Phone Number is filled in correctly, when the Phone Number is wrong, HubSpot can not synchronize the new contact successfully. |
...
Create a Task
When creating a new contact, the chat/message conversation of the contact is attached as a task under the contact. For an existing Contactcontact, each chat/message conversation from the contact will be automatically added as a task.
...
For
...
Support: Record Visitors as Contacts and Chats/
...
Conversations as Tickets
Contact will be automatically created for each visitor who cannot be found from the existing contacts in your HubSpot account, and a ticket is automatically created for each chat/message conversation of the visitor.
Create a Ticket
When creating a new contact, the chat/message conversation of the contact is attached as a taskticket under the contact. For an existing contact, each chat/message conversation from the contact is attached as a caseticket.
...
Update Contact Information
...
Do not update the contact information.
Update the contact with information from WebChat.Web Chat/Inbox
Only add new information (Do not overwrite existing information)
Manually Create Contact/Ticket/Task in Web Chat/Inbox
If you don’t want to create Contact/Ticket/Task automatically, you can create them manually in your CloudCX Agent Console. Manually click on the action you want to perform, and the corresponding data will be recorded in your HubSpot account.
...
Select “Manually Create Contact/Ticket/Task in Agent Console”.
...
Configure the object fields mapping and display in Web Chat/Inbox
...
Click on “Customize Now” to enter the customize identification rules.
...
Configure customize rules to identify the HubSpot Account, Contact and Lead, then click on “Save”.
...
Click on “Save” to save the HubSpot configuration.
Web Chat/Inbox Data You Can Get in
...
You can set the Contact/Ticket/Task Object Fields mappings and Display in CloudCX.
...
HubSpot
Contact Details
CloudCX Fields in Web Chat | CloudCX Fields in Inbox | HubSpot Contact Fields | |
Agent who chatted with the contact | Agent who conversated with the contact | Contact Owner | |
Name | Last Name | Last Name | |
Phone | Phone Number | Phone Number | |
Company | Company Name | Company Name |
Ticket/Task Details
CloudCX Fields in Web Chat | CloudCX Fields in Inbox | HubSpot Ticket Fields | HubSpot Task Fields |
Agent who chatted with the contact | Agent who conversated with the contact | Subject | Subject |
Name | Last Name | Contact | Subject |
Subject | Subject | ||
Phone | Cell Phone | Ticket description | Comments |
Company | Company Name | Company | / |
Tenant ID | Tenant ID | Subject | Subject |
Chat Channel | Chat Channel | Subject | Subject |
Chat Content | Conversation Content | Ticket description | Comments |
Chat ID | Conversation ID | Ticket description | Comments |
Note | Note | Ticket description | Comments |
Agent Wrap-up | / | Ticket description | Comments |
Start Time | Start Time | Ticket description | Comments |
End Time | End Time | Ticket description | Comments |
Custom Fields and Custom Variables | / | Ticket description | Comments |
Attachments | Attachments | Attachment section in Ticket description Details | Attachment section in Comments Details |
Note: While creating a new contact, the Agent in CloudCX need to manually set the use in HubSpot as the Contact Owner. The same rule is applied to the Ticket Owner, and Task Owner.
Disconnect CloudCX to HubSpot CRM
Click on the “disconnect” icon to open a confirmation window to disconnect the HubSpot account. Click on “OK” button to disconnect the HubSpot account, or click on “Cancel” to cancel the disconnection.
...