Webhooks

Received Webhooks
35 webhooks

Type: incomingMessageReceived
Timestamp: 2026-02-09T10:32:15.279991
Message Data:
{
  "fileMessageData": {
    "fileName": "report.pdf"
  },
  "idMessage": "MSG_DOC_001",
  "typeMessage": "documentMessage"
}
Full Webhook Data:
{
  "instanceData": {
    "idInstance": 7103508593
  },
  "messageData": {
    "fileMessageData": {
      "fileName": "report.pdf"
    },
    "idMessage": "MSG_DOC_001",
    "typeMessage": "documentMessage"
  },
  "receiptId": 10013,
  "senderData": {
    "chatId": "1313131313@c.us",
    "sender": "1313131313@c.us",
    "senderContactName": "Doc Sender"
  },
  "timestamp": 1234567902,
  "typeWebhook": "incomingMessageReceived"
}

Type: incomingMessageReceived
Timestamp: 2026-02-09T10:32:15.112408
Message Data:
{
  "fileMessageData": {
    "caption": "Check out this video!"
  },
  "idMessage": "MSG_VIDEO_001",
  "typeMessage": "videoMessage"
}
Full Webhook Data:
{
  "instanceData": {
    "idInstance": 7103508593
  },
  "messageData": {
    "fileMessageData": {
      "caption": "Check out this video!"
    },
    "idMessage": "MSG_VIDEO_001",
    "typeMessage": "videoMessage"
  },
  "receiptId": 10012,
  "senderData": {
    "chatId": "1212121212@c.us",
    "sender": "1212121212@c.us",
    "senderContactName": "Video Sender"
  },
  "timestamp": 1234567901,
  "typeWebhook": "incomingMessageReceived"
}

Type: incomingMessageReceived
Timestamp: 2026-02-09T10:32:15
Message Data:
{
  "fileMessageData": {
    "caption": "Check out this video!"
  },
  "idMessage": "MSG_VIDEO_001",
  "typeMessage": "videoMessage"
}
Full Webhook Data:
{
  "instanceData": {
    "idInstance": 7103508593
  },
  "messageData": {
    "fileMessageData": {
      "caption": "Check out this video!"
    },
    "idMessage": "MSG_VIDEO_001",
    "typeMessage": "videoMessage"
  },
  "receiptId": 10012,
  "senderData": {
    "chatId": "1212121212@c.us",
    "sender": "1212121212@c.us",
    "senderContactName": "Video Sender"
  },
  "timestamp": 1234567901,
  "typeWebhook": "incomingMessageReceived"
}

Type: incomingMessageReceived
Timestamp: 2026-02-09T10:32:15
Message Data:
{
  "fileMessageData": {
    "fileName": "report.pdf"
  },
  "idMessage": "MSG_DOC_001",
  "typeMessage": "documentMessage"
}
Full Webhook Data:
{
  "instanceData": {
    "idInstance": 7103508593
  },
  "messageData": {
    "fileMessageData": {
      "fileName": "report.pdf"
    },
    "idMessage": "MSG_DOC_001",
    "typeMessage": "documentMessage"
  },
  "receiptId": 10013,
  "senderData": {
    "chatId": "1313131313@c.us",
    "sender": "1313131313@c.us",
    "senderContactName": "Doc Sender"
  },
  "timestamp": 1234567902,
  "typeWebhook": "incomingMessageReceived"
}

Type: incomingCall
Timestamp: 2026-02-09T10:32:14.925758
Full Webhook Data:
{
  "callData": {
    "from": "1010101010@c.us",
    "status": "ringing"
  },
  "instanceData": {
    "idInstance": 7103508593
  },
  "receiptId": 10011,
  "timestamp": 1234567900,
  "typeWebhook": "incomingCall"
}

