Receiving · GET

receiveNotification

Take the next incoming notification from the queue, waiting up to 25 seconds if it is empty (long polling). Use it when you cannot expose a webhook URL.

Endpoint

GET https://flowapi.pro/waInstance{idInstance}/receiveNotification/{apiTokenInstance}?receiveTimeout=10

Example

curl "https://flowapi.pro/waInstance{idInstance}/receiveNotification/{apiTokenInstance}?receiveTimeout=10"

Response

{
  "receiptId": 1234,
  "body": {
    "typeWebhook": "incomingMessageReceived",
    "senderData": {
      "chatId": "972501234567@c.us",
      "senderName": "Dana"
    },
    "messageData": {
      "typeMessage": "textMessage",
      "textMessageData": {
        "textMessage": "Hi!"
      }
    }
  }
}

Notes

Returns null when nothing arrived within receiveTimeout.
After processing, call deleteNotification with the receiptId or you will receive it again.

Green API compatible. receiveNotification uses the same name, request body and response as Green API, so existing code works after you change the host to flowapi.pro. Errors: 401 wrong instance or token, 402 trial ended or number not covered by your plan, 400 with a message for anything else.

More receiving methods

deleteNotification downloadFile

Try it on your own number

7 days free, no credit card. Then $10 per number per month.

Start free trial