Green API
Send WhatsApp messages, files, and interactive buttons via Green API (Russian WhatsApp BSP)
Green API is a Russian WhatsApp Business Solution Provider offering a REST API for sending messages, files, and interactive buttons. It supports individual WhatsApp number instances and is widely used in Russian e-commerce and customer service automation.
With the Green API integration in AACFlow, you can:
- Send messages: Deliver text messages to any WhatsApp number
- Send files: Share documents, images, and other files with recipients
- Send buttons: Send interactive button messages for guided conversations
- Get notifications: Poll incoming webhook notifications from the instance
- Check instance state: Verify the authorization and connection status of your WhatsApp instance
This integration enables automated WhatsApp messaging workflows for customer communications and notifications.
Usage Instructions
Integrate Green API into the workflow. Requires an Instance ID and API Token Instance from your Green API account at app.green-api.com.
Tools
green_api_send_message
Send a text message via WhatsApp
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
idInstance | string | Yes | Green API instance ID |
apiTokenInstance | string | Yes | Green API instance token |
chatId | string | Yes | Recipient chat ID (e.g. 79001234567@c.us) |
message | string | Yes | Text message to send |
Output
| Parameter | Type | Description |
|---|---|---|
idMessage | string | ID of the sent message |
success | boolean | Whether the message was sent |
green_api_send_file
Send a file via WhatsApp
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
idInstance | string | Yes | Green API instance ID |
apiTokenInstance | string | Yes | Green API instance token |
chatId | string | Yes | Recipient chat ID |
urlFile | string | Yes | URL of the file to send |
fileName | string | Yes | File name including extension |
caption | string | No | File caption |
Output
| Parameter | Type | Description |
|---|---|---|
idMessage | string | ID of the sent message |
success | boolean | Whether the file was sent |
green_api_send_buttons
Send an interactive buttons message
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
idInstance | string | Yes | Green API instance ID |
apiTokenInstance | string | Yes | Green API instance token |
chatId | string | Yes | Recipient chat ID |
message | string | Yes | Button message text |
footer | string | No | Footer text |
buttons | array | Yes | Array of button objects |
Output
| Parameter | Type | Description |
|---|---|---|
idMessage | string | ID of the sent message |
success | boolean | Whether the message was sent |
green_api_get_notifications
Poll incoming notifications from the instance
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
idInstance | string | Yes | Green API instance ID |
apiTokenInstance | string | Yes | Green API instance token |
receiveTimeout | number | No | Long poll timeout in seconds |
Output
| Parameter | Type | Description |
|---|---|---|
notifications | array | Array of notification objects |
receiptId | number | Receipt ID for deletion |
green_api_get_state_instance
Check the authorization state of the instance
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
idInstance | string | Yes | Green API instance ID |
apiTokenInstance | string | Yes | Green API instance token |
Output
| Parameter | Type | Description |
|---|---|---|
stateInstance | string | Instance state (authorized, notAuthorized, blocked, etc.) |
Links
- Official API: https://green-api.com/docs/api/
- AACFlow block source: apps/aacflow/blocks/blocks/green-api.ts