Type: pollMessage
Timestamp: 2026-02-09T10:32:14.617931
Message Data:
{
  "idMessage": "MSG_POLL_001",
  "pollMessageData": {
    "name": "What is your favorite color?"
  },
  "typeMessage": "pollMessage"
}
Full Webhook Data:
{
  "instanceData": {
    "idInstance": 7103508593
  },
  "messageData": {
    "idMessage": "MSG_POLL_001",
    "pollMessageData": {
      "name": "What is your favorite color?"
    },
    "typeMessage": "pollMessage"
  },
  "receiptId": 10010,
  "senderData": {
    "chatId": "9999999999@c.us",
    "sender": "9999999999@c.us",
    "senderContactName": "Poll Creator"
  },
  "timestamp": 1234567899,
  "typeWebhook": "pollMessage"
}

Type: incomingBlock
Timestamp: 2026-02-09T10:32:14.510127
Full Webhook Data:
{
  "chatId": "8888888888@c.us",
  "instanceData": {
    "idInstance": 7103508593
  },
  "reason": "spam",
  "receiptId": 10009,
  "timestamp": 1234567898,
  "typeWebhook": "incomingBlock"
}

Type: stateInstanceChanged
Timestamp: 2026-02-09T10:32:14.380647
Full Webhook Data:
{
  "instanceData": {
    "idInstance": 7103508593
  },
  "receiptId": 10008,
  "stateInstance": "authorized",
  "timestamp": 1234567897,
  "typeWebhook": "stateInstanceChanged"
}

Type: messageEdited
Timestamp: 2026-02-09T10:32:14.280117
Message Data:
{
  "idMessage": "MSG_EDITED_001",
  "textMessageData": {
    "textMessage": "This message was edited"
  }
}
Full Webhook Data:
{
  "chatId": "7777777777@c.us",
  "instanceData": {
    "idInstance": 7103508593
  },
  "messageData": {
    "idMessage": "MSG_EDITED_001",
    "textMessageData": {
      "textMessage": "This message was edited"
    }
  },
  "receiptId": 10007,
  "timestamp": 1234567896,
  "typeWebhook": "messageEdited"
}

Type: messageDeleted
Timestamp: 2026-02-09T10:32:14.123374
Message Data:
{
  "idMessage": "MSG_DELETED_001"
}
Full Webhook Data:
{
  "chatId": "6666666666@c.us",
  "instanceData": {
    "idInstance": 7103508593
  },
  "messageData": {
    "idMessage": "MSG_DELETED_001"
  },
  "receiptId": 10006,
  "timestamp": 1234567895,
  "typeWebhook": "messageDeleted"
}

Type: messageDeleted
Timestamp: 2026-02-09T10:32:14
Message Data:
{
  "idMessage": "MSG_DELETED_001"
}
Full Webhook Data:
{
  "chatId": "6666666666@c.us",
  "instanceData": {
    "idInstance": 7103508593
  },
  "messageData": {
    "idMessage": "MSG_DELETED_001"
  },
  "receiptId": 10006,
  "timestamp": 1234567895,
  "typeWebhook": "messageDeleted"
}

Type: messageEdited
Timestamp: 2026-02-09T10:32:14
Message Data:
{
  "idMessage": "MSG_EDITED_001",
  "textMessageData": {
    "textMessage": "This message was edited"
  }
}
Full Webhook Data:
{
  "chatId": "7777777777@c.us",
  "instanceData": {
    "idInstance": 7103508593
  },
  "messageData": {
    "idMessage": "MSG_EDITED_001",
    "textMessageData": {
      "textMessage": "This message was edited"
    }
  },
  "receiptId": 10007,
  "timestamp": 1234567896,
  "typeWebhook": "messageEdited"
}

Type: stateInstanceChanged
Timestamp: 2026-02-09T10:32:14
Full Webhook Data:
{
  "instanceData": {
    "idInstance": 7103508593
  },
  "receiptId": 10008,
  "stateInstance": "authorized",
  "timestamp": 1234567897,
  "typeWebhook": "stateInstanceChanged"
}

Type: incomingBlock
Timestamp: 2026-02-09T10:32:14
Full Webhook Data:
{
  "chatId": "8888888888@c.us",
  "instanceData": {
    "idInstance": 7103508593
  },
  "reason": "spam",
  "receiptId": 10009,
  "timestamp": 1234567898,
  "typeWebhook": "incomingBlock"
}

