Communication

WhatsApp Business Cloud

19min
with whatsapp business cloud modules in make, you can watch events, send a message, and template messages upload and download media enable two step verification, register, verify, and deregister senders retrieve and update business profiles please note that it is not possible to use the phone number registered in the whatsapp business app or your personal whatsapp number, which you use for communicating with friends and family you will need a separate dedicated phone number for the api for more information, please refer to the could api documentation https //developers facebook com/docs/whatsapp/cloud api to get started with whatsapp business cloud, you need a facebook developer https //developers facebook com/ account a valid mobile phone number to connect whatsapp cloud api to make involves the following steps whatsapp business cloud docid\ zkgxpvewmioqhj7s9aafg whatsapp business cloud docid\ zkgxpvewmioqhj7s9aafg whatsapp business cloud docid\ zkgxpvewmioqhj7s9aafg youtube link here https //www youtube com/embed/bizl5speg4a set up whatsapp cloud api to set up whatsapp cloud api log in to your facebook account go to the facebook developer site https //developers facebook com/ , click my apps > create app select business as the app type click next enter the display name and select the business account click create app when prompted, re enter the password of your facebook account click submit the app is created on the app's dashboard, scroll down to find the whatsapp app, and click set up select the account type, and click continue copy the whatsapp business account id to a safe place create permanent access token to create a permanent access token for your whatsapp business cloud account log in to your facebook developer account https //developers facebook com/ click apps dashboard > business settings go to system users > add enter the username, select the role as admin and click create system user go to add assets > apps select the app you want to assign to the user, enable full control access, and click save changes go to whatsapp accounts > add people > select the system user > enable full control access > assign go to system users > select the user > generate access token select the app, following permissions, and then click generate token copy the token to a safe place you can use this token as a permanent access token add your own phone number to whatsapp business cloud api when you set up whatsapp api, a test number is created for you you can add your own number log in to your facebook developer account on the getting started page, click add phone number enter your business profile details and click next enter the business phone number that you want to connect to whatsapp business api enter the verification code received on your phone number enter your business details and click save you have successfully added your own business phone number to whatsapp business cloud api connect whatsapp business cloud to make to connect whatsapp business cloud with make you need to obtain the whatsapp business cloud docid\ zkgxpvewmioqhj7s9aafg and whatsapp business account id values from your whatsapp business cloud account in your facebook developer account log in to your make account, and add a module from the whatsapp business cloud app into a make make click add next to the connection field in the connection name field, enter a name for the connection in the permanent token field, enter the whatsapp business cloud docid\ zkgxpvewmioqhj7s9aafg created prior to the connection you can also use a temporary token which is only valid for 24 hours and available on the getting started screen in the whatsapp business account id field, enter the id from your facebook developer account > whatsapp > getting started section screen, and click save you have successfully connected the whatsapp business cloud app and can now build make message you can watch events, and send messages using the following modules watch events triggers when a new message is received webhook name enter a name for the webhook connection whatsapp business cloud docid\ zkgxpvewmioqhj7s9aafg verify token enter the temporary access token from the whatsapp getting started section or the whatsapp business cloud docid\ zkgxpvewmioqhj7s9aafg ensure that you use the same token for creating connections and webhooks events select or map the events which you do not wish to watch send a message sends a message you can send a message using this module if you satisfy the below conditions your business number phone number must be first approved by whatsapp before you use it for sending messages 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 if a customer contacts you first, then you can reply to the customer with this send a message module for the next 24 hours connection whatsapp business cloud docid\ zkgxpvewmioqhj7s9aafg sender id select or map the sender id from which you want to send the message receiver enter the receiver's whatsapp id or phone number if you are using a testing number you must whatsapp business cloud docid\ zkgxpvewmioqhj7s9aafg in the facebook developer console enter the receiver's phone number without any prefixes such as +, spaces, (), and for example, if the receiver phone number is +1 212 345 6789 , then you must enter it as 12123456789 if you are using your own phone number, the receiver field accepts both whatsapp id and a phone number in any dilable format with country code however, make recommends explicitly prefixing the country code with a plus sign (+) some of the examples of supported phone number formats are +1 212 345 6789 +1 (212) 345 6789 +1 212 345 6789 +1 (212) 345 6789 message type select the message type for example, image based on the selection, dynamic fields auto populate, and you need to enter the details to send the message for more details on these dynamic fields, see whatsapp business cloud messages api documentation for any errors, while sending the messages, see whatsapp business cloud docid\ zkgxpvewmioqhj7s9aafg send a template message your business phone number must be first approved by whatsapp before you use it for sending messages connection whatsapp business cloud docid\ zkgxpvewmioqhj7s9aafg sender id select or map the sender id from which you want to send the template message receiver enter the receiver's whatsapp id or phone number in any dialable format if you are using a testing number you must register the recipient's number in the facebook developer console enter the receiver's phone number without any prefixes such as +, spaces, (), and for example, if the receiver phone number is +1 212 345 6789 , then you must enter it as 12123456789 if you are using your own phone number, the receiver field accepts both whatsapp id and a phone number in any dilable format with country code however, make recommends explicitly prefixing the country code with a plus sign (+) some of the examples of supported phone number formats are +1 212 345 6789 +1 (212) 345 6789 +1 212 345 6789 +1 (212) 345 6789 message template select or map the message template you want to send media you can upload and download media using the following modules upload a media uploads a media and retrieves its id connection whatsapp business cloud docid\ zkgxpvewmioqhj7s9aafg sender id select or map the id of a sender whose media you want to upload file enter the file details file name enter the filename including the file extension for example, invoice xls data enter the path to the file stored in your local directory for example, "@/local/path/file jpg" for more information on supported media types, see the whatsapp business cloud documentation download a media downloads a media by its id connection whatsapp business cloud docid\ zkgxpvewmioqhj7s9aafg media id enter the media id you want to download phone number you can enable two step verification, register, verify, and deregister senders using the following modules enable two step verification activates the two step verification for a sender number by its id and a 6 digit pin connection whatsapp business cloud docid\ zkgxpvewmioqhj7s9aafg sender id select or map a sender id whose two step verification you want to enable pin enter (map) a 6 digit pin you wish to use for two step authentication to disable or reset two step verification, see the whatsapp business cloud documentation https //developers facebook com/docs/whatsapp/phone numbers#resetting verification code in whatsapp manager register a sender registers a sender by its id and a 6 digit pin connection whatsapp business cloud docid\ zkgxpvewmioqhj7s9aafg sender id select or map a sender id whom you want to register pin enter (map) a 6 digit pin you wish to use for registration to disable or reset two step verification, see the whatsapp business cloud documentation https //developers facebook com/docs/whatsapp/phone numbers#resetting verification code in whatsapp manager verify a sender verifies a sender by its id connection whatsapp business cloud docid\ zkgxpvewmioqhj7s9aafg sender id select or map a sender id whom you want to verify action select the action you want to perform to verify the sender request a code verify a code by select a method for receiving the code sms voice code enter (map) the code received to complete the verification deregister a sender deregisters a sender by its id connection whatsapp business cloud docid\ zkgxpvewmioqhj7s9aafg sender id select or map a sender id of a sender to deregister business profile you can retrieve and update business profiles using the following modules get a business profile retrieves the details of the whatsapp business profile by the sender id connection whatsapp business cloud docid\ zkgxpvewmioqhj7s9aafg sender id select or map the sender id whose business profile you want to retrieve update a business profile updates a whatsapp business profile by the sender id connection whatsapp business cloud docid\ zkgxpvewmioqhj7s9aafg sender id select or map the sender id whose business profile you want to update address enter the address of the business description enter the business details vertical select or map the industry of the business for example, finance email enter the contact email address of the business websites add the business website url address for example, a website, facebook page, or instagram you must include the http // or https // portion of the url file enter (map) the file details profile picture file name enter the file name of the profile picture profile picture data enter the path to the file stored in your local directory for example, "@/local/path/file jpg" setting up whatsapp business cloud webhooks log in to your make account open the watch events module, enter a name for the webhook, click save , and copy the url address to your clipboard click ok and save the trigger when prompted enter the callback url copied in step 1 and the verify token the verify token is the temporary access token or permanent access token but it has to be same in the make and whatsapp account for more information on webhooks, see the whatsapp business cloud documentation add recipient's phone number if you are using a testing number to send messages you must add the recipients to your whatsapp account in the facebook developer account you can add a maximum of five recipients' numbers that are enabled with whatsapp to add the recipient's phone number log in to your facebook developer account on the left menu, click whatsapp > to > manage phone number list add the phone number and click next enter the verification code received on your whatsapp and click next the recipient's number is successfully added to the list troubleshooting the whatsapp business cloud some of the errors that you might encounter when using whatsapp business cloud 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 if you’re using a testing number, you must first register up to five authorized recipient numbers in whatsapp manager before sending messages to them see whatsapp business cloud docid\ zkgxpvewmioqhj7s9aafg