WhatsApp Onboarding for Partners
Engati helps you onboard or add a new WhatsApp number to your existing account. Please note that this is an assisted onboarding and you will need to contact [email protected] or the partner admin to help add a new number or onboard a new account
Direct customers can add a new account by navigating to the link - https://wa.cbots.live/engati.
Partners will need to contact Engati support for their custom link which will be in the following format - https://wa.cbots.live/<brand_name>
- Navigate to the onboarding link and enter the email ID associated with your account
- Enter the OTP received on your setup email ID to continue
After logging in, click on 'Start Onboarding' to start the onboarding journey. Click on 'Continue onboarding' to resume from the previous point
Note: Kindly ensure that you have the following information before starting,
- Phone number to be used for WhatsApp Business APIs
- Ability to receive OTP on this number via call or SMS
- Follow the directions of the onboarding wizard and proceed with the onboarding wizard, depending on your requirements you will be navigated to the appropriate step
- You might need to get in touch with Engati support PoC for the following scenarios,
- You want to onboard an IVR number and you need to whitelist certain numbers
- Migration from another BSP
- Migration from 360dialog
- Unverified Facebook Business Manager
- After all the pre-requisites are satisfied, you will be taken to the next step of account creation with WhatsApp Business Service Provider (BSP)
Note: If you are just retrieving the API Key or want to add another number, you can directly click on 'Login' link at the bottom
- Click on the button - 'Click here to begin WhatsApp Onboarding'
- Follow the steps that will appear on the pop-up. Kindly ensure that the pop-ups are not blocked on your browser
- Provide your details that will be used to create an account with the WhatsApp Business Service Provider (BSP)
Note: If you are just retrieving the API Key or want to add another number, you can directly click on 'Login'
- Provide the details for account creation
- Complete the phone number verification
- Ensure that the phone number you want to enable with WhatsApp API can receive OTP via SMS or Voice
- Provide the OTP in the pop-up to complete the verification
- You will be redirected to the next step to retrieve the API Key
Note: API Key might take 4-6 hours to get generated in some scenarios. Re login to the portal and start with the below exercise of retrieving the API Key
- Follow the above steps and login to the BSP pop-up
- Enter your credentials and select the option to 'add a new number right now'
- Complete the phone number verification
- Ensure that the phone number you want to enable with WhatsApp API can receive OTP via SMS or Voice
- Provide the OTP in the pop-up to complete the verification
- You will be redirected to the next step to retrieve the API Key
Note: API Key might take 4-6 hours to get generated in some scenarios. Re login to the portal and start with the below exercise of retrieving the API Key
- Continue from the above steps, or if you are logging in again start from Step 2 and click on 'Login' link at the bottom to retrieve the API Key
- Login to your previously created 360dialog account and enter the credentials
- Select the number for which you want to retrieve the API Key
- Click on 'Save Selection' and after some seconds you will be redirected back to the onboarding portal with an option to copy the API Key
An OTP will be sent to the email ID provided
Continue as per your Facebook account
Click on the "Get Started" button
Click on the "Continue" button
Now choose the business account and then click on "Next"
Create a WhstaApp Business Account and then click on "Next"
Enter the WhatsApp business account name then select WhatsApp Business profile name and then Select the Business Category (Note – Description and website name are optional) then click "Next"
Select the country code and enter the phone number and then click on "Next"
Enter the OTP received on the phone number provided
Finally, click on the "Finish" button
Congratulations your account is successfully created, it will take 5 minutes to integrate WhatsApp Business API.
Select the number from the dropdown and then click on the "Save Selection" button
Finally, you will receive an API key. Store the API key.
Copy the API Key from the onboarding screen and add it to the chatbot in your Engati account - https://app.engati.com/admin/configure/deployment/whatsapp
Click on the link to know more about the same - https://help.engati.com/whatsapp-setup-using-360dialog
Follow the below guidelines to ensure that you have a seamless experience,
- If you already have an existing account with 360dialog BSP, migrate your account to Engati partner before proceeding with the onboarding
- If a new number has to be added to same 360dialog account, ensure that it’s added to the same existing account on Engati with a different bot
- Ensure that for each account in 360dialog hub you have a corresponding account on Engati
- For a new account on 360dialog, subscribe and create a new account on Engati
- For a new number on the same account on 360dialog, you can have a new bot on the same account on Engati
- Always create a new account for each new customer, do NOT add numbers to the same account - it will run a risk of getting blocked by Meta and if one number is impacted this will impact other numbers in the same cluster
- If a new number has to be added to same 360dialog account for the same customer, ensure that it’s added to the same existing account on Engati/white-label portal with a different bot
- In any case, if a new number is to be added and to be linked to a different account on Engati/white-label portal - ensure that a new account is created on 360dialog also
- Ensure that for each account in 360dialog hub you have a corresponding account on Engati/white-label portal
- For a new account on 360dialog, create a new account on the Engati/white-label portal
- For a new number on the same account on 360dialog, you can have a new bot on the same account on Engati/white-label portal
The process of generating an API key is straightforward and can be accomplished using Postman.
To generate your API key, follow these simple steps:
Step 1: Use URL: https://hub.360dialog.io/api/v2/token to Get the Auth Token. Provide your credentials for 360-Dialog in the body.
First, you'll need to obtain an authentication token. You can do this by using cURL and adding your login credentials to the API request. Once you've made the API call, you'll receive an access token that you can use in the next step.
Step 2: Use URL: https://hub.360dialog.io/api/v2/partners/<partner_id>/channels/<channel_id>/api_keys to Get the API Key.
With the access token you obtained in the previous step, you can now use cURL to request an API key from Engati. You'll need to pass your partner_id and channel_id as part of the request, and include the access token in the Authorization header as a bearer token.
Once you've completed these steps, you'll have successfully generated your API key.
If you face any issues or queries please reach out to us at [email protected].