1.Overview

WhatsApp Connect by MakeWebBetter is a tool to bypass the complexities of WhatsApp API and integration. It primarily offers HubSpot WhatsApp integration, a dedicated messaging layer, a Meta template builder, and a WhatsApp AI chatbot builder. This WhatsApp CRM tool aims for an improved WhatsApp Business experience alongside AI, context awareness, personalisation, and automation. With the HubSpot WhatsApp integration, you can manage conversations with your contacts, send one-to-one messages, and broadcast to segments within the app or in HubSpot. Moreover, the tool surpasses the basic WhatsApp integration essentials and brings prominent features like WhatsApp Business analytics, LLM integration, campaign builder, and failure management with an auto-retry mechanism.

2.Setup

To start using WhatsApp Connect and its features, you need to first sign up on the platform.

whatsapp connect sign up

  • Fill in the required details (Full name, email, & password), check the T&C box, and click sign up.
  • Next, you will be redirected to the sign-in page. Sign in using the login credentials you provided.

whatsapp connect login

  • Tick the ‘remember me’ box for a quicker entry next time and click the Sign in button.
  • Finally, you will be inside WhatsApp Connect.

dashboard

3.Account Connection

To start using the functionalities, you would need to add a WhatsApp Business account using your Meta/Facebook credentials.

3.1.Connect WhatsApp Account

Next is connecting your WhatsApp Account with the WhatsApp Connect platform.

  • Go to Connections and click on the ‘Add New Account’ button on the top-right.

connect whatsapp account

  • There are two options to connect your account:
    • WhatsApp Cloud API (For a new account): Create a fresh WhatsApp account using a new number.
    • WhatsApp Coexistence (For an existing account): Through the WhatsApp Coex feature, WhatsApp
    • Connect enables you to add and use your existing WhatsApp business account to the platform.

connect whatsapp account 1

  • After choosing your option, the Meta Account Oauth window will open. This is to register your number on WhatsApp Cloud API. Click the Continue button.

connect whatsapp new account - facebook

  • On the next page, start by naming a business portfolio and creating a WhatsApp Business account. Then, click Next and then add your WhatsApp number (new or existing).

connect whatsapp new account - facebook1

Note: If you choose the WhatsApp Coexistence option when adding your WhatsApp account. Then you will see the option to ‘Connect a WhatsApp Business app’. When you do this, there will be additional steps added to the process.

connect whatsapp new account - facebook3

  • After this, fill in the details related to your business (Name, Email, Category, Country, Website, & Time zone). Then, click Next.

connect whatsapp new account - facebook info

  • After creating a portfolio and adding your WhatsApp Business account, enter a name or a WhatsApp number that will be displayed for your identity when sending messages.

connect whatsapp new account - facebook2

  • After this, enter the OTP you received to verify the phone number. Once done, click Next.
  • Then, verify what you’ll share the access and permissions with the platform.

connect whatsapp new account - facebook review access

  • Next, review the access & permissions and click ‘Confirm.’

connect whatsapp new account - connected successfully

  • Lastly, click ‘Finish’ and your WhatsApp Business account will show as connected.

connect whatsapp account successful

3.2.Connect HubSpot Account

Follow the steps mentioned below to connect your HubSpot account:

  • Inside WhatsApp Connect, navigate to Connections > Integrations.

connect hubspot account

  • Click on the ‘Connect HubSpot’ button.

connect hubspot account1

  • Make sure you’re logged in to your HubSpot account. Then, choose the HubSpot account portal you want to connect with WhatsApp Connect and click the Choose Account button.

connect hubspot account portal connections

  • Read the access & permissions and then click the check box to allow it.

connect hubspot account portal connections1

  • Finally, click Connect App to complete the first stage of WhatsApp HubSpot integration.

After connecting your WhatsApp account and your HubSpot account, you will be able to access the free version of WhatsApp Connect functionalities. (Upgrade to a paid plan to unlock full access.)

3.3.Configure HubSpot Inbox & Webhooks

Next, you can configure the HubSpot inbox to view the HubSpot-sent WhatsApp messages directly in your account.