Type: pollMessage
Timestamp: 2026-02-09T10:32:14
Message Data:
{
  "idMessage": "MSG_POLL_001",
  "pollMessageData": {
    "name": "What is your favorite color?"
  },
  "typeMessage": "pollMessage"
}
Full Webhook Data:
{
  "instanceData": {
    "idInstance": 7103508593
  },
  "messageData": {
    "idMessage": "MSG_POLL_001",
    "pollMessageData": {
      "name": "What is your favorite color?"
    },
    "typeMessage": "pollMessage"
  },
  "receiptId": 10010,
  "senderData": {
    "chatId": "9999999999@c.us",
    "sender": "9999999999@c.us",
    "senderContactName": "Poll Creator"
  },
  "timestamp": 1234567899,
  "typeWebhook": "pollMessage"
}

Type: incomingCall
Timestamp: 2026-02-09T10:32:14
Full Webhook Data:
{
  "callData": {
    "from": "1010101010@c.us",
    "status": "ringing"
  },
  "instanceData": {
    "idInstance": 7103508593
  },
  "receiptId": 10011,
  "timestamp": 1234567900,
  "typeWebhook": "incomingCall"
}

Type: outgoingMessageStatus
Timestamp: 2026-02-09T10:32:13.979555
Full Webhook Data:
{
  "chatId": "5555555555@c.us",
  "idMessage": "MSG_STATUS_001",
  "instanceData": {
    "idInstance": 7103508593
  },
  "receiptId": 10005,
  "status": "read",
  "timestamp": 1234567894,
  "typeWebhook": "outgoingMessageStatus"
}

Type: outgoingAPIMessageReceived
Timestamp: 2026-02-09T10:32:13.872510
Message Data:
{
  "chatId": "4444444444@c.us",
  "idMessage": "MSG_API_001",
  "textMessageData": {
    "textMessage": "Message sent via API"
  },
  "typeMessage": "textMessage"
}
Full Webhook Data:
{
  "instanceData": {
    "idInstance": 7103508593
  },
  "messageData": {
    "chatId": "4444444444@c.us",
    "idMessage": "MSG_API_001",
    "textMessageData": {
      "textMessage": "Message sent via API"
    },
    "typeMessage": "textMessage"
  },
  "receiptId": 10004,
  "timestamp": 1234567893,
  "typeWebhook": "outgoingAPIMessageReceived"
}

Type: outgoingMessageReceived
Timestamp: 2026-02-09T10:32:13.686843
Message Data:
{
  "chatId": "3333333333@c.us",
  "idMessage": "MSG_OUT_001",
  "textMessageData": {
    "textMessage": "Message sent from my phone"
  },
  "typeMessage": "textMessage"
}
Full Webhook Data:
{
  "instanceData": {
    "idInstance": 7103508593
  },
  "messageData": {
    "chatId": "3333333333@c.us",
    "idMessage": "MSG_OUT_001",
    "textMessageData": {
      "textMessage": "Message sent from my phone"
    },
    "typeMessage": "textMessage"
  },
  "receiptId": 10003,
  "timestamp": 1234567892,
  "typeWebhook": "outgoingMessageReceived"
}

Type: incomingMessageReceived
Timestamp: 2026-02-09T10:32:13.591073
Message Data:
{
  "fileMessageData": {
    "caption": "Check out this image!"
  },
  "idMessage": "MSG_IMAGE_001",
  "typeMessage": "imageMessage"
}
Full Webhook Data:
{
  "instanceData": {
    "idInstance": 7103508593
  },
  "messageData": {
    "fileMessageData": {
      "caption": "Check out this image!"
    },
    "idMessage": "MSG_IMAGE_001",
    "typeMessage": "imageMessage"
  },
  "receiptId": 10002,
  "senderData": {
    "chatId": "2222222222@c.us",
    "sender": "2222222222@c.us",
    "senderContactName": "Test User 2"
  },
  "timestamp": 1234567891,
  "typeWebhook": "incomingMessageReceived"
}

