🏭 Engines

Engines #

Under the hood WAHA allows you to use different engines. You can control what you want to run by settings WHATSAPP_DEFAULT_ENGINE environment variables.

docker run -it -e "WHATSAPP_DEFAULT_ENGINE=WEBJS" devlikeapro/waha

If you have any problems with one engine - try another!

All engines are available in both Core and Plus versions.

WEBJS #

👉 Read more about WEBJS

WHATSAPP_DEFAULT_ENGINE=WEBJS

A WhatsApp API client that connects through the WhatsApp Web browser app. It uses Puppeteer to run a real instance of Whatsapp Web to avoid getting blocked.

NOWEB #

👉 Read more about NOWEB

WHATSAPP_DEFAULT_ENGINE=NOWEB

NOWEB engine does not require a browser to work with WhatsApp Web, it does so directly using a WebSocket. Not running Chromium saves you CPU and Memory, so you can run more instances on a single server!

Quotes from the users:

The server has 2 CPU and 8GB of memory. Today we have 85 sessions in this instance.

400 sessions with 4CPU and 32RAM. It’s working fine.

Docker images #

WAHA provides few docker images with different setup.

Browsers #

• Chromium - is the default browser for WAHA. It’s a good choice for most cases.
• Chrome - is a good choice if you need to receive videos in Plus version.
• None - is a good choice if you want to use NOWEB engine.

CPU #

• x86 - is a good choice for most cases.
• ARM - is a good choice if you’re using ARM processors (like Apple Silicon, Apple M1, etc.)
  💡

  Chrome version is not available in ARM

Versions #

💡 You can pin WAHA version by adding -{version} at the end of image tag.

• devlikeapro/waha-plus:chrome-{version} => devlikeapro/waha-plus:chrome-2024.6.1
• devlikeapro/waha-plus:latest-{version} => devlikeapro/waha-plus:latest-2024.6.1

Features #

Some engines may not support certain features. Here, you will find a list of supported endpoints and webhooks per engine.

Symbol	Meaning
✔️	The engines supports the feature.
#123	Feature request or bug for the endpoint
	The feature available in WAHA Plus.
➖	The engine does not and will newer support this feature

If you don’t specify WHATSAPP_DEFAULT_ENGINE environment variable - look at WEBJS engine, it’s the engine WAHA runs by default.

Protocols #

Webhooks #

	WEBJS	NOWEB
message	✔️	✔️
message with files	✔️	✔️
message.reaction	✔️	✔️
message.any	✔️	✔️
message.ack	✔️	✔️
message.revoked	✔️
state.change	✔️	✔️
group.join	✔️	✔️
group.leave	✔️
presence.update		✔️
poll.vote		✔️
poll.vote.failed		✔️
chat.archive	✔️	✔️
call.received	✔️	✔️
call.accepted		✔️
call.rejected		✔️

Sessions #

Read more about 🖥️ Sessions

1. Logout from a session removes authentication information from a server (WAHA), but keeps the device on “Connected Device” in the app - #148

If you see the feature is not available in the above list, please create a feature request or leave “+1” comment on the existing one.

Messages #

	WEBJS	NOWEB
POST /api/sendText	✔️	✔️
POST /api/sendSeen	✔️	✔️
PUT /api/{session}/chats/{chatId}/messages/{messageId}	✔️	✔️
DELETE /api/{session}/chats/{chatId}/messages/{messageId}	✔️	✔️
POST /api/sendImage	✔️	✔️
POST /api/sendFile	✔️	✔️
POST /api/sendVoice	✔️	✔️
POST /api/sendVideo	✔️	✔️
POST /api/sendPoll	#189	✔️
POST /api/sendLocation	✔️	✔️
POST /api/sendLinkPreview		✔️
POST /api/startTyping	✔️	✔️
POST /api/stopTyping	✔️	✔️
POST /api/{session}/presence	✔️	✔️
POST /api/reaction	✔️	✔️
POST /api/star	✔️	✔️
GET /api/sendContactVcard		✔️
GET /api/messages	✔️	✔️¹
GET /api/checkNumberStatus	✔️	✔️

1. NOWEB - you need to Enable Store to get chats, contacts and messages

If you see the feature is not available in the above list, please create a feature request or leave “+1” comment on the existing one.

Status #

	WEBJS	NOWEB
Status
POST /api/{session}/status/text		✔️
POST /api/{session}/status/image		✔️
POST /api/{session}/status/voice		✔️
POST /api/{session}/status/video		✔️
POST /api/{session}/status/delete		✔️

Chats #

1. NOWEB - you need to Enable Store to get chats, contacts and messages

If you see the feature is not available in the above list, please create a feature request or leave “+1” comment on the existing one.

Contacts #

Channels #

Read more about 📢 Channels

	WEBJS	NOWEB
Search public channels	#440	#440
Create Channel POST /api/{session}/channels	#439	✔️
Get channel - by id and invite code GET /api/{session}/channels/{ChannelID}	✔️	✔️
List channels GET /api/{session}/channels	✔️	✔️
Delete channel DELETE /api/{session}/channels/{ChannelID}		✔️
Get messages GET /api/{session}/chats/{ChannelID}/messages	✔️	✔️ #433
Send messages - Text POST /api/sendText	✔️	✔️
Send messages - Image POST /api/sendImage	✔️	✔️
Send messages - Poll POST /api/sendPoll
Receive messages - Text message event	✔️	✔️
Receive messages - Image message event	✔️	✔️
Receive messages - Polls		✔️
Receive messages - Polls Votes (in my channel)
Receive messages - Reactions (in my channel)
Channels - follow, unfollow
Channels - mute, unmute
Admins - Send Invite
Admins - Revoke Invite
Admins - Accept Invite
Admins - Demote Admin

If you see the feature is not available in the above list, please create a feature request or leave “+1” comment on the existing one.

Groups #

Read more about 👥 Groups

Presence #

Read more about ✅ Presence

Labels #

Read more about 🏷️ Labels

If you see the feature is not available in the above list, please create a feature request or leave “+1” comment on the existing one.

Calls #

Read more about 📞 Calls

Storages #

Read more about 🗄️ Storages

1. Any S3 Compatible storage can be used, such as AWS S3, MinIO, DigitalOcean Spaces, etc. For in-house solutions, you can use MinIO.

If you see the feature is not available in the above list, please create a feature request or leave “+1” comment on the existing one.

👉 Storages are available in WAHA Plus only.

Observability #

Read more about 🔍 Observability

	WEBJS	NOWEB
Other
GET /api/version	✔️	✔️
GET /health	✔️	✔️