connect hubspot account setup inbox

Additionally, you can also configure webhooks for HubSpot within the app to enable real-time, bidirectional synchronization of your WhatsApp conversations with HubSpot.

4.Home

The dashboard gives a quick overview of WhatsApp messaging activity, where you can see the number of messages sent, delivered, received, read, failed & engaged with across campaigns, workflows, and 1:1 messaging.

Apart from this, the first fold also offers percentage insight into the delivery funnel with messages sent, delivered, read, and failed. In system health, you can find the number of messages that failed delivery at the webhook, ecosystem, or API level.

dashboard

Plus, you can view the status of your current plan with messages and account information. All this helps you understand the overall message flow, delivery outcomes, and recent activity at a glance.

Scrolling down will give you the recent communication log, alongside key metrics including engagement ratio, error ratio, and the monthly sent vs engagement graph. At the bottom, you can find the statistics on your templates to ascertain which tactics work best for you.

This is aimed at enabling a quick assessment of delivery health and broader identification of issues without digging into individual sections.

5.Template Analytics

As the name suggests, this tab gives you the complete breakdown of the performance of each of the templates. This analytics includes the number of attempts, successful delivery, read, and failed delivery on the API, Webhook, and Ecosystem level.

template analytics

The ‘Top Template by Volume’ indicated the most utilized and most successful template. Further down the page, you can view how each of the templates performed.

Note: WhatsApp Connect offers a dedicated template builder, where you can create and submit templates for Meta approval. We will learn more about it later in the ‘Meta Templates’ section.

6.Failed Events

The failed messages appear here. WhatsApp Connect automatically retries failed messages where possible, over a defined period. If automatic retries are unsuccessful, you can retry messages manually or delete them if they are no longer required. WhatsApp Connect automatically retries these messages. From this section, you can review failed sends, retry them manually, or delete them if they are no longer required.

Error

Code

Parameter of type text is missing text value.

131008

The parameter ‘to’ is required.

100

Something went wrong.

131000

failed events

6.1.Messages

The Messages section lets you monitor and manage WhatsApp messages that fail to initiate from the app or fail at the API delivery level. You have the following options, along with the details of the error:

  • Error Code
  • Error Details
  • Details of Sender’s & Recepient’s WhatsApp Account
  • Redirect button for the respective HubSpot Workflow and Contact Record
  • Details of Header and Body tokens

You can also edit message body tokens where applicable and retry sending after making corrections.

6.2.Webhooks

The Webhook section contains the failed messages log that occurred at the webhook level. When the message delivery encounters an error on the webhook provider’s system, due to server errors, timeouts, network issues, or an invalid URL/configuration. Then, the failed messages will appear in this tab.

The Failed Webhook Messages contain the following details and options:

  • Template Code
  • Sender & Recipient Number
  • Error details
  • Options to copy message ID, retry & delete

6.3.Ecosystem

The Ecosystem section gives the details of the messages that failed at Meta’s end due to platform restrictions, messaging guidelines, or ecosystem-level issues.

WhatsApp Connect automatically retries these messages where possible. From this section, you can review failed sends, retry them manually, or delete them if they are no longer required.

7.Meta Templates

The WhatsApp templates are located in this tab. Here, you can create, submit, save, and manage your templates. These templates are utilized later while sending, scheduling, or automating messages.

message templates

It’s the first step in the process when you want to set up campaigns, broadcast, or send a one-to-one message to your contacts.

To create a new template:

  • Navigate to the templates tab.

message templates1

  • In the template page, look for the ‘Create New Template’ button and click on it.

message templates2

  • On the next page, click on the dropdown that says ‘Select a Sample Payload’ to choose the layout of your WhatsApp message.

create template - select payload

  • Next, enter the Template Information, i.e., Name, Language, & Category. Moreover, you can choose to have ‘no header’ or keep a header as text or an image, even if you have chosen a different payload. The content of the header for ‘text’ can be inserted here only. But if you select an image as a header, then you can upload the image when you frame the message for a campaign, automation, or 1:1 messaging, later on.

  • After this, you will be required to enter Body Text. Along with this text, you can use number(s) as {{n}} for variables that are used to personalize messages. Furthermore, as with the header, you may add an optional Footer for any supplementary text or disclaimers.

