1.Overview

WhatsApp Connect by MakeWebBetter is a tool to bypass the complexities of the 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 goes beyond basic WhatsApp integration with WhatsApp Business analytics, LLM integration, a 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 signup

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

sign in

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

3.Account Connection

To start using the features, you need to add a WhatsApp Business account with 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.

whatsapp business api

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

whatsapp api setup

3.2.Connect HubSpot Account

Follow the steps mentioned below to connect your HubSpot account:

  • Inside WhatsApp Connect, navigate to Connections > Integrations.

HubSpot WhatsApp integration

  • Click on the ‘Connect HubSpot’ button.

connect whatsapp with hubspot

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

whatsapp hubspot integration

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

connect hubspot whatsapp

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

hubspot whatsapp connection setup

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

4.Dashboard

The dashboard gives a quick overview of your WhatsApp messaging activities.

The Performance Summary is where you can see the total number of messages sent, delivered, received, read, failed & engaged with across campaigns, workflows, and 1:1 messaging. You can filter this view to show data from the last 7, 30, or 90 days.

The AI Insights section brings an AI-generated review of your WhatsApp sends in the last 30 days, showcasing how your campaigns and sends have performed and providing a broader view into your WhatsApp delivery funnel.

dashboard

Scrolling down will give you the recent communication log, alongside key metrics including engagement ratio, error ratio, and the monthly sent vs delivery 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.Integration Automations

integration automations

To analyze how your WhatsApp Sends are performing when launched through HubSpot automation, this tab allows all the insights you need to ascertain their performance and optimize accordingly.

You can also add filters to analyze performance over a period of time.

Click on the specific HubSpot WhatsApp automation; it will take you directly to the HubSpot workflows page to review and optimize accordingly. Additionally, the ‘High Fail’ status also highlights which automations haven’t been performing as intended.

Review your WhatsApp message automation through sent, delivered, read, failed, skipped, and pending statuses.

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

 

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

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

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

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

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

create whatsapp message templates

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

whatsapp message template builder with meta approval

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

meta template - start from a sample

  • 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. whatsapp template - template information
  • 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.

whatsapp template - header

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

whatsapp template - message body

  • Furthermore, similar to the header, you may add an optional Footer text for any supplementary text or disclaimers.

whatsapp template - footer

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

whatsapp template - buttons

  • Lastly, there’s an option to choose Carousel Card, which you can utilize to share product images, snapshots of your tool, or relevant illustrations.

whatsapp template - carousel

  • Once final, click the Generate Template button at the bottom of the page.

whatsapp template for meta approval

9.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 WhatsApp replies

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

Click on the Starter Packs to get started with prebuilt WhatsApp reply templates.

saved replies - starter packs

You can review which replies are performing well by analysing the frequency of the sends.

saved replies - analytics

9.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 WhatsApp 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 replies template

  • 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 replies template1

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

saved WhatsApp replies template2

  • Once done, click on the Create template button.

10.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 can monitor the growing customer base.

contact

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 - add contact

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

11.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 list

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

12.Campaigns

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

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

12.2.Send Messages

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

whatsapp campaigns - send campaigns

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.

whatsapp campaigns - send campaigns1

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

whatsapp campaigns - schedule campaigns

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

whatsapp campaigns - manage CSVs

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

whatsapp campaigns - manage CSVs - upload list

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

13.Messenger

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

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

14.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)

14.1.New Flow (Chatbot Builder)

chatbot flows - create chatflow

To create a new chat flow 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 - set 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 - assign action

  • Once done, click on the Save button.

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

chatbot flows - options

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

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 - subflow tab

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

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

17.HubSpot App Card

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

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

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

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

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

19.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 config

  • Billing: Find all the details related to your current plan (Active Status, Message Balance, Expiry, and No. of Accounts). This tab also allows you to explore the features available across different plans. There are three tiers in WhatsApp Connect pricing, alongside a custom plan for enterprise needs.

settings - billing

    • Free: Built for testing sends, campaigns, and desired initiatives with WhatsApp Business.
    • Starter ($25): Allows access to all the essentials for modern WhatsApp Business usage.
    • Growth ($49): Enables full-fledged access to all WhatsApp Connect features, including Advanced Analytics and API access.
    • Enterprise: Get a quote for a custom WhatsApp Connect tailored to your business needs.

Explore WhatsApp Connect pricing plans and discover how it aligns with your business requirements.

  • 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 - role

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

settings - role - new role

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

  • 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