Skip to content

Before you start#

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

  1. Registration in the Console
  2. Create instance
  3. Get access parameters to instance
  4. Set receiving incoming data

1. Registration in the Console#

To use our service, go console 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.

2. Create an instance#

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

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

Steps to create an instance:

  1. In Console, 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.

3. 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 Console:

  • idInstance - account unique number
  • apiTokenInstance - account access key
  • apiUrl - URL address of the instance host

Account access key can be changed if necessary, for example, if it is compomised.

4. 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 GreenWaba, it is recommended to use the API section in the Console.