> ## Documentation Index
> Fetch the complete documentation index at: https://help.chatarmin.com/llms.txt
> Use this file to discover all available pages before exploring further.

# HubSpot Integration

> Chatarmin guide: HubSpot Integration

# Video Guide

<iframe src="https://www.loom.com/embed/7636b10fa4fa47dfb41c7ba6c90d045e" title="Loom video" width="100%" height="420" allowFullScreen />

# How to connect

Connecting is very easy. Just navigate to [https://chatarmin.com/dashboard/hubspot/connect](https://chatarmin.com/dashboard/hubspot/connect) and click on "Connect Now".

<img src="https://mintcdn.com/chatarmin-help-center/yL66zflq9rxpRjF_/images/7e91cfee-6672-4ed0-b8b1-533513a5340a/019b9c80-ac4b-703e-900a-27bcf41e1606.png?fit=max&auto=format&n=yL66zflq9rxpRjF_&q=85&s=bc3c42a99e30019ceb714893b4df10a0" alt="Chatarmin help center image" width="911" height="501" data-path="images/7e91cfee-6672-4ed0-b8b1-533513a5340a/019b9c80-ac4b-703e-900a-27bcf41e1606.png" />

<img src="https://mintcdn.com/chatarmin-help-center/yL66zflq9rxpRjF_/images/7e91cfee-6672-4ed0-b8b1-533513a5340a/019b9c80-ac64-772e-bc76-282b6a901027.png?fit=max&auto=format&n=yL66zflq9rxpRjF_&q=85&s=4e4a50366a236714cb3765be01746489" alt="Chatarmin help center image" width="911" height="852" data-path="images/7e91cfee-6672-4ed0-b8b1-533513a5340a/019b9c80-ac64-772e-bc76-282b6a901027.png" />

# Features

So the Integration currently can do 4 things:

1. Automatic background sync of Chatarmin contacts to HubSpot
2. Update HubSpot contact Flow action
3. Check for specific HubSpot contact properties (if/else) inside chatarmin flows
4. Syncing Events like "Updated contact", "Created contact" to HubSpot

We are going to explain the following more in depth, down below:

# Automatic background sync

So when a contact enrolls a WhatsApp-Flow and you have HubSpot integrated, the system is already working its magic in the background.

We check, if there is already a matching contact with that phone number/email. -> If yes, then we sync the Chatarmin & HubSpot data, so you have the profiles enriched in both tools.

If there is no contact yet, we create the contact in HubSpot with the contact data from chatarmin.

Lets say in chatarmin we only have a phone number and no email, therefore we create a phone-only contact. If that contact in chatarmin later on, gets an email assigned, we sync again and if now a contact appears to be in HubSpot with that email, we merge the "phone-only" contact from before, so there won't be 2 different contacts

## BONUS: WhatsApp Consent Sync

When integrating HubSpot, you can choose to sync the WhatsApp Consent automatically to a HubSpot property of your chose. Just type a property of your choice and we will sync the Consent!

<img src="https://mintcdn.com/chatarmin-help-center/yL66zflq9rxpRjF_/images/7e91cfee-6672-4ed0-b8b1-533513a5340a/019b9c80-ac67-744e-9017-f4fb9bade410.png?fit=max&auto=format&n=yL66zflq9rxpRjF_&q=85&s=e8b73098e6792ace1f5ab6abfe8cb789" alt="Chatarmin help center image" width="1840" height="1340" data-path="images/7e91cfee-6672-4ed0-b8b1-533513a5340a/019b9c80-ac67-744e-9017-f4fb9bade410.png" />

# Update Contact Flow Action

In a Chatarmin Flow, you can choose to update properties in HubSpot:

<img src="https://mintcdn.com/chatarmin-help-center/yL66zflq9rxpRjF_/images/7e91cfee-6672-4ed0-b8b1-533513a5340a/019b9c80-ac7d-762d-926c-a8272e865461.png?fit=max&auto=format&n=yL66zflq9rxpRjF_&q=85&s=60d69bcfdca5da2dc0c2385158be7fd1" alt="Chatarmin help center image" width="2422" height="1506" data-path="images/7e91cfee-6672-4ed0-b8b1-533513a5340a/019b9c80-ac7d-762d-926c-a8272e865461.png" />

# If/Else for HubSpot properties

Also, you can check for specific HubSpot contact properties in a flow:

<img src="https://mintcdn.com/chatarmin-help-center/yL66zflq9rxpRjF_/images/7e91cfee-6672-4ed0-b8b1-533513a5340a/019b9c80-ac95-7014-82a3-3557bfafaed9.png?fit=max&auto=format&n=yL66zflq9rxpRjF_&q=85&s=c8839bdb73980e2ac6df81cf9e2265ef" alt="Chatarmin help center image" width="2422" height="1506" data-path="images/7e91cfee-6672-4ed0-b8b1-533513a5340a/019b9c80-ac95-7014-82a3-3557bfafaed9.png" />

# Automatic Sync of Chatarmin Events to HubSpot

Also, Chatarmin does automatically create Events in HubSpot:

<img src="https://mintcdn.com/chatarmin-help-center/yL66zflq9rxpRjF_/images/7e91cfee-6672-4ed0-b8b1-533513a5340a/019b9c80-ac69-72ff-8d6f-c59d11a84502.png?fit=max&auto=format&n=yL66zflq9rxpRjF_&q=85&s=f30306601a467ddabf62a385fe972502" alt="Chatarmin help center image" width="1648" height="1316" data-path="images/7e91cfee-6672-4ed0-b8b1-533513a5340a/019b9c80-ac69-72ff-8d6f-c59d11a84502.png" />

# WhatsApp with Hubspot Conversations

🚨 Only if you have a ***Sales Hub*** *Enterprise* or ***Service Hub*** *Enterprise* account

Once Hubspot is connected, you can also send WhatsApp messages directly to Hubspot!

For that you just need to select the Flow-Action **"Send to Hubspot"** just like so:

<img src="https://mintcdn.com/chatarmin-help-center/yL66zflq9rxpRjF_/images/7e91cfee-6672-4ed0-b8b1-533513a5340a/019b9c80-ac8b-736d-8ca3-6ac2ec1b7c35.png?fit=max&auto=format&n=yL66zflq9rxpRjF_&q=85&s=a1eacc4c1b390efc1db33523989eed56" alt="Chatarmin help center image" width="1193" height="651" data-path="images/7e91cfee-6672-4ed0-b8b1-533513a5340a/019b9c80-ac8b-736d-8ca3-6ac2ec1b7c35.png" />

Here is also a short Video explaining it:

<iframe src="https://www.loom.com/embed/2329e357fea14865a93314bad8df2d8c" title="Loom video" width="100%" height="420" allowFullScreen />

To integrate a WhatsApp provider into HubSpot using a custom channel, follow these steps: First, create a public app in HubSpot and request the necessary permissions. Then, register your channel using the Custom Channels API, ensuring that your schema supports WhatsApp message handling. Implement OAuth 2.0 authentication to securely connect user accounts. Use the Conversations API (Beta) to link inboxes and manage messaging. Finally, refer to the WhatsApp Business API for message formatting and compliance with WhatsApp’s policies. [Find the step by step guide here.](https://developers.hubspot.com/docs/guides/api/conversations/create-custom-channels)

# Chatarmin Properties in Hubspot

In HubSpot, under **CRM → Contacts**, you’ll find the CRM database where contacts from Chatarmin are stored or updated.

<img src="https://mintcdn.com/chatarmin-help-center/yL66zflq9rxpRjF_/images/7e91cfee-6672-4ed0-b8b1-533513a5340a/019b9c80-ac48-726a-959a-86af4d7034b0.png?fit=max&auto=format&n=yL66zflq9rxpRjF_&q=85&s=8a121e04828b90591986ffcb483f4b48" alt="Chatarmin help center image" width="268" height="231" data-path="images/7e91cfee-6672-4ed0-b8b1-533513a5340a/019b9c80-ac48-726a-959a-86af4d7034b0.png" />

Within the contacts section, you can select an example contact and then click on **Actions → Customize properties**.

<img src="https://mintcdn.com/chatarmin-help-center/yL66zflq9rxpRjF_/images/7e91cfee-6672-4ed0-b8b1-533513a5340a/019b9c80-ac6f-768c-9b76-9e6995b5d980.png?fit=max&auto=format&n=yL66zflq9rxpRjF_&q=85&s=cd8d7715a48094659021691b694d58e8" alt="Chatarmin help center image" width="504" height="369" data-path="images/7e91cfee-6672-4ed0-b8b1-533513a5340a/019b9c80-ac6f-768c-9b76-9e6995b5d980.png" />

There, you’ll see all properties that are already activated and displayed for that contact. You can use **Add properties** to include new ones - including properties you’ve previously created in Chatarmin.

<img src="https://mintcdn.com/chatarmin-help-center/yL66zflq9rxpRjF_/images/7e91cfee-6672-4ed0-b8b1-533513a5340a/019b9c80-ac54-736b-aced-97c26f9288f5.png?fit=max&auto=format&n=yL66zflq9rxpRjF_&q=85&s=38b17b9cf8505e2863edc184348d1114" alt="Chatarmin help center image" width="486" height="766" data-path="images/7e91cfee-6672-4ed0-b8b1-533513a5340a/019b9c80-ac54-736b-aced-97c26f9288f5.png" />

For example, you could add the automatically synced property chatarmin\_whatsapp, which returns the customer’s opt-in status from Chatarmin.

<img src="https://mintcdn.com/chatarmin-help-center/yL66zflq9rxpRjF_/images/7e91cfee-6672-4ed0-b8b1-533513a5340a/019b9c80-ac4c-74bd-a5e3-9a1da183f340.png?fit=max&auto=format&n=yL66zflq9rxpRjF_&q=85&s=2c183e5bd5c0777571adfc8517c43e14" alt="Chatarmin help center image" width="488" height="413" data-path="images/7e91cfee-6672-4ed0-b8b1-533513a5340a/019b9c80-ac4c-74bd-a5e3-9a1da183f340.png" />

Once you’ve added the property, it will also appear in the contact details, giving you a much better overview of your customer data.

<img src="https://mintcdn.com/chatarmin-help-center/yL66zflq9rxpRjF_/images/7e91cfee-6672-4ed0-b8b1-533513a5340a/019b9c80-ac5d-77e6-9bf0-b88d2c55d577.png?fit=max&auto=format&n=yL66zflq9rxpRjF_&q=85&s=9451e1b5e19d215c02f49fda214d59ff" alt="Chatarmin help center image" width="438" height="617" data-path="images/7e91cfee-6672-4ed0-b8b1-533513a5340a/019b9c80-ac5d-77e6-9bf0-b88d2c55d577.png" />