Type: incomingMessageReceived
Timestamp: 2026-02-09T10:32:13.437681
Message Data:
{
  "idMessage": "MSG_TEXT_001",
  "textMessageData": {
    "textMessage": "Hello, this is a test text message!"
  },
  "typeMessage": "textMessage"
}
Full Webhook Data:
{
  "instanceData": {
    "idInstance": 7103508593
  },
  "messageData": {
    "idMessage": "MSG_TEXT_001",
    "textMessageData": {
      "textMessage": "Hello, this is a test text message!"
    },
    "typeMessage": "textMessage"
  },
  "receiptId": 10001,
  "senderData": {
    "chatId": "1111111111@c.us",
    "sender": "1111111111@c.us",
    "senderContactName": "Test User 1"
  },
  "timestamp": 1234567890,
  "typeWebhook": "incomingMessageReceived"
}

Type: incomingMessageReceived
Timestamp: 2026-02-09T10:32:13
Message Data:
{
  "idMessage": "MSG_TEXT_001",
  "textMessageData": {
    "textMessage": "Hello, this is a test text message!"
  },
  "typeMessage": "textMessage"
}
Full Webhook Data:
{
  "instanceData": {
    "idInstance": 7103508593
  },
  "messageData": {
    "idMessage": "MSG_TEXT_001",
    "textMessageData": {
      "textMessage": "Hello, this is a test text message!"
    },
    "typeMessage": "textMessage"
  },
  "receiptId": 10001,
  "senderData": {
    "chatId": "1111111111@c.us",
    "sender": "1111111111@c.us",
    "senderContactName": "Test User 1"
  },
  "timestamp": 1234567890,
  "typeWebhook": "incomingMessageReceived"
}

Type: incomingMessageReceived
Timestamp: 2026-02-09T10:32:13
Message Data:
{
  "fileMessageData": {
    "caption": "Check out this image!"
  },
  "idMessage": "MSG_IMAGE_001",
  "typeMessage": "imageMessage"
}
Full Webhook Data:
{
  "instanceData": {
    "idInstance": 7103508593
  },
  "messageData": {
    "fileMessageData": {
      "caption": "Check out this image!"
    },
    "idMessage": "MSG_IMAGE_001",
    "typeMessage": "imageMessage"
  },
  "receiptId": 10002,
  "senderData": {
    "chatId": "2222222222@c.us",
    "sender": "2222222222@c.us",
    "senderContactName": "Test User 2"
  },
  "timestamp": 1234567891,
  "typeWebhook": "incomingMessageReceived"
}

Type: outgoingMessageReceived
Timestamp: 2026-02-09T10:32:13
Message Data:
{
  "chatId": "3333333333@c.us",
  "idMessage": "MSG_OUT_001",
  "textMessageData": {
    "textMessage": "Message sent from my phone"
  },
  "typeMessage": "textMessage"
}
Full Webhook Data:
{
  "instanceData": {
    "idInstance": 7103508593
  },
  "messageData": {
    "chatId": "3333333333@c.us",
    "idMessage": "MSG_OUT_001",
    "textMessageData": {
      "textMessage": "Message sent from my phone"
    },
    "typeMessage": "textMessage"
  },
  "receiptId": 10003,
  "timestamp": 1234567892,
  "typeWebhook": "outgoingMessageReceived"
}

Type: outgoingAPIMessageReceived
Timestamp: 2026-02-09T10:32:13
Message Data:
{
  "chatId": "4444444444@c.us",
  "idMessage": "MSG_API_001",
  "textMessageData": {
    "textMessage": "Message sent via API"
  },
  "typeMessage": "textMessage"
}
Full Webhook Data:
{
  "instanceData": {
    "idInstance": 7103508593
  },
  "messageData": {
    "chatId": "4444444444@c.us",
    "idMessage": "MSG_API_001",
    "textMessageData": {
      "textMessage": "Message sent via API"
    },
    "typeMessage": "textMessage"
  },
  "receiptId": 10004,
  "timestamp": 1234567893,
  "typeWebhook": "outgoingAPIMessageReceived"
}

