replyk.io
Help Center
WhatsApp Setup

WhatsApp Setup

Connect your WhatsApp Business account to enable the AI Agent.

Manual Meta Connection (Recommended)

The access token comes from a Meta Business System User, not from the WhatsApp API Setup page. System users generate permanent, never-expiring tokens.

1

Create a System User in Meta Business Portfolio

  1. Go to business.facebook.com → your Business Portfolio.
  2. Navigate to Settings → Users → System Users.
  3. Click + Add.
  4. Enter a name (e.g. replyk.io system user) and set 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 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 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 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 SettingsWhatsApp tab.
  2. Click Manual Connection.
  3. Enter your Access Token, App Secret, and WABA ID.
  4. Click Fetch Phone Numbers or enter 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 can find both the Callback URL and Verify Token in the Webhook Configuration section of your WhatsApp connection status panel. Use the copy buttons to copy them easily.

  1. In your Meta App, go to WhatsApp → Configuration → Webhooks.
  2. Set Callback URL to: https://replyk.io/api/whatsapp/webhook
  3. Set 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 using AES-256-GCM.

Facebook Embedded Signup (OAuth)

Use Meta's Embedded Signup to connect without manually entering credentials.

  1. In Business Settings → WhatsApp, click Connect with Facebook.
  2. A Facebook popup opens. Log in and select your WhatsApp Business Account.
  3. Select or create the phone number to use.
  4. Close the popup. Replyk exchanges the authorization code for an access token.
OAuth tokens expire after 60 days. You'll need to refresh periodically. Manual Connection is recommended for permanent tokens.

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