Questions? We are here to help!

Connect WhatsApp Cloud API through Meta

Connect an already registered WhatsApp Cloud API number to a HEDESU space using your Meta app credentials. After saving the connection, configure the webhook in Meta so HEDESU can receive updates.

Before you begin

Use the Admin role in the intended space. Your workspace plan must allow the channel, and the Meta option must be available in Connect Channel.

Have your Meta App ID, App secret, WhatsApp Business Account ID, Phone number ID and system-user access token ready. The token must have access to the intended WhatsApp Business Account for account management and messaging. The phone number must belong to that account and must not already belong to another HEDESU channel.

Complete number registration in Meta before following this guide. Refer to Meta's WhatsApp setup documentation for that separate process.

Connect the number

  1. Open the intended space, open its settings and select Channels.
  2. Select Connect Channel, then Connect on WhatsApp Cloud API · Meta.
  3. Enter a Channel name your team will recognize, up to 30 characters.
  4. Enter the App ID, WhatsApp Business Account ID and Phone number ID for the intended account and number.
  5. Enter the App secret and System-user access token.
  6. Select Verify and connect. Correct any validation message before continuing.

Configure the webhook

  1. In HEDESU, find Webhook configuration on the saved connection.
  2. In your Meta app's WhatsApp webhook configuration, enter the Callback URL and Verify token shown in HEDESU.
  3. Complete Meta's webhook verification and subscribe to messages. For template updates, also subscribe to the template update events listed in HEDESU.
  4. Return to HEDESU and select Check connection.
  5. Check that Webhook shows Verified and Meta connection shows Active. Also check that the Channel is active before using it.

The callback serves every number connected to the same Meta app. Check that the app is intended to send its updates to HEDESU before changing its webhook configuration.

If setup needs attention

If the phone number does not belong to the supplied account, check the account and phone number IDs. If it is already connected, open its existing HEDESU channel instead of creating another one.

If the webhook is awaiting verification, review the callback URL and verify token in Meta, complete verification, then check the connection again. For credential or provider errors, follow the displayed message and check the account access in Meta.

For later credential changes, activation and connection checks, see Update WhatsApp Channel. To prepare approved message content, see Create a WhatsApp template.