Use this article to troubleshoot common issues when using WhatsApp Business with Zapier. Find your problem below and follow the steps to fix it.
Setup and configuration
These issues relate to setting up your WhatsApp Business Account (WABA) and connecting it to Zapier.
Symptom
Your Zap fails or cannot send messages because the phone number you're using is not recognized as a valid WhatsApp Business number. You may notice this when testing a Send Template Message, Send Freeform Message, or Send Media Message action in the Zap editor.
Causes
- You're using a personal WhatsApp number instead of a WhatsApp Business Account (WABA) number.
- Your phone number is not registered through Meta Business Manager.
- The phone number is not in international format.
How to fix it
- Confirm that your phone number is registered as a WhatsApp Business number through Meta Business Manager. A personal WhatsApp number will not work with the WhatsApp Business integration on Zapier.
- Check that your number is in international format (for example,
+1for the US followed by the number, with no spaces or dashes). - In your WABA settings in Meta Business Manager, verify that your number shows as connected and active.
- If you need to register a new number, follow Meta's guide on adding a phone number to your WhatsApp Business Account.
Symptom
You receive an error referencing code #131037 when trying to send messages through the WhatsApp Business action in the Zap editor or in your Zap history. This error indicates that your WhatsApp Business display name has not been approved by Meta.
Causes
- Your WhatsApp Business Account display name is pending review or was rejected by Meta.
How to fix it
- Log into Meta Business Manager.
- Go to your WhatsApp Business Account settings.
- Check the status of your display name. If it shows as Pending or Rejected, follow Meta's display name guidelines to update it.
- Submit your display name for review if you have not already.
- Wait for Meta to approve your display name before sending messages.
Zapier cannot resolve display name issues on your behalf. This is a Meta-side requirement that must be managed through your WABA settings.
Message delivery
These issues relate to confirming whether messages sent through WhatsApp Business were delivered.
Symptom
Your Zap history shows successful runs for WhatsApp Business actions, but the recipient did not receive the message. This can happen with any WhatsApp Business action (Send Template Message, Send Freeform Message, or Send Media Message).
Causes
- WhatsApp Business Zap runs always appear as successful in Zap history, even when messages fail to deliver.
- The recipient's number may be incorrect or not a WhatsApp user.
- You tried to send a freeform or media message outside the 24-hour customer service window.
- Your message template was rejected or paused by Meta.
How to fix it
- Review your WhatsApp Business conversations in Meta Business Manager to confirm whether messages were delivered.
- Use the New Message Status Updated trigger to track message delivery status (sent, delivered, read, or failed) in a separate Zap.
- Verify that recipient numbers are in international format and belong to active WhatsApp users.
- If using Send Freeform Message or Send Media Message, confirm that the recipient messaged you within the past 24 hours. Use Send Template Message for messages outside this window.
Still need help?
If this article did not fix the issue:
- Ask in the Zapier Community. Get advice from experienced Zapier users.
- Learn more about getting help and support with Zapier.