Connect the WhatsApp Business API

Open Channels in LarkFlow. There are three buttons at the top — pick one:

1. 1

   Step 1: Start the signup

   In Channels, click Connect WhatsApp. A Meta window opens — allow pop-ups if your browser blocks it.

2. 2

   Step 2: Log in and choose your business

   Sign in with the Facebook account that manages your business, then pick (or create) your Meta Business account and WhatsApp Business Account.

3. 3

   Step 3: Add and verify your number

   Enter your phone number and display name, then confirm the code Meta sends by SMS or voice call.

4. 4

   Step 4: Finish

   When the window closes you’ll see WhatsApp connected! and the number appears in your channel list as Active. The webhook is set up automatically.

   If you see Signup incomplete, the Meta window was closed early — click Connect WhatsApp again.

Coexistence lets the same number work in the WhatsApp Business app and in LarkFlow.

1. 1

   Step 1: Update the app

   Make sure the WhatsApp Business app on your phone is up to date.

2. 2

   Step 2: Start Coexistence

   Click Connect via Coexistence and follow the Meta window. When asked, scan the QR code / confirm the link from the WhatsApp Business app on your phone.

3. 3

   Step 3: Confirm

   The channel shows a Coexistence badge in the list once it’s linked.

Use this if you manage your own app in Meta for Developers.

1. 1

   Step 1: Create a Meta app with WhatsApp

   In developers.facebook.com → My Apps → Create app, choose the Business type, then add the WhatsApp product and link your Meta Business account.

2. 2

   Step 2: Add your phone number

   In the app, go to WhatsApp → API Setup, add your business number and verify it.

3. 3

   Step 3: Create a permanent access token

   In Business Settings → Users → System users, add a system user (Admin), assign it your app and WhatsApp account, then Generate new token with the whatsapp_business_messaging and whatsapp_business_management permissions and expiry Never.

   Important: The temporary token shown on the API Setup page expires after 24 hours — don’t use it here, or messages will stop the next day.
4. 4

   Step 4: Fill in the form in LarkFlow

   Click Add manually and complete the fields:

   Field in LarkFlow	Where to find it
   Channel name	Any name for your team, e.g. “Main Support Line”.
   Phone number	Your number with country code, e.g. +971 50 123 4567.
   Phone Number ID	Meta app → WhatsApp → API Setup (under the “From” number).
   WhatsApp Business Account ID	Meta app → WhatsApp → API Setup, or Business Settings → Accounts → WhatsApp accounts.
   Permanent Access Token	The system-user token from step 3 (starts with EAA…).
   Meta App ID (optional)	Meta app → App settings → Basic.
   App Secret (optional)	Meta app → App settings → Basic → App secret. Recommended: LarkFlow then verifies every inbound webhook is really from Meta.

   Click save — you’ll see Channel connected.

Meta sends incoming messages to LarkFlow through a webhook. The signup and Coexistence methods do this for you; for Add manually you set it once in your Meta app.

1. 1

   Step 1: Copy the values from LarkFlow

   In Channels, the Meta Webhook Configuration box shows your Callback URL and Verify Token. Use the copy buttons.

   The Callback URL is https://www.larkflow.io/api/webhooks/whatsapp.

2. 2

   Step 2: Paste them into Meta

   In your Meta app go to WhatsApp → Configuration → Webhook → Edit, paste both values and click Verify and save.

3. 3

   Step 3: Subscribe to the right fields

   Under Webhook fields, subscribe to messages and message_template_status_update.

4. 4

   Step 4: Subscribe the number in LarkFlow

   Back in Channels, click Subscribe all channels (or use the channel’s menu) so Meta sends that number’s messages to LarkFlow.

1. 1

   Step 1: Test the webhook

   Click Test webhook. You should see Webhook verified.

2. 2

   Step 2: Send a real message

   From another phone, send a WhatsApp message to your business number. It should appear in Inbox within a few seconds.

3. 3

   Step 3: Reply from LarkFlow

   Reply from the Inbox. Free-form replies work within 24 hours of the customer’s last message; after that, Meta requires an approved template (see Templates).

“Webhook unreachable” or “Webhook test failed”

Check the Callback URL and Verify Token in Meta match LarkFlow exactly, with no trailing spaces, then click Verify and save in Meta again.

Messages don’t arrive in the Inbox

Make sure the messages field is subscribed in Meta and click Subscribe all channels. Check the channel is Active, not Paused.

Sending stopped after a day

You probably used Meta’s temporary token. Edit the channel and paste a permanent system-user token.

“Access Token is required” / “All fields except Meta App ID are required”

Fill every field marked with * in the Add manually form.

Can’t reply to a customer

More than 24 hours have passed since their last message. Send an approved template to reopen the conversation.