Before you start#

Before you start working with Green API you are required to follow the below steps:

1. Install the WhatsApp mobile application
2. Registration in the Your profile
3. Create and authorize an instance
4. Get access parameters to instance
5. Set receiving incoming data

Video instruction#

1. Install the WhatsApp mobile application#

Sending and receiving WhatsApp messages is done from your mobile phone. The phone must have the official WhatsApp or WhatsApp Business mobile app installed.

It is recommended to order Handset hosting service. In this case, a personal mobile phone is not required. Sending and receiving WhatsApp messages will be carried out from a mobile phone located in the Green API data center.

2. Registration in the Your profile#

To use our service, go to the Your profile and register. The registration process:

1. Enter your email address.

   We recommend using a corporate email to prevent the loss of account access in case an employee leaves.

2. Enter a password and confirm it. The password should be at least 6 characters long.

3. Select your country.
4. After accepting the user agreement, click on the Register button.
5. An email will be sent to your email address. Enter the code provided in the email to confirm your account.

3. Create and authorize an instance#

Instance Creation#

An instance is a unique gateway number for sending and receiving messages through WhatsApp.

Instances are created in your profile and are used for organizing the WhatsApp HTTP API.

Steps to create an instance:

1. In your profile, click on the Create an instance button.
2. Choose a tariff plan.
3. If required, select a payment method and make the payment.
4. Go to the list of instances by clicking on Instances in the side menu. You will see the instance you created in the list.

   One instance can simultaneously serve only one phone number (one WhatsApp account). You can create multiple instances under a single account.

Instance Authorization#

To work with the Green API, you need to authorize your instance. Instance authorization is done in the Your profile by scanning a QR code from the WhatsApp Business or WhatsApp mobile application.

Here's how to authorize an instance:

1. Open the WhatsApp Business or WhatsApp application on your mobile phone. On your device, go to the Link a device section. To do this:

   • On Android, tap on the three dots -> Linked Devices -> Link a device.
   • On iPhone, go to Settings -> Linked Devices -> Link a device.

2. In Your profile, select the desired instance.

3. Click the Get QR button. Scan the QR code using your mobile application.

   

More information on "How to set up device pairing" can be found in our article.
We also recommend reading the article "Why Can't I connect the device to the API?"

Sending and receiving messages are performed through your mobile phone. Therefore, your phone must always be charged and connected to the internet.

4. Get access parameters to instance#

To execute HTTP API WhatsApp requests, you need to use the access parameters to instance. Access parameters are published in Your profile:

• APIUrl - API host link
• MediaUrl - API host link for sending files
• idInstance - account unique number
• apiTokenInstance - account access key

Account access key can be changed if necessary, for example, if it is compomised. You can change the token in personal cabinet yourself or contact tech support.

5. Set receiving incoming data#

If you need to receive incoming data (incoming messages, previously sent messages statuses, etc.), then you have first to make account setup. You can get incoming webhooks via HTTP API or Webhook Endpoint.

Done!#

Everything is ready to start sending and receiving WhatsApp messages!

To debug requests to the Green API, it is recommended to use the API section in the your profile or the Postman collection. To simplify the integration process, you can use ready-made libraries available in the SDK section.