BoldDesk’s WhatsApp integration enables real-time customer communication directly within the helpdesk interface. However, message flow issues can occur due to configuration errors or account settings. This guide provides a structured approach to resolving these issues using BoldDesk workflows and settings.

Steps to Resolve WhatsApp Message Flow Issues in BoldDesk

1. Verify WhatsApp Phone Number
   Ensure that your phone number in the WhatsApp Business account is correctly registered and verified. This simple check often resolves many message flow issues.

2. Business and WhatsApp Account Verification
   Ensure that your Business and WhatsApp accounts are properly verified.

   

3. Check the Status of Your Phone Number

   • Go to WhatsApp Business Suite >> Business Portfolio >> Settings icon >> WhatsApp accounts >> WhatsApp Manager >> Phone numbers

   • Ensure your number is marked as connected.

     

4. Add a Payment Method
   Verify that a payment method is linked; if not, explore further instructions about How to Add a Payment Method in WhatsApp Cloud API Integration.

5. Webhook Configuration

   • Confirm that a valid webhook URL is set up within the meta information provided by BoldDesk, and ensure the messages and message_template_status_update webhook field subscriptions are enabled.

   • To ensure Webhook configurations: Log in to Meta Developer Portal > WhatsApp > Configuration

     
     
     
     

   • Explore further instruction about How to Configure WhatsApp Webhooks in Meta.

6. Generate a Permanent Access Token

   • Avoid potential disruptions in your WhatsApp messaging by using a Permanent access token. Temporary tokens will expire in 24 hours, leading to a disruption in your WhatsApp service.
   • Explore further instruction about How to Generate a Permanent WhatsApp Token.

Troubleshoot: No WhatsApp Conversation Created in BoldDesk (Meta Cloud API)

If inbound WhatsApp messages are received by Meta but no conversation appears in BoldDesk, BoldDesk is not receiving (or cannot process) webhook events for that phone number.

1. Confirm BoldDesk WhatsApp integration is configured

• In BoldDesk, go to Admin → Chat → WhatsApp → Meta Cloud API.
• Verify the WhatsApp integration is configured and the account is added.

BoldDesk generates a Webhook URL and Webhook Token during configuration. These must be configured in Meta.

2. Confirm the Meta webhook callback and verify token match BoldDesk

• In Meta Developer Portal, open your WhatsApp app and go to WhatsApp → Configuration.
• Set the Callback URL and Verify token using the values provided by BoldDesk.
• Under Webhook fields, enable subscriptions for:
  • messages
  • message_template_status_update

If these subscriptions are not enabled, Meta will not send inbound message events to BoldDesk.

3. Confirm your phone number is connected and active in WhatsApp Manager

• Go to WhatsApp Manager → Phone numbers.
• Verify the phone number you are testing is listed and shows a connected/active state.

4. Confirm a payment method is added

A payment method is required for WhatsApp Cloud API message send/receive.
If no payment method is attached, message delivery may not work as expected.

5. Use a permanent access token to prevent inbound/outbound disruptions

Temporary access tokens expire and can interrupt WhatsApp messaging.
Generate and use a permanent (system user) access token for the WhatsApp integration in BoldDesk.

6. Reconfigure if everything looks correct but no events arrive

If all settings are correct but BoldDesk still shows no conversations:

• Reconfigure the WhatsApp integration in BoldDesk.
• Re-verify webhook callback URL/token and webhook field subscriptions in Meta.
• Regenerate the access token (prefer permanent token).

Why WhatsApp (Meta) webhook stop working after changing the default brand URL

BoldDesk generates the WhatsApp Webhook URL and Token from the default brand URL. If the default brand URL changes, the webhook details change too, so Meta may still be using the old values. Steps for the fix below,

• Go to Admin → WhatsApp Integration.
• Click Reconfigure.
  
  
• In Step 2, copy the new Webhook URL and Token.
• Update them in Meta webhook settings.

Frequently Asked Questions

1. Why are WhatsApp messages not appearing in BoldDesk?
   WhatsApp message flow issues in BoldDesk usually happen due to configuration gaps or account readiness issues—for example: the phone number isn’t properly registered/verified, the WhatsApp Business account isn’t fully verified, webhook subscriptions are missing, or the access token has expired.

2. What should I check first to fix WhatsApp message flow problems?
   Start with these high-impact checks (they resolve most cases quickly):

   • Confirm the WhatsApp phone number is registered and verified in the WhatsApp Business account.
   • Confirm the Business and WhatsApp accounts are verified.
   • Confirm the phone number status is Connected in WhatsApp Manager (Business Portfolio → Settings → WhatsApp accounts → WhatsApp Manager → Phone numbers).

3. Which webhook subscriptions are required in Meta for BoldDesk WhatsApp message delivery?
   In the Meta Developer Portal (WhatsApp → Configuration), confirm the webhook URL is set correctly and that these webhook field subscriptions are enabled:

   • messages
   • message_template_status_update
     If these subscriptions are missing, inbound message events may not be delivered properly.

4. Why should I generate a permanent WhatsApp access token instead of using a temporary token?
   A temporary access token expires in 24 hours, which can cause WhatsApp message flow to stop unexpectedly. To prevent interruptions, generate and use a permanent access token so your WhatsApp service remains stable without frequent reconfiguration.

Related Articles

1. WhatsApp Business Integration in BoldDesk via Meta Cloud API
2. How to Set Up WhatsApp in Meta
3. How to Configure WhatsApp Webhooks in Meta
4. How to Generate a Permanent WhatsApp Token