Guide on how to add Gupshup WhatsApp Integration
Step 1. Account Setup
- If you do not have an account with Gupshup yet, you can create an account directly by signing up here or contact their support if you require an enterprise account.
- If you choose an enterprise account, their support team will help you with
the whole setup process. If you are using Gupshup’s self-serve portal, you
can integrate Gupshup before going live. Check their
FAQs for more details.
Below are the steps if you need to do once you decide to go live -
- You would need a verified Facebook Business Manager account. To create a FB Business Manager account, refer to the Facebook’s guide on creating a business manager account and then verify your account.
- You will need a unique phone number and a display name to be registered with WhatsApp.
- Fill your Business details in Gupshup. They will then create a WA business account with Facebook, which may take upto 7 days.
- Next, you need to approve Gupshup to send messages from your WhatsApp business account on behalf of your business. Check how to approve this request.
Step 2. Gupshup Integration in Raven
|For self-serve Gupshup WA account. API Key for your account.|
|For self-serve Gupshup WA account. App ID of the WhatsApp app created on the Gupshup dashboard.|
|Phone number with country code or name. The Sender should be approved from WhatsApp.|
|For enterprise Gupshup WA account only. Account number (user id) provided by Gupshup.|
|For enterprise Gupshup WA account only. Password provided by Gupshup for authentication of user id.|
Step 3. Delivery Reports
Follow the steps to setup delivery reports:
- On the Raven dashboard, once you successfully add the Gupshup Integration, you will see it in the “Live” tab. Go to the Live tab, and click on Gupshup WhatsApp. You will see a URL as Status Webhook, present in the integration. Copy this URL.
- Log in to Gupshup console. Go to App Settings to set the callback url. Paste the Status Webhook URL copied in Step 1. Check here for more details.
Raven supports sending both Session messaging (User initiated) and Template messaging (Business initiated). Support for handling incoming messages for session messaging is coming soon.
Step 4. Opt-ins
Raven handles the opt-ins with Gupshup internally. You can manage user preferences on your side.
You can control access by specifying Raven’s IP address, or make sure Raven’s IP addresses are whitelisted and not blocked.
IPs: 18.104.22.168, 22.214.171.124
If you are facing issues with this integration or find something missing, please write to us at firstname.lastname@example.org.