Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Info

CloudFon CXCloudCX's integration with HubSpot allows you to easily access customer information in the CloudFon CX CloudCX Agent Console easily and synchronize data conveniently from CloudFon CX 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 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

  1. Go to your CloudCX system CloudCX installation domain, and log in with the admin account.

...

  1. From the left navigation menu, go to App & Integrations.

...

  1. Select the HubSpot card, and click

...

  1. on “Settings”.

...

    ...

    1. Click on “Connect with

    ...

    1. HubSpot” and then

    ...

    1. login with your HubSpot

    ...

    1. 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

    CloudFon also supports you to custom integration with HubSpot.

    (1)HubSpot Configuration

    ...

    • 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

    image-20240423-104438.pngImage Removedimage-20240423-104511.pngImage Removedimage-20240424-013450.pngImage Removed

    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)Cloudfon CX 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.

    ...

    1. Choose one account to connect with your CloudCX system, then click on “Choose Account”.

    Note

    Warning: Choose Standard HubSpot Accounts, please do not select the App Developer Account you just created, or you won't be able to connect successfully.

    ...

    1. Click on “Connect app” to approve the permission requests from your CloudCX system, the HubSpot connect page will be closed automatically.

    ...

    Then you’re done the HubSpot Custom configuration.

    Integration with WebChat/Inbox

    ...

    1. 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 CloudFon CX 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

    1. Select “Automatically”, then specify in each section what data the CloudCX will automatically create into the HubSpot.

    ...

     

    Sections

    Actions

    Web Chat

    • When a Chat is Started/Ended

    • When an Offline Message is Received

    • Create/Update Contact & Attach Ticket

    • Create/Update Contact & Attach Task

    • Create Ticket

    • Do Nothing

    Inbox

    • When a Conversation is Started/Ended

    Sections

    Actions

    When a Matching Contact is Found

    • Do not update the contact

    • Update the contact with information from Web Chat/Inbox

    • Only add new information(Do not overwrite existing information)

    ...

    1. Configure the object fields mapping and display in Web Chat/Inbox

    ...

    1. Click on “Customize Now” to enter the customize identification rules.

    ...

    1. Configure customize rules to identify the HubSpot Account, Contact and Lead, then click on “Save”.

    ...

    1. 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 CloudFon CX CloudCX Agent Console. Manually click on the action you want to perform, and the corresponding data will be recorded in your HubSpot account.

    ...

    WebChat.

    1. Select “Manually Create Contact/Ticket/Task in Agent Console”.

    ...

    1. Configure the object fields mapping and display in Web Chat/Inbox

    ...

    1. Click on “Customize Now” to enter the customize identification rules.

    ...

    1. Configure customize rules to identify the HubSpot Account, Contact and Lead, then click on “Save”.

    ...

    1. Click on “Save” to save the HubSpot configuration.

    38-20240902-100300.PNGImage Added

    Web Chat/Inbox Data You Can Get

    ...

    You can set the Contact/Ticket/Task Object Fields mappings and Display in CloudCX.

    ...

    in 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

    Email

    Email

    Email

    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

    Email

    Email

    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.

    ...