Green API (WhatsApp API) integration

The Green API integration gives you the ability to subscribe to a channel WhatsApp users as recipients. You can send text notifications, images, links and files from the source services to your colleagues and customers through the stable WhatsApp API gateway.

Subscribers will receive messages from your WhatsApp account linked to Green API. This will expand the possibilities, e.g. let you brand notifications and adapt the service to business needs.

! The integration is designed to send notifications to phone numbers other than the sender number connected to the Green API. If you set it to be sent to the original (your own) number, messages will still be delivered to WhatsApp, but without a pop-up / sound notification. WhatsApp will automatically mark such messages as read since the sender number and the recipient number are the same.

View detailed instructions on how to set up a Green API account for WhatsApp notifications >>

For everything to work, you need to pre-configure the integration and enable subscription in the properties of the desired channel.

If at least one of these items has not been configured, you will see the following message at the stage of subscribing to the channel:

0 Setting up integration - Configure Integration message.png

Step 1. Configure integration

  1. Go to the Integration screen. This can be done via the dropdown menu in the upper right corner of the screen. Make sure you are logged in to the system.
  2. 1 Add Notify.Events integration.png
  3. Click on the Create button.
  4. 2 Create new Notify.Events integration.png
  5. Click on the Green API card.
  6. 3 Choose Green API integration.png
  7. If necessary, edit the name of the integration, select API Version depending on your Green API plan: Base - for Free and Business , v1 - for ChatBot).
  8. Enter your Green API instance data to the IdInstance and ApiTokenInstance fields.
  9. Check the box next to Allow subscription over contact list if you want to be able to choose from the list of your WhatsApp contacts, including groups, at the subscription stage (Step 3).
  10. 5 Configure Green API integration.png

    To view Green API instance data, in your Green API console, go to Instances and drop down to the required instance.

    6 Green API instance data.png

    Not sure how to create A Green API account for WhatsApp notifications? Read the instructions below >>

  11. After clicking the Save button, the created integration will appear on the Integrations screen.
7 Created Green API integration.png

Step 2. Allow subscription

  1. Go to the channel properties via the Edit button on the main screen of the Control Panel or on the channel screen.
  2. 8 Edit Notify.Events channel.png
  3. Check the box next to Green API in the Allow subscription via integration field and click the Save button. Green API will be displayed in this field only after successfully completing Step 1.
9 Allow Green API integration.png

In the next step, you can add custom integration to the channel.

Step 3. Add the custom integration to the channel

After you have configured the Green API integration and allowed the subscription, you can add it to the selected channel as a recipient.

  1. On the channel screen, click the Subscribe button in the Recipients section.
  2. 10 Subscribe to Notify.Events channel.png
  3. On the Channel subscription screen, select Green API.
  4. 11 Choose Green API .png
  5. Enter the number you want to send notifications to or select a WhatsApp contact/group from the list (will be active if you have allowed this action in the Green API integration settings) and click Subscribe. To add more numbers, repeat the previous steps.
12 Add Green API number.png

That's it! The subscription will now appear in the Recipients section of the channel screen, and notifications from your source services will begin to reach connected WhatsApp users.

14 Added Green API recipient on the channel.png

Setting up Green API for WhatsApp notifications

How to create a Green API account?

  1. Register on the Green API website.
  2. 1. Create a Green API account.png
  3. Create a new instance using the Create Instance button in the upper right corner of the console.
  4. 2. Create a Green API instance.png
  5. Choose a plan.
  6. 3. Select a Green API plan.png
  7. Next, you will see the new instance screen. Here you will find data for configuring integration in Notify.Events: IdInstance and ApiTokenInstance.
4. Not authorized Green API instance.png

How to connect WhatsApp to Green API?

In order for the instance to work, you need to associate the Green API with WhatsApp. Until you do this, the status of the instance will show as "Unauthorized".

  1. Scroll the instance screen below and click the Get QR button.
  2. 5. Get a Green API QR.png
  3. Scan the generated QR code via WhatsApp on your smartphone: Settings > Linked devices > Link device.
  4. Now the status of the instance will change to “Authorized” and the connection with WhatsApp will start working.
6. Authorized Green API instance.png

You can change the instance settings on the same screen using the Edit button.


Congratulations, you have successfully connected Green API! Now you can go back to the top of the instructions and set up the integration to send notifications to WhatsApp.