Chatwoot Integration – 401 Unauthorized When Connecting Evolution API

[dilnasarath1995]

Hi Team,

I’m trying to integrate Evolution API (v2.3.7) with Chatwoot (v4.10.1), but I’m facing authorization issues when Evolution connects to Chatwoot.

Environment

OS: Ubuntu

Chatwoot: v4.10.1 (Docker Compose)

Evolution API: v2.3.7

Deployment: Docker

Chatwoot URL: https://chat.mydomain.com

Containers Running

chatwoot-rails

chatwoot-sidekiq

chatwoot-redis

chatwoot-postgres

evolution-api

Issue

When Evolution tries to connect to Chatwoot APIs, I get:

401 Unauthorized
You need to sign in or sign up before continuing.

Testing manually:

curl https://chat.mydomain.com/api/v1/accounts/2 \
  -H "api_access_token: MY_API_KEY"

Response:

{
  "errors": ["You need to sign in or sign up before continuing."]
}

Chatwoot logs:

Filter chain halted as :authenticate_user!
Completed 401 Unauthorized

What I Tried

Created Platform API Key in Chatwoot

Verified token
Restarted containers
Checked Docker network
Tested API from inside containers
Confirmed Chatwoot is working properly
Still getting Unauthorized.

Questions
What is the correct authentication method for Chatwoot integration in Evolution API?
Should I use:
Platform API Key?
Agent/User API token?
OAuth?

Are any extra headers or permissions required?

Is there an official/recommended way to integrate Evolution API with Chatwoot?

Chatwoot maintainers mentioned that this is not officially supported on their side and advised me to check with the Evolution API team.

Any guidance or example configuration would be really helpful.

Thanks in advance 🙏
Sarath