Evolution API

Evolution API - Can’t Read Received WhatsApp Messages (MESSAGES_UPSERT)

Problem:

I’m using the Evolution API community node to receive WhatsApp messages via webhooks. The MESSAGES_UPSERT event successfully notifies me when a message is received, but I can’t actually read the message content.

Current Setup:

  • Event: MESSAGES_UPSERT
  • Webhook URL: https://sub.domain.com/webhook/messages-upsert
  • Status: Webhook registration successful (success: true)
  • Issue: Only shows notification metadata, not actual message text

What I’m Getting:

What I Need:

The actual message content when someone sends a WhatsApp message, something like:

json

{
  "from": "+1234567890",
  "message": "Yes, I'm available in 30 minutes",
  "timestamp": "2025-06-03T17:30:00.000Z"
}

Questions:

  1. Is this Evolution API webhook node only for REGISTERING webhooks, not RECEIVING message data?
  2. Do I need a separate “Webhook” trigger node to actually receive the message payload?
  3. Has anyone successfully read WhatsApp message content using Evolution API + n8n?

Use Case:

Building automated responses to WhatsApp messages for business automation.

Evolution API Documentation:

According to their docs, MESSAGES_UPSERT should “notify when a message is received” but I’m not getting the actual message content.

Any guidance would be greatly appreciated!

Evolution API Node Role
The Evolution API node being used only registers webhooks. It is not designed to receive or process event data. This is key.

The message is not being received because there is no webhook receiver node (Webhook Trigger) in n8n listening on the /webhook/messages-upsert path.

n8n needs a native webhook node configured with that same path (/webhook/messages-upsert) and POST method to process the actual message.

Node 1: Evolution API (Resource: Event, Operation: Webhook)
Purpose: Register a webhook in the Evolution API for the MESSAGES_UPSERT event.

Configuration:

URL: The address of the webhook that n8n will listen on, for example, https://your-domain.com/webhook/messages-upsert.

Events: List including “MESSAGES_UPSERT”.

webhook_by_events: Set to false if you want all events to be sent to the same URL.

Documentation:

Webhook Configuration - Evolution API

Node 2: Webhook (n8n native)
Purpose: Capture incoming requests from the Evolution API when a WhatsApp message is received.

Configuration:

HTTP Method: POST.

Path: /webhook/messages-upsert.

Response Mode: Configure according to the flow’s needs (e.g., respond immediately or upon flow completion).

Documentation:

Webhook Node - n8n Documentation

2 Likes

Thank you!

In My case have the same issue in the terminal error 404, only work MESSAGES_UPDATE, can You help