Before you start
- A Meta business portfolio you can manage.
- A business app with WhatsApp enabled and a phone number registered for WhatsApp Cloud API.
- Access to that app and the WhatsApp business assets in the same portfolio.
In HeyRik, open Connections and select WhatsApp Business. Some workspaces have a dedicated WhatsApp page. If your provider is not listed, contact info@heyrik.com for help with availability.
Keep the HeyRik connection dialog open in your other tab. Copy credentials only into the matching fields; don’t send them in email or support messages.
Step 1
Find your WhatsApp Business Account ID
Open your Meta apps ↗- Sign in to Meta and open the business app that manages your WhatsApp number.
- Open WhatsApp → API Setup. In some dashboards, open the WhatsApp use case first.
- Copy the value labeled WhatsApp Business Account ID into the account ID field in HeyRik.
The account ID is not your phone number, Phone Number ID, or business portfolio ID. If several businesses are listed, choose the portfolio that owns this number.
Step 2
Create a system-user access token
A system user is a service account for your business automation. Use its token instead of the temporary token in API Setup.
Open Meta system users ↗- Select the correct business portfolio, then open Users → System users → Add. Give it a recognizable name, such as HeyRik WhatsApp.
- Assign assets to that system user: give it Manage app access to your app, and access to the WhatsApp account and its Messaging account if Meta lists both.
- Select Generate token and choose the same app. For token expiration, choose Never or Never expires if Meta offers it.
- Select business_management, whatsapp_business_management, and whatsapp_business_messaging. Generate the token and copy it into HeyRik’s Meta access token field.
Never means no scheduled expiry, not guaranteed permanent access: Meta can still revoke a token. Some businesses must use expiring tokens. If Meta only offers an expiring option, replace the token before it expires. HeyRik does not automatically renew manually supplied tokens.
Step 3
Connect your number in HeyRik
- Return to HeyRik and open the Meta WhatsApp Business connection. Enter the account ID and system-user access token.
- Choose Find my WhatsApp numbers. Select the business number returned by Meta, then connect it.
- For AI replies, open Incoming messages, AI replies & delivery updates and add the app secret from the same Meta app → App settings → Basic → App secret → Show. You can also add this when managing the connection.
- Open the connection’s webhook settings in HeyRik. Configure the callback URL and verification token in your Meta app’s WhatsApp configuration, then subscribe to messages.
- Choose a HeyRik agent for this number, check its knowledge and instructions, and enable replies.
The access token and app secret are different values. Keep both private. Approved templates are needed for messages outside the WhatsApp service window.
Common questions
Why can’t I see my app or the required permissions?
Check the selected business portfolio and the system user’s asset assignments. The app must be available to your business and assigned with Manage app access. Asset changes can take a few minutes. Your Meta account must have permission to manage these settings.
Why isn’t Never expires available?
Meta can require expiring system-user tokens for some businesses. HeyRik cannot remove that requirement. Use the expiry option Meta provides and replace the token before that date.
My number connects, but why does the bot not reply?
Check the app secret, the verified webhook and messages subscription, the assigned agent, its reply toggle and your available chat credits. Connecting a number alone does not enable a bot.
Can I use the temporary token from API Setup?
That token is intended for initial testing and expires quickly. For ongoing business automation, follow the system-user setup above.
Official provider references
Ready to connect?
Return to HeyRik, enter your details and connect the number. Assign an agent and enable replies when your setup is complete.
Back to Connections →