Note: These variables {{1}}, {{2}}, and so on, are the placeholders that fetch data directly from the uploaded CSV file, based on column order (1, 2, 3, 4). We will learn about it in detail in the next section.

  • Next, define the button functionality. You can choose three types of action buttons:
    • Phone Call: Enter button text and provide a Number with a country code.
    • URL Visit: Enter button text and provide a website URL / meeting link.
    • Quick Reply: Enter text.

  • Lastly, there’s an option to choose Carousel Card, which you can utilize to share product images, snapshots of your tool, or relevant illustrations.
  • Once final, click the Generate Template button at the bottom of the page.

8.Saved Replies

Saved Replies are your templates for pre-defined responses to frequently asked questions, common customer queries, or repetitive conversations—helping you respond faster, maintain consistency, and reduce manual effort across your communication channels.

saved replies

You can find your saved replies here. Moreover, you have the option to favourite and categorise your preferred replies.

Other than this, you can review which replies are performing well by analysing the frequency of the sends.

saved replies analytics

8.1.How to create Saved Replies templates in WhatsApp Connect?

To create Saved Replies templates:

  • Navigate to the Saved Replies tab from the main menu.
  • Find and click on the New Reply button in the top right corner.

saved replies

  • Once the side panel appears, start selecting the response type, which includes: text, image, video, document, reply buttons, list message, or CTA URL.

saved replies1

  • After this, define the body of the template by including the header, message body, footer, button label, URL. (The content of the body may change depending on the response type you choose in the first slide.)

saved replies2

  • Lastly, pick a name for your saved reply to find it easily when choosing from saved replies. You can also categorise it.

saved replies3

  • Once done, click on the Create template button.

9.Contacts

WhatsApp Connect offers built-in contact management, a robust directory layer that lets you add, sync, backfill, and delete contacts. With this, you always have access to your contacts and monitor the growing customer base.

Contacts

In addition to syncing from HubSpot and WhatsApp Business, you can add contacts manually to the contact directory. For this,

  • Fill in the name of your contact in the required field. Although this is optional, you can also choose to leave it empty.
  • Enter the Phone Number in the required field.
  • Lastly, click on the ‘+ Add Contact’ button.

contact management 1

  • The Contact Directory lets you monitor your contacts and offers insight into the recent messages shared. Here, you can search for, manage, and delete contact records.

10.Contact Lists

Contact Lists are your go-to list of contact segments, which can be reused for bulk sends and scheduling campaigns. For this,

  • Enter the segment name in the required field.

contact lists

  • You can also add some description to define the goal and attributes of the segment. (optional)
  • Once done, click the Create List button.
  • On the right side of the page, simply search or scroll to choose which contacts you want to include in this list.
  • Lastly, click Save Members.

11.Campaigns

The campaign enables you to send messages in bulk using contact segments (lists) and CSV uploads.

11.1.Campaigns Overview

In the overview section, you can find all the details about your live campaigns:

  • successful templates,
  • current status,
  • number of recipients,
  • scheduled time,
  • date published

Apart from that, you will have the option for certain actions:

  • Pause
  • Reschedule
  • Delete

campaigns overview

11.2.Send Messages

This is your campaign launch panel, where you can send the messages immediately or schedule them for later.

campaigns builder

For this, follow the steps mentioned below:

  • Select a WhatsApp Account that you have added in WhatsApp Connect.
  • Choose a CSV file to list the contacts that want to be included in the WhatsApp campaign (You can upload your CSV file from the Manage CSVs tab.)
  • Next, select a message template that you have created earlier.

campaigns send message

  • Once done, click the Send Message button at the bottom of the page.

Moreover, you can schedule the message send-out. For this, click on the Enable tick which is next to the Schedule option. There, you can decide on the date on which you want to launch your WhatsApp campaigns.

