WhatsApp Business Cloud troubleshooting
5 min
some of the errors that you might encounter when using whatsapp business cloud i get an error choosing 'connect a whatsapp business app' while establishing the connection in make select the connect a whatsapp business app option when docid\ gusgxhzpmkdyyjetseyv6 only if you are already have the whatsapp business app installed on your mobile phone if your phone number is not yet linked to the whatsapp business app on your device, choosing this option will result in an error i see a “number already connected” or similar error when choosing 'connect a whatsapp business app' while establishing the connection these errors may occur if the phone number you're trying to connect is already linked to another whatsapp business account or business portfolio how to fix it? open https //business facebook com/ check whether this phone number has already been connected under a different business portfolio or whatsapp account if it is connected, either use the correct portfolio, or remove the existing connection before attempting to connect it again in make i do not see my whatsapp business account in the dropdown list this usually happens because a whatsapp business account cannot be managed simultaneously by multiple 'partners' how to fix it? open https //business facebook com/ go to settings (gear icon) > accounts > whatsapp accounts select the relevant whatsapp business account in the users section in the left sidebar, click the partners tab if your whatsapp account is already connected to other chat platforms and you want to proceed with a make connection, click the three dots next to the partner, and select remove from business portfolio to disconnect it completely if the partner still appears in that list, click manage and remove the access the whatsapp account will stop working with that other platform once you remove the access return to make, and try to create the connection again if you still cannot see your whatsapp business account in the dropdown list after following the steps above, you may need to perform a phone number migration for more details, refer to the whatsapp business platform https //developers facebook com/documentation/business messaging/whatsapp/solution providers/support/migrating phone numbers among solution partners via embedded signup/ migrating your phone number to make as a solution partner means the phone number will no longer work on any other platforms where it is currently connected how to migrate your number? in the make connection flow, select the option create a whatsapp business account this will lead you to create a new whatsapp business account we strongly recommend using all the details of your existing whatsapp business account follow the dialog to add the phone number in question you will need to complete 2fa verification via text message or phone call you will receive a prompt confirming the migration follow the on screen instructions to complete the process if you complete the process but the connection is not created, it may be due to a timeout simply try the process again; it is usually much faster the second time what happens to my data? https //developers facebook com/documentation/business messaging/whatsapp/solution providers/support/migrating phone numbers among solution partners via embedded signup/ your business phone number, display name, quality rating, messaging limit, and official business account status are all preserved all eligible templates are automatically duplicated and granted the same statuses all media previously uploaded to your business phone number can continue to be used this account is not registered this error usually appears when the number you are trying to send a message from is not yet registered in the whatsapp cloud api how to fix it? use the register a sender module to register your number before sending a message once the number is registered, the send a message module will work as expected whatsapp api error 500 code 13100 the user gets an error 500 from the module, and the devtool > response body shows error code 131000 you can only initiate new chats via send a template module only after sending a templated message to a specific customer and receiving a response from the customer, you can use this send a message module to send a non templated message to the customer webhook not set up for phone number migration error \[400] \[100] (#100) invalid parameter cannot migrate phone number the whatsapp destination account must have webhooks set up this error occurs during a phone number migration if the destination whatsapp business account does not have an active webhook configuration meta requires an active webhook to facilitate the secure transfer of the number how to fix it in your make scenario, add a whatsapp business cloud > watch events module click create a webhook and follow the prompts to save it once the webhook is created, return to the connection/migration flow and retry the migration invalid blueprint / incompatible account while saving a scenario error invalid blueprint provided account is not compatible with the whatsapp business cloud\ sendmessage module this error typically occurs when you attempt to save a scenario containing a whatsapp business cloud module that is linked to an invalid or outdated connection it can also happen if the connection was updated but the individual modules in the scenario haven't acknowledged the change how to fix it? open the configuration of each whatsapp business cloud module in your scenario click the three dot menu (next to the connection field) and select refresh form ensure a valid connection is selected in the dropdown repeat these steps for every whatsapp module in the scenario save the scenario again payment method is missing on the whatsapp account error \[400] \[100] (#100) invalid parameter cannot migrate phone number your whatsapp business account does not have payment method set up this error occurs during a phone number migration when the destination whatsapp business account lacks a valid payment method even if you are within the free tier limits, meta requires billing information to be configured for the account to be fully active for migration how to fix it? log in to your https //business facebook com/ navigate to all tools > billing & payments ensure you have selected the correct business account in the dropdown menu under payment methods , click add payment method and follow the prompts to link a valid card or account once the payment method is successfully added, return to make and retry the migration operation after adding the payment method, it may take a few minutes for meta to update the status of your account if the error persists immediately, wait a short moment and try again two step verification blocks certificate creation error \[400] \[100] invalid parameter cannot create certificate please ensure two factor authentication is disabled this error occurs when attempting to create a connection or migrate a number that still has two step verification enabled within the whatsapp settings this security layer prevents make from generating the necessary security certificate to manage your messages how to fix it? log in to your https //business facebook com/ go to all tools > whatsapp manager in the left sidebar, click phone numbers find the phone number you are trying to connect and click the settings (gear icon) in the tools column select two step verification click disable two step verification an email will be sent to the administrator to confirm this action once disabled, return to make and rerun the connection or migration step account not registered error \[400] \[133010] (#133010) account not registered this error occurs when a phone number has been added to your facebook business portfolio but hasn't been officially registered as a sender on the whatsapp business platform the number is known to meta but is not yet active for sending or receiving messages through make how to fix it? in your make scenario, add the whatsapp business cloud > register a sender module select the connection and the phone number id you are trying to use provide a pin if you don't have an existing pin, you can create a new one run the module once manually after the module runs successfully, your number is fully registered you can now delete the register a sender module and retry your original workflow