replyk.io
Help Center
WhatsApp Setup

WhatsApp Setup

Connect your WhatsApp Business account to enable the AI Agent.

Video Tutorial: Connect WhatsApp with Meta Embedded Signup

Watch this step-by-step video guide to learn how to connect your WhatsApp Business account to Replyk in under 2 minutes using Meta's official Embedded Signup flow.

Official Meta Connection — Embedded Signup (Recommended)

The Official Meta Connection uses Meta's official Embedded Signup dialog. It automatically links your Meta Business Account, grants necessary permissions, configures webhooks, and connects your phone numbers in just a few clicks—no manual API key copy-pasting required.

Why choose Meta Embedded Signup? Fast 1-click setup, official Meta Cloud API authorization, automatic webhook configuration, and seamless multi-number selection for your workspace.
1

Start Connection in Replyk

  1. Go to Business Settings → WhatsApp tab in your Replyk dashboard.
  2. Click Connect with Facebook to launch Meta's secure Embedded Signup modal.
2

Log In & Authorize Meta Account

  1. Log in to the Facebook account associated with your Meta Business Portfolio.
  2. Review and confirm the permissions requested by Replyk (WhatsApp Business Management & Messaging).
3

Select or Create Business & WhatsApp Profile

  1. Select your existing Meta Business Portfolio or create a new one.
  2. Select your existing WhatsApp Business Account (WABA) or create a new profile.
4

Register & Verify Phone Number

  1. Select the phone number you wish to use for WhatsApp Business communications.
  2. If adding a new number, enter the 6-digit verification code sent by Meta via SMS or phone call.
5

Select Phone Numbers & Complete Setup

  1. After closing the Meta popup, Replyk displays all available phone numbers found on your WhatsApp account.
  2. Select the number(s) you want to activate for your business according to your plan limit, then click Connect.
  3. Replyk exchanges token credentials and sets up webhooks automatically. Your AI Sales Agent is now ready!

Manual Connection (Meta System User — Advanced)

The access token comes from a Meta Business system user, not from the WhatsApp API Setup page. System users issue permanent tokens that never expire.

1

Create a System User in Meta Business Portfolio

  1. Go to business.facebook.com → your business portfolio.
  2. Open Settings → Users → System users.
  3. Click + Add.
  4. Enter a name (e.g. replyk.io system user) and set the role to Employee.
  5. Click Create system user.
Create system user dialog
2

Assign App Assets to the System User

With the system user selected, click Add assets to grant access to your Meta app.

  1. Select the asset type: Apps.
  2. Select your Meta app from the list.
  3. Under Full control, enable Manage app.
  4. Click Assign assets.
Assign assets to system user
3

Generate a Permanent Access Token

Click the Generate token button on the system user's row.

Generate token button

3a. Select your Meta App

Choose your Meta app and click Next.

Select app for token

3b. Set Expiration to Never

Select Never so the token never expires.

Set token expiration to Never

3c. Assign Permissions

Select both WhatsApp permissions, then click Generate token:

  • whatsapp_business_management
  • whatsapp_business_messaging
Assign WhatsApp permissions

3d. Copy Your Token

Copy and save the token immediately. It will only be shown once.

Token created. Copy it
4

Get Remaining Credentials from Your Meta App

  1. WABA ID — In your Meta app dashboard, go to WhatsApp → API Setup. Find the WhatsApp Business Account ID.
  2. Phone Number ID — Listed under your phone numbers in the API Setup section.
  3. App Secret — Go to App Settings → Basic and copy the App Secret.
5

Connect in Replyk

  1. Go to Business Settings → WhatsApp tab.
  2. Click Manual Connection.
  3. Enter your Access Token, App Secret, and WABA ID.
  4. Click Fetch phone numbers or enter the Phone Number ID manually.
  5. Optionally enter your 6-digit PIN (if two-step verification is enabled).
  6. Click Connect WhatsApp.
6

Configure Webhook in Your Meta App

After connecting, Replyk automatically generates a unique verify token for your connection. You will find the callback URL and the verify token in the Webhook configuration section of your WhatsApp connection status panel — use the copy buttons to grab them.

  1. In your Meta App, go to WhatsApp → Configuration → Webhooks.
  2. Set the Callback URL to: https://replyk.io/api/whatsapp/webhook
  3. Set the Verify Token to the value shown in your Replyk dashboard under Webhook configuration.
  4. Subscribe to: messages and message_template_status_update.
Security: All credentials are encrypted at rest with AES-256-GCM.

Messaging Windows

24-Hour Customer Service Window, Free

Opens when a customer messages you. Send any message type for free while active.

72-Hour Free Entry Point Window

For conversations from Click-to-WhatsApp ads. Template messages only, but free for 72 hours.

Window Closed, Paid Templates Only

After windows expire, only pre-approved template messages can be sent. Meta charges per-message fees.

Still need help?

Our team replies within one business day. Tell us what you're stuck on and we'll guide you through it.

Contact support

Browse all help topics