- Install and connect
- Turn on each feature
- Disconnect or uninstall
01
Before you start
Check these four things first.
- Your DripTell plan includes integrations. Starter, Business and Scale do. Lite and Forever Free do not.
- You are the owner of the DripTell workspace. Only the owner can connect HubSpot.
- You can install apps in HubSpot. That means you are a Super Admin, or you have App Marketplace access.
- At least one WhatsApp number is connected in DripTell.
02
Install the app and connect HubSpot
You connect HubSpot from DripTell. HubSpot asks you to pick an account and approve the permissions, then sends you back to DripTell.
- 1
Open the HubSpot page in DripTell
Sign in to DripTell. Go to Settings, then Integrations, then HubSpot.
- 2
Select Connect HubSpot
DripTell opens HubSpot in the same window.
- 3
Choose your HubSpot account
Pick the account you want to use and approve the permissions.
- 4
Check that it says Connected
You return to DripTell. The HubSpot page shows Connected and your HubSpot account name.
03
Permissions DripTell asks for
DripTell asks only for what its features use. After you connect, you can see the permissions on the Connection tab. DripTell does not ask for access to deals.
| Permission | Required | Used for |
|---|---|---|
| Read contacts (crm.objects.contacts.read) | Yes | Finding contacts by phone number, the DripTell card and list imports |
| Write contacts (crm.objects.contacts.write) | Yes | Sending leads, flow steps, saving chats on the timeline and call notes |
| Read contact properties (crm.schemas.contacts.read) | Yes | Showing your contact properties when you map fields |
| Read owners (crm.objects.owners.read) | Yes | Routing calls to the contact owner |
| Read lists (crm.lists.read) | Optional | Importing HubSpot lists into DripTell groups |
04
Choose what to turn on
Every feature is off until you turn it on in DripTell. Nothing is saved in HubSpot until then. Most features have their own tab on the HubSpot page in DripTell.
| Feature | What it does | Where to turn it on |
|---|---|---|
| Leads and contacts | Sends DripTell leads to HubSpot contacts, with the fields you map | Contacts & leads tab |
| Chats on the timeline | Saves WhatsApp messages on the HubSpot contact timeline | Chats tab |
| DripTell card | Shows the WhatsApp chat on HubSpot contact records | Chats tab |
| List imports | Imports a HubSpot contact list into a DripTell group for a campaign | Lists tab |
| Flow steps | Creates or updates HubSpot contacts from DripTell flows | DripTell flow builder |
| Call routing | Rings the HubSpot contact owner when a call comes in | AI calls routing |
05
Send leads and contacts to HubSpot
Use this to keep HubSpot contacts up to date with the leads your team collects in DripTell.
- 1
Open the contacts and leads tab
On the HubSpot page in DripTell, open the Contacts & leads tab.
- 2
Turn on Send leads to HubSpot
Leads are sent when you export them. Turn on From automations too if you also want leads created by flows sent.
- 3
Choose what happens to existing contacts
Update that contact matches by email, then by phone. Always add a new contact creates a new one each time.
- 4
Map your fields and save
Pick which DripTell value goes into each HubSpot property.
06
Save WhatsApp chats on the contact timeline
DripTell can save each WhatsApp message as a WhatsApp entry on the HubSpot contact timeline, with its time and text. It starts with new messages. Older chats are not copied.
DripTell finds the HubSpot contact by WhatsApp number. If HubSpot is busy, messages wait and are saved in order. Nothing is saved twice.
- 1
Open the Chats tab
On the HubSpot page in DripTell, open Chats.
- 2
Turn on Save WhatsApp chats to HubSpot
Then pick the WhatsApp numbers to save chats from.
- 3
Choose the extras
You can add new customers to HubSpot when they write to you first, include replies you send and include campaign messages.
- 4
Save your chat settings
New messages start appearing on the HubSpot contact timeline.
07
See WhatsApp on a HubSpot contact
The DripTell card shows the contact's WhatsApp number, subscription status, whether you can reply now and the latest messages. It reads the chat live from DripTell. Nothing is copied into HubSpot.
- 1
Turn on the card
In the Chats tab, turn on Show the DripTell card in HubSpot.
- 2
Choose who can see the chat
By default, only HubSpot users who are also DripTell team members, with the same email address, can see it. You can choose Everyone in HubSpot instead.
- 3
Open a contact in HubSpot
The DripTell WhatsApp card is in the right sidebar of the contact record.
08
Send a WhatsApp campaign to a HubSpot list
Import a HubSpot contact list into a DripTell group, then send a campaign to that group. This needs list access.
- 1
Open the Lists tab
On the HubSpot page in DripTell, open Lists.
- 2
Find the list and select Import
DripTell adds everyone with a WhatsApp number to a new group. People already in DripTell are matched by number and not changed. Large lists keep importing in the background.
- 3
Select Create campaign
When the import is done, create a campaign for the new group.
09
Use HubSpot in flows and AI calls
These two features are optional and are set up outside the HubSpot page.
- Flows. In a DripTell flow, add a Create CRM record step and choose HubSpot. The step creates or updates the HubSpot contact.
- AI calls. In AI calls routing, choose HubSpot to ring the contact owner. If the CRM timeline add-on is on, DripTell also adds a call note to the HubSpot contact.
10
Disconnect HubSpot in DripTell
You need permission to remove integrations in DripTell. The workspace owner always has it.
- 1
Open the Connection tab
In DripTell, go to Settings, then Integrations, then HubSpot. The Connection tab opens first.
- 2
Select Disconnect HubSpot
Then select Yes, disconnect.
- When you disconnect, DripTell asks HubSpot to cancel its access and deletes the access tokens it stored.
- DripTell stops reading and writing HubSpot data. Chats that were waiting to be saved are not saved.
- Your settings and the links between DripTell and HubSpot contacts are kept. If you connect the same HubSpot account again, it picks up where it left off.
11
Uninstall the app in HubSpot
Disconnecting in DripTell removes DripTell's access. To remove the app from HubSpot as well, uninstall it there.
- 1
Open Connected apps
In HubSpot, open Settings. Go to Integrations, then Connected apps.
- 2
Uninstall DripTell
Find DripTell in the list and uninstall it.
- After you uninstall, DripTell shows that HubSpot needs reconnecting.
- Chats waiting to be saved are kept for up to 7 days. If you reconnect within that time, they are saved. After 7 days they are not saved.
12
What happens to your data
Disconnecting or uninstalling does not delete contacts or chats in either product.
- Records DripTell already wrote to HubSpot stay in HubSpot. That includes contacts, WhatsApp timeline entries and call notes. You can edit or delete them in HubSpot.
- DripTell contacts, chats and groups made from imported lists stay in DripTell.
13
Fix common problems
Most problems are fixed by reconnecting HubSpot.
- DripTell says Reconnect needed. HubSpot stopped accepting DripTell's access. Select Reconnect HubSpot and approve the permissions again.
- The Lists tab asks you to reconnect. List access is optional. Reconnect HubSpot and approve list access.
- The card says only DripTell team members can see the chat. Ask the DripTell owner to add you to the team with the email you use in HubSpot, or to let everyone in HubSpot see the card.
- A new HubSpot contact is not found straight away. HubSpot can take a few seconds to make a new contact searchable. DripTell tries again.
- You connected a different HubSpot account. Saving chats pauses, open list imports stop and flow steps need the account chosen again. This keeps one company's data out of another company's HubSpot.
14
Get help
Email support@driptell.com. Tell us your workspace name, what you did and what you see.
