WhatsApp Integration

How to set up the WhatsApp integration?

1. Go to Meta for Developers Apps and Click "Create App" 

2. Fill in your app name, contact email, select "Business" as the app type, verify and then Click “Create App”.

3. Once created, add the "WhatsApp" product to your app.

4. Get Your Credentials

• Go to WhatsApp > API Setup in your app dashboard.
• Copy the Temporary Access Token (starts with "EAA...").
• Copy the WhatsApp Business Account ID (15-digit number, shown on the same page).

Note: The temporary access token expires after 24 hours. For production use, you must generate a permanent token. See the "How to get a permanent access token?" section below.

5. Go to the Integrations view and click on "New Integration"

6. Paste both values in the fields above - they will be validated automatically and your phone numbers will load. Then select your phone number -> save the integration.

How to get a permanent access token?

To prevent your integration from disconnecting after 24 hours, you need a token with proper permissions.

1) Create System User

• Go to Meta Business Settings > System Users.
• Click "Add" to create a new System User.
• Enter a name (e.g., "WhatsApp-Integration") and select the "Admin" role.
• Click "Create System User".

2) Assign WhatsApp Business Account

• Click on the System User you just created.
• Click "Add Assets" and select the "WhatsApp Accounts" tab.
• Find your WhatsApp Business Account and check it.
• Important: Select "Full control" (not "Partial access") and click "Save Changes".

3) Generate Token

• In the System User settings, click "Generate New Token".
• Select your WhatsApp Developer App from the dropdown.
• Check the following permissions:
  • whatsapp_business_management (required for templates and account info)
  • whatsapp_business_messaging (required for sending messages)
• Click "Generate Token".
• Important: Copy the token immediately and save it securely in Sprintful. You will not be able to see it again.

Read Meta's official documentation →

How to move to Production Mode?

To send messages to any customer phone number (not just test recipients), you need to complete Meta Business Verification.

1) Complete Meta Business Verification

• Go to Meta Business Settings → Security Center
• Click "Start Verification".
• Provide the required business information and submit for review (usually takes 1-3 business days).

2) Add a Payment Card

• Go to WhatsApp Account Settings
• Ensure you have selected a production (non-test) phone number.
• Find "Payment Settings" and add a payment card.

3) Request Higher Messaging Limits (Optional)

• Once verified, go to WhatsApp Manager → Phone Numbers
• Select your phone number to review your current messaging tier (starts at 1,000 messages/day). Limits increase automatically as you send quality messages.

Your WhatsApp Business Account is now in production mode. You can send messages to any phone number worldwide without adding them to an allowed list.

Read detailed verification guide →

How to create Message Templates?

You cannot send free-form messages to initiate a conversation; you must use approved templates.

1. Go to WhatsApp Manager → Message Templates
2. Click "Create Template".
3. Fill in template details (name, category, content with variables like {{1}}, {{2}}).
4. Submit for approval (usually takes 1-2 business days).

Once approved, you can use these templates in your booking page notifications.

How to use this integration in my booking pages?

After saving the integration settings:

1. Go to your booking page settings.
2. Click on the "Notifications" tab.
3. Add a new notification and select "WhatsApp" as the notification type.
4. Choose this integration and select an approved template.
5. Map template variables to booking information (e.g., Attendee Name, Date, Time).
6. Click "Save".

How much does it cost?

Pricing is determined directly by Meta. Please see Meta's pricing details for more information.

Troubleshooting

If you are having trouble sending messages, check the following:

• Templates not approved: Check the status of your templates in WhatsApp Manager.
• Expired Token: Temporary tokens expire after 24 hours. Ensure you have generated and saved a Permanent Token.
• Phone number not allowed: If you are still in Test Mode, recipient numbers must be added to the allowed list in WhatsApp API Setup.
• Incorrect phone format: Numbers must include the country code without the "+" sign (e.g., 14155551234 for US).
• Daily limit reached: Check your messaging limits in WhatsApp Manager.
• Account not verified: Ensure you have completed business verification in Meta Business Manager.