Type: outgoingMessageStatus
Timestamp: 2026-02-09T10:32:13
Full Webhook Data:
{
  "chatId": "5555555555@c.us",
  "idMessage": "MSG_STATUS_001",
  "instanceData": {
    "idInstance": 7103508593
  },
  "receiptId": 10005,
  "status": "read",
  "timestamp": 1234567894,
  "typeWebhook": "outgoingMessageStatus"
}

Type: messageEdited
Timestamp: 2026-02-09T10:31:22.967888
Message Data:
{
  "idMessage": "MSG_EDITED_001",
  "textMessageData": {
    "textMessage": "This message was edited"
  }
}
Full Webhook Data:
{
  "chatId": "7777777777@c.us",
  "instanceData": {
    "idInstance": 7103508593
  },
  "messageData": {
    "idMessage": "MSG_EDITED_001",
    "textMessageData": {
      "textMessage": "This message was edited"
    }
  },
  "receiptId": 10007,
  "timestamp": 1234567896,
  "typeWebhook": "messageEdited"
}

Type: messageDeleted
Timestamp: 2026-02-09T10:31:22.491783
Message Data:
{
  "idMessage": "MSG_DELETED_001"
}
Full Webhook Data:
{
  "chatId": "6666666666@c.us",
  "instanceData": {
    "idInstance": 7103508593
  },
  "messageData": {
    "idMessage": "MSG_DELETED_001"
  },
  "receiptId": 10006,
  "timestamp": 1234567895,
  "typeWebhook": "messageDeleted"
}

Type: outgoingMessageStatus
Timestamp: 2026-02-09T10:31:22.335618
Full Webhook Data:
{
  "chatId": "5555555555@c.us",
  "idMessage": "MSG_STATUS_001",
  "instanceData": {
    "idInstance": 7103508593
  },
  "receiptId": 10005,
  "status": "read",
  "timestamp": 1234567894,
  "typeWebhook": "outgoingMessageStatus"
}

Type: outgoingAPIMessageReceived
Timestamp: 2026-02-09T10:31:22.056923
Message Data:
{
  "chatId": "4444444444@c.us",
  "idMessage": "MSG_API_001",
  "textMessageData": {
    "textMessage": "Message sent via API"
  },
  "typeMessage": "textMessage"
}
Full Webhook Data:
{
  "instanceData": {
    "idInstance": 7103508593
  },
  "messageData": {
    "chatId": "4444444444@c.us",
    "idMessage": "MSG_API_001",
    "textMessageData": {
      "textMessage": "Message sent via API"
    },
    "typeMessage": "textMessage"
  },
  "receiptId": 10004,
  "timestamp": 1234567893,
  "typeWebhook": "outgoingAPIMessageReceived"
}

Type: outgoingMessageReceived
Timestamp: 2026-02-09T10:31:21.897086
Message Data:
{
  "chatId": "3333333333@c.us",
  "idMessage": "MSG_OUT_001",
  "textMessageData": {
    "textMessage": "Message sent from my phone"
  },
  "typeMessage": "textMessage"
}
Full Webhook Data:
{
  "instanceData": {
    "idInstance": 7103508593
  },
  "messageData": {
    "chatId": "3333333333@c.us",
    "idMessage": "MSG_OUT_001",
    "textMessageData": {
      "textMessage": "Message sent from my phone"
    },
    "typeMessage": "textMessage"
  },
  "receiptId": 10003,
  "timestamp": 1234567892,
  "typeWebhook": "outgoingMessageReceived"
}

