The HubSpot integration is designed for attribute synchronisation between matching contacts. It is not a full two-way sync, so it is best to familiarise yourself with the limitations of the integration outlined below.
Contact matching and syncing
Why are some contacts not syncing between HubSpot and Superchat?
The integration matches contacts based on phone number or email address. A contact must exist in both HubSpot and Superchat with matching details — if no match is found, attribute synchronisation will not occur.
Does the integration automatically create contacts between systems?
No. The native integration does not automatically create contacts in either direction. New contacts created in HubSpot are not created in Superchat, and vice versa — only attributes of already matched contacts are synchronised. If you need automatic contact creation between systems, this can be achieved using Zapier or Make.
Attribute synchronisation
Which HubSpot field types are supported?
The following field types can be synchronised: text, number, date, single select, and boolean. Multi-select fields and other custom formats are not supported.
Do I need to select attributes manually?
Yes. All attributes must be selected individually for synchronisation, including standard HubSpot fields.
How long does synchronisation take?
Standard HubSpot attributes sync immediately. Custom attributes may take up to 24 hours. If a custom attribute is updated at the same time as a standard attribute, it may sync faster.
Can the Contact Owner field be synchronised?
No. The Contact Owner field is not currently supported.
Working with synced attributes
Can I edit synced HubSpot attributes in Superchat?
No. Synced attributes cannot be edited in Superchat while the HubSpot connection is active.
What happens to synced attributes if I disconnect HubSpot?
The attributes remain in Superchat but become regular attributes and are no longer updated from HubSpot.
Can I map HubSpot fields to existing Superchat attributes?
No. Each synced HubSpot field creates a new custom attribute in Superchat. It is not possible to map it to an attribute that was already created in Superchat.
What should I consider before reconnecting HubSpot?
Existing attributes with the same name may cause conflicts. You may need to delete old HubSpot attributes before reconnecting.
Workflows and automation
Can I send WhatsApp templates via HubSpot workflows?
Yes, but only for contact-based workflows. This action does not work for other objects such as deals.
Can I trigger WhatsApp messages from deal-based workflows?
Not directly. If your workflow is based on deals, you will need an additional step to identify the associated contact before the WhatsApp message can be triggered.