11.3.Manage CSVs

Here, you can upload your contacts in the form of CSV files directly and utilize them while sending or scheduling campaigns. To upload CSV files in WhatsApp Connect:

  • Navigate to Campaign > Manage CSVs.
  • Next, click on Add CSV button.

campaigns csv upload

  • After this, click on the Choose File button and upload your file. There is also an option to drag and drop your file from your system directly.

campaigns csv upload1

  • Once done, click Upload. And you will be able to view your uploaded CSV file in the Manage CSVs tab.

Note: When you upload the contacts CSV file, use a similar format that will define the value of the variables (placeholders). To ensure accuracy, your CSV must follow this specific format:

  • {{1}} = Phone Number
  • {{2}} = Name
  • {{3}} = First Name
  • {{4}} = City

While framing the body text in the template, use the variables as ({{1}}, {{2}}, {{3}}, & {{4}}, they will correspond to the data you provided through the CSV file upload, in a similar order.

12.Messenger

Messager is your inbox for all your interactions with your contacts.

Start 1-on-1 conversations with new contacts or interact with your existing contacts. Moreover, you will find your new messages here, which are sent directly by your contacts.

messenger

Utilise the existing Meta-approved message templates to initiate conversations with contacts.

For new 1:1 conversations, click on the search box under ‘Message New User’, type in the WhatsApp number of your new contact, and then click the Start button. To send messages in existing conversations, use the templates.

13.Chatbot Flows (Beta)

The in-built chatflow builder allows you to create your own WhatsApp chat automation and also deploy WhatsApp AI Chatbot features. (Available in beta)

13.1.New Flow (Chatbot Builder)

chatbot flows builder

To create a new chatflow inside WhatsApp Connect:

  • Click on the New Flow button.
  • Once you’re inside the builder, select the trigger type and define the event.

chatbot flows builder trigger

  • (In case of Keyword Match trigger) Select the Match type and enter the Keyword(s) for the queries you want to attend. E.g. hello, help, how, talk to, ticket, issue, etc.
  • Next, add a step to this trigger by choosing from the pop-up.

chatbot flows builder step 1

  • Once done, click on the Save button.

Next to the Save button, you have a few more options to manage your chatflow:

chatbot flows builder manage

  • Test Bot: Here you can play the simulation of your Chatflow and test how well it works.
  • Analytics: You can find the data using preset date range criteria. This section tells you the following:
    • Total sessions
    • Completion rate
    • Average duration
    • Handoff rate
    • Node Drop off (point where user left conversation)
    • History: It provides a snapshot of previous versions of your chatflow and lets you label the previous flow setup.
  • Subflows: This allows the option to save a chatflow as a separate part, which can be embedded in other chatflows.

chatbot flows builder embed subflow

Subflows are a modular, self-contained sequence containing conversational steps of the parent chatflow. You can access them from the primary page of the Chatbot flow.

chatbot flows builder subflow1

14.WA Flows (Coming Soon)

WA Flows (WhatsApp Flows) are in-chat interactive forms, built to prevent conversation back-&-forth using app-like screens (forms, dropdowns). These are similar to the WhatsApp Business functionality ‘WhatsApp Flows’, allowing you to centralise all your customisation through a single platform.

15.How to create a WhatsApp Messaging Automation using HubSpot Workflow?

Once the app is connected with your HubSpot account and WhatsApp account, you can access its functionalities within HubSpot. Follow the steps mentioned below to create workflow to automate WhatsApp message sendouts for your contacts.

  • Go to your HubSpot portal.
  • Navigate to Automation > Workflows.
  • Click on the Create Workflow dropdown on the top right and then choose From Scratch.
  • Proceed to choose a trigger. For example, you can choose Property value changed under Data value. Furthermore, you can choose a Webhook, Form Submission, Support Ticket, or any other as your workflow trigger, whichever is relevant.

  • Choose the criteria as the WhatsApp number is known.

  • Choose your next workflow Actions for the above trigger. For example, you can set them as a Marketing Contact for whom the WhatsApp number is known, then shoot an email, and add a delay. Lastly, you must choose the Send WhatsApp Message action under HubSpot WhatsApp by MakeWebBetter, in Interated Apps at the bottom of the scrollable section.

  • Upon clicking Send WhatsApp Message, select your WhatsApp Account, a WhatsApp Template, the Receiver WhatsApp Number (Property), and the Header & Body Token Value.

  • Once done, click the ‘Review and turn on’ button on the top right.

16.HubSpot App Card

WhatsApp Connect also enables you to send WhatsApp messages directly to your contacts, using the App Card functionality.

16.1.Configure WhatsApp Connect App Card

To enable the WhatsApp Connect send message functionality in your HubSpot, you need to configure the HubSpot App Card. Follow the steps mentioned below to do so.

  • Log in to HubSpot with the same account/portal used for the WhatsApp Connect signup.
  • Once inside HubSpot, click on the ⚙ (Settings button) located at the top.
  • After this, in the scrollable menu on the right, go to Data Management > Object > Contacts.

whatsapp connect contact app card

  • Then, click on the Record Customization tab in Contacts.
  • Next, click on the Default View team view.

app card default view

  • On the next page, you will be able to customize (add, remove, arrange) the tabs in your Contact Timeline Event > Overview section.
  • To add the WhatsApp Connect app card in the Contact Event Overview tabs, simply hover above the top tab and then click Add Card.

add app card

  • After this, the Card Library will slide in from the right.
  • Type ‘WhatsApp’ in the Search cards box.
  • Next, click + Add Card button under “HubSpot WhatsApp by MakeWebBetter”.

hubspot app card library

  • By following this setup, you’ll be able to access the WhatsApp Connect App Card in the Timeline Events Overview section of your contacts.

whatsapp connect app card

16.2.Templates Sender

Follow the steps mentioned below to send messages:

  • In your HubSpot account, navigate to the CRM > Contact.
  • Click on the Contact record name to whom you want to send the message to.

template sender app card

  • After this, click on the Select Template dropdown and choose the WhatsApp message template you want to send to the contact, and enter in the details (URL, text, etc)

whatsapp template sender

16.3.Send Text Message

Moreover, you can opt to send a message. For this,

  • Follow the same steps mentioned above.
  • Switch to Send Text Message. Enter the message text you want to send and click on the Send button.

whatsapp message hubspot app card

17.Tracking in HubSpot

You can track the message sent through HubSpot workflows or the HubSpot App Card.

whatsapp activity tracking

You can choose to view your WhatsApp interaction in your HubSpot account in:

  • Inbox
  • Helpdesk

18.Settings

  • AI Configurations: WhatsApp Connect offers integrations with OpenAI, Anthropic, and Google Gemini. Set up AI integration by using the API/Secret keys. API keys are encrypted at rest using AES-256. Keys are only utilised by the server during flow execution.

Settings AI Configuration

  • Billing: Find all the details related to your current plan (Active Status, Message Balance, Expiry, and No. of Accounts).

Settings Billing

  • Email Preferences: From here, you can enable the email notifications. With this, you will receive updates and auto-generated reports on your WhatsApp messaging activity on a daily, weekly, and monthly basis. Moreover, you can opt in to get notified on quota warnings, plan updates, account updates, and marketing emails.

Settings email preferences

  • Roles: You can set any number of user roles with distinct access types and permissions to the platform’s functionalities.

Settings roles

To add a role, click on the + New Role button, assign a name, and then define permissions.

  • Inbox: An inbox is a routing queue (e.g. “Support”, “Sales”). WhatsApp numbers link to an inbox, and agents assigned to that inbox receive conversations automatically.

Settings inbox

  • Team: Here, you can add team members with defined roles and availability to access the WhatsApp Connect portal.

Settings team

This documentation covers the core setup and usage needed to operate WhatsApp messaging effectively using WhatsApp Connect by MakeWebBetter. For a complete walkthrough of advanced capabilities and real-world use cases, book a free demo to see WhatsApp Connect in action.

Suggest Edit