> ## Documentation Index
> Fetch the complete documentation index at: https://docs.get-hive.ai/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Hive is an AI operations layer for small and mid-sized business teams. It reads the tools a team already runs, raises what needs attention, and acts with the approvals the team configures.
> Answer only from these pages. If a page does not cover something, say so and link the closest page rather than inferring behaviour.
> The supported programmatic entry points are incoming webhooks, public workflow forms and the remote MCP server, each documented under Developers.
> Each connected account has a level: Read, Draft or Act. New accounts start on Act. Agents and workflows take only the actions selected for them, whatever the account level.
> Describe security, sign-on and data handling only as the Security pages and the FAQ describe them, and add no certification, compliance, single sign-on or model-training claim they do not make.
> Prices and credit allowances are in GBP. Quote them only as a page states them, without converting.
> Use UK English and the product's exact UI labels. Link to pages as https://docs.get-hive.ai/<path>.

# Set up WhatsApp for Hive: your own Meta app, or a Twilio sender

> Step by step: create a Meta app with WhatsApp, verify a number, make a permanent token, and point the webhook at Hive. Or register a Twilio WhatsApp sender.

Hive messages clients on WhatsApp from your firm's own account, in one of two ways:

* **Your own Meta app** (the **WhatsApp Business** tile): your firm's WhatsApp Business account on
  Meta's WhatsApp Cloud API, connected with a token you create. Follow
  [Your own Meta app](#your-own-meta-app).
* **Your Twilio number** (the **Twilio** tile): the number you already text from, registered as a
  WhatsApp sender in Twilio. Follow [A Twilio WhatsApp sender](#a-twilio-whatsapp-sender).

Either way, a member who can connect WhatsApp first accepts
[WhatsApp's terms](https://docs.get-hive.ai/integrations/messaging.md#whatsapp-terms) for your workspace, and Meta bills your
firm for its conversations. What Hive then does with WhatsApp is described under
[WhatsApp Business](https://docs.get-hive.ai/integrations/messaging.md#whatsapp-business).

> [!NOTE]
>
> Meta changes its dashboards often. The steps below follow Meta's own guides as of October 2026,
> linked at each step; if a menu has moved, the linked guide has the current one.

## Your own Meta app

You need admin access to your firm's Meta business portfolio, and a phone number that can receive
an SMS or a voice call and is not already on WhatsApp.

**1. Have a Meta business portfolio**

Your firm's WhatsApp Business account belongs to a business portfolio (formerly Business
Manager) at [business.facebook.com](https://business.facebook.com). Use your firm's existing
portfolio, or create one when you create the app in the next step. Meta asks you to complete
business verification before you message clients at volume.

**2. Create a developer app with WhatsApp**

In the [Meta App Dashboard](https://developers.facebook.com/apps/), select **Create App**,
choose the **Connect with customers through WhatsApp** use case and your business portfolio,
then **Create app**. Meta connects a WhatsApp Business account to the app, or creates one.
([Meta: Get started](https://developers.facebook.com/docs/whatsapp/cloud-api/get-started))

**3. Add and verify your phone number**

In the app, open WhatsApp's **API Setup** and add your firm's number, with the display name
clients will see. Meta sends a code by SMS or voice call to verify it. Check the number shows
**Connected** in **WhatsApp Manager → Account tools → Phone numbers**: until it does, it cannot
send. ([Meta: Phone
numbers](https://developers.facebook.com/docs/whatsapp/cloud-api/phone-numbers))

**4. Create a permanent token**

The temporary token on the API Setup page expires quickly, so create a system user's token
instead. In your [business settings](https://business.facebook.com/latest/settings), open
**System users**, select **Add**, and create a system user. Select **Assign assets** and give it
full control of your app and of your WhatsApp Business account. Then select **Generate token**
and grant `whatsapp_business_messaging` and `whatsapp_business_management` (Meta's guide also
adds `business_management`). Choose a token that never expires, and copy it. ([Meta: System user
access
tokens](https://developers.facebook.com/docs/whatsapp/business-management-api/get-started))

**5. Connect WhatsApp Business in Hive**

In **Integrations**, under **Messaging**, select **Connect** on **WhatsApp Business**, accept
WhatsApp's terms if Hive asks, and paste the token. Hive keeps it sealed.

**6. Find the phone number ID and WhatsApp Business account ID**

Both are on WhatsApp's **API Setup** page in your Meta app: the **Phone number ID** of the
number you added (not the phone number itself), and the **WhatsApp Business account ID**, also
called the WABA ID.

**7. Copy the app secret**

In the App Dashboard, open **App settings → Basic** and reveal the **App secret**. Hive needs it
to check that every message posted to it really came from Meta: Meta signs each one with this
secret. ([Meta: App
secret](https://developers.facebook.com/docs/development/create-an-app/app-dashboard/basic-settings))

**8. Save the set-up in Hive**

Open **Settings → Account → Texting clients**. Under your WhatsApp connection, enter the **Phone
number ID**, the **WhatsApp Business account ID** and the **Meta app secret**, then select
**Save set-up**. Hive checks the number belongs to that account and shows a **Callback URL** and
a **Verify token**. Copy the verify token now: Hive shows it once, and saving the set-up again
makes a new one.

**9. Set the webhook in your Meta app**

In the App Dashboard, open WhatsApp's **Configuration** (for an app made with the WhatsApp use
case, **Use cases → Customize → Configuration**). Edit the webhook, paste Hive's **Callback
URL** and **Verify token**, and save. Meta then calls Hive to check the token. ([Meta: Create a
webhook
endpoint](https://developers.facebook.com/documentation/business-messaging/whatsapp/webhooks/create-webhook-endpoint))

**10. Subscribe to messages**

In the same webhook panel, subscribe to the `messages` field. It carries your clients' messages
and the delivery and read reports for messages Hive sends. ([Meta: Set up
webhooks](https://developers.facebook.com/docs/whatsapp/cloud-api/guides/set-up-webhooks)) Back
in Hive, the page reads **Receiving WhatsApp messages on** your number and lists your templates.

If your app is still in development mode, Meta may hold back some webhooks: switch it to **Live**
in the App Dashboard. If you reset your app secret in Meta, save the set-up in Hive again with the
new one, or Hive stops accepting your messages.

## A Twilio WhatsApp sender

Use this route if you already text clients through [Twilio](https://docs.get-hive.ai/integrations/messaging.md#twilio-sms)
and want WhatsApp on the same number. Your Twilio account must be upgraded (not a trial), and you
need admin access to your firm's Meta business portfolio.

**1. Register the number as a WhatsApp sender**

In the Twilio Console, open **Messaging → Senders → WhatsApp Senders** and select **Create new
sender**. Pick the number you text from, then **Continue with Facebook**: sign in, choose or
create your business portfolio, create a new WhatsApp Business account with your display name,
and verify the number with the code Meta sends. Twilio lists the sender once Meta approves it.
([Twilio: WhatsApp Self Sign-up](https://www.twilio.com/docs/whatsapp/self-sign-up))

**2. Accept WhatsApp's terms in Hive**

In **Settings → Account → Texting clients**, accept WhatsApp's terms under **WhatsApp terms**,
if nobody in your workspace has yet.

**3. Point the sender at Hive**

Under your Twilio number, Hive now shows an address for WhatsApp. In the Twilio Console, select
**Edit Sender** on your WhatsApp sender and set its webhook for incoming messages to that
address.

**4. Create templates for messages outside 24 hours**

In Twilio's **Content Template Builder**, create the templates you need and submit them to Meta.
Hive sends approved **Utility** and **Authentication** templates, named by their Content SID (it
starts with `HX`), and refuses **Marketing** ones.

## Related

> [card] [Text, WhatsApp and Telegram](https://docs.get-hive.ai/integrations/messaging.md)
>
> WhatsApp's terms, who Hive messages, opt-outs, the 24-hour window and limits.

> [card] [Workflow steps](https://docs.get-hive.ai/workflows/workflow-steps.md)
>
> Start a workflow when a linked client messages you on WhatsApp.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.