Type: incomingMessageReceived
Timestamp: 2026-02-09T10:31:21.545416
Message Data:
{
  "fileMessageData": {
    "caption": "Check out this image!"
  },
  "idMessage": "MSG_IMAGE_001",
  "typeMessage": "imageMessage"
}
Full Webhook Data:
{
  "instanceData": {
    "idInstance": 7103508593
  },
  "messageData": {
    "fileMessageData": {
      "caption": "Check out this image!"
    },
    "idMessage": "MSG_IMAGE_001",
    "typeMessage": "imageMessage"
  },
  "receiptId": 10002,
  "senderData": {
    "chatId": "2222222222@c.us",
    "sender": "2222222222@c.us",
    "senderContactName": "Test User 2"
  },
  "timestamp": 1234567891,
  "typeWebhook": "incomingMessageReceived"
}

Type: incomingMessageReceived
Timestamp: 2026-02-09T10:31:21.342273
Message Data:
{
  "idMessage": "MSG_TEXT_001",
  "textMessageData": {
    "textMessage": "Hello, this is a test text message!"
  },
  "typeMessage": "textMessage"
}
Full Webhook Data:
{
  "instanceData": {
    "idInstance": 7103508593
  },
  "messageData": {
    "idMessage": "MSG_TEXT_001",
    "textMessageData": {
      "textMessage": "Hello, this is a test text message!"
    },
    "typeMessage": "textMessage"
  },
  "receiptId": 10001,
  "senderData": {
    "chatId": "1111111111@c.us",
    "sender": "1111111111@c.us",
    "senderContactName": "Test User 1"
  },
  "timestamp": 1234567890,
  "typeWebhook": "incomingMessageReceived"
}

Type: incomingMessageReceived
Timestamp: 2026-02-09T10:26:49
Message Data:
{
  "idMessage": "AUTH_SUCCESS_123",
  "textMessageData": {
    "textMessage": "This is an authorized webhook!"
  },
  "typeMessage": "textMessage"
}
Full Webhook Data:
{
  "instanceData": {
    "idInstance": 7103508593
  },
  "messageData": {
    "idMessage": "AUTH_SUCCESS_123",
    "textMessageData": {
      "textMessage": "This is an authorized webhook!"
    },
    "typeMessage": "textMessage"
  },
  "receiptId": 77777,
  "senderData": {
    "chatId": "7777777777@c.us",
    "sender": "7777777777@c.us",
    "senderContactName": "Authorized User"
  },
  "timestamp": 1234567890,
  "typeWebhook": "incomingMessageReceived"
}

Type: incomingMessageReceived
Timestamp: 2026-02-09T10:18:51
Message Data:
{
  "idMessage": "TEST123456789",
  "textMessageData": {
    "textMessage": "Hello! This is a test message from webhook."
  },
  "typeMessage": "textMessage"
}
Full Webhook Data:
{
  "idMessage": "TEST123456789",
  "instanceData": {
    "idInstance": 7103508593,
    "typeInstance": "whatsapp",
    "wid": "7103508593@c.us"
  },
  "messageData": {
    "idMessage": "TEST123456789",
    "textMessageData": {
      "textMessage": "Hello! This is a test message from webhook."
    },
    "typeMessage": "textMessage"
  },
  "receiptId": 12345,
  "senderData": {
    "chatId": "1234567890@c.us",
    "sender": "1234567890@c.us",
    "senderContactName": "Test Contact",
    "senderName": "Test User"
  },
  "timestamp": 1234567890,
  "typeWebhook": "incomingMessageReceived"
}
Webhook Configuration

Webhook Endpoint: http://your-server:5000/webhook

To receive webhooks from Green API, you need to:

  1. Make sure your server is publicly accessible (use ngrok for local testing)
  2. Configure the webhook URL in your Green API instance settings
  3. Enable the webhook types you want to receive (incoming messages, outgoing messages, etc.)
Note: For local development, use a service like ngrok to expose your local server to the internet.
Webhook Types
Incoming Events:
  • incomingMessageReceived
  • incomingCall
  • incomingBlock
Outgoing Events:
  • outgoingMessageReceived
  • outgoingMessageStatus
  • outgoingAPIMessageReceived
State Events:
  • stateInstanceChanged
  • deviceInfo
Other Events:
  • statusInstanceChanged
  • quotaExceeded