Evolution GO - Changelog

July 3, 2026 · View on GitHub

v0.7.2

Docker: evoapicloud/evolution-go:0.7.2

🆕 New Features

Passkey (WebAuthn) pairing — support for linking accounts that the WhatsApp server locks behind a passkey (the Shortcake / CRSC flow). When the server demands a passkey, whatsmeow's PairPasskeyRequest is surfaced through a new ceremony flow: the backend mints a short-lived ceremony token, and a bundled browser extension (passkey-helper) runs the WebAuthn assertion on the web.whatsapp.com origin and posts it back. Three public endpoints drive it: GET /passkey-ceremony/{token}, POST .../response, POST .../confirm. The manager detects the passkey stage and shows an "Abrir WhatsApp Web" button. Confirmation is always manual (never auto-confirm on SkipHandoffUX). Configure the public API base via PASSKEY_PUBLIC_URL. Full guide: docs/wiki/guias-api/passkey-pairing.md. Note: there is no headless bypass — the ceremony requires the account owner's real authenticator; the extension is web-only.
Headless license auto-activation — set EVOLUTION_OPERATOR_EMAIL to the email used in your first manual license registration; on startup the service silently calls /v1/register/auto and skips the browser flow (falls back to the manual flow if the email isn't registered yet).
Button message media support — additional media handling for interactive button messages.

🔧 Improvements / CI

Dropped the whatsmeow fork — now uses official go.mau.fi/whatsmeow. The project previously vendored a fork (whatsmeow-lib submodule) to carry a PostgreSQL pool patch; upstream rejected that patch in favor of NewWithDB (app-side config). Removing the fork also pulled in upstream's native passkey support. Pinned to the commit that adds passkeys (v0.0.0-20260630180629-b572e5bcb92b). The sync-releases workflow no longer re-adds the submodule.
QR pairing consumes events.QR directly instead of GetQRChannel. The QR channel auto-confirms passkey on SkipHandoffUX and disconnects the socket when codes run out — both break an in-flight passkey ceremony. Connecting without it keeps the socket alive for as long as pairing (QR or passkey) needs. QR rotation now pauses while a passkey ceremony is active.
Public sync fixes — the release workflow drops the obsolete whatsmeow-lib step, targets evolution-foundation/*, and now ships the passkey-helper extension to the public repo.

🐛 Bug Fixes

POST /instance/pair returned an empty PairingCode — the handler swallowed PairPhone errors and returned HTTP 200 with PairingCode: "", and the client wasn't connected/awaiting-auth before PairPhone. Now starts the instance, waits for the websocket, and surfaces real errors (#21).
GET /instance/status returned 400 after a manual disconnect — now returns 200 with the disconnected status instead of erroring until a container restart (#20).

🏷️ Org rename

Repository references updated from EvolutionAPI to evolution-foundation (module path, imports, GitHub URLs, submodule URLs).

v0.7.1

Docker: evoapicloud/evolution-go:0.7.1

🆕 New Features

Test-send modal in Manager — new modal in the embedded manager UI to test message sending directly from the panel, covering text, media and interactive message types. Useful for validating an instance right after pairing without leaving the manager.

🔧 Improvements / CI

whatsmeow-lib SHA now pinned in the public sync — the sync-releases workflow previously re-cloned whatsmeow main on every run, so the SHA listed in the CHANGELOG could drift from what the public repos actually built against. The workflow now captures the SHA from the dev submodule and checks out that exact commit in the target, restoring release reproducibility.
Repository cleanup — dropped tracked binaries (evolution-go, build/server), IDE config (.idea/) and scratch files (DIFF-COMPLETO.txt, API-INTERACTIVE-DOCS.txt, carousel-sender.html). Expanded .gitignore to prevent reincidence.

📝 Docs

Postman collection — added Set Proxy request and multipart hints on /send/media; collection file renamed from Evolution GO.postman_collection (2).json to Evolution GO.postman_collection.json.
Interactive messages docs — additional examples and corrections.

v0.7.0

Docker: evoapicloud/evolution-go:0.7.0

🆕 New Features

Multi-platform interactive messages — Buttons, lists and carousel working on Android, iOS and WhatsApp Web/Desktop
- SendButton: removed ViewOnceMessage wrapper that blocked rendering on iOS and WhatsApp Web; Footer and Header are now conditional
- SendList: migrated from InteractiveMessage/NativeFlowMessage to legacy ListMessage (native protobuf) for broad compatibility
- SendCarousel: new endpoint POST /send/carousel with cards (image, text, footer, buttons) and automatic JPEG thumbnail generation for instant image loading
- whatsmeow-lib: added biz node for InteractiveMessage and pinned product_list type on the biz node for ListMessage
Base64 media support on /send/media — The url field on POST /send/media now also accepts base64-encoded media. When the value does not start with http:// or https://, it is treated as base64 and decoded; reuses the existing SendMediaFile flow
WhatsApp status endpoints — new POST /send/status/text and POST /send/status/media publish text/image/video status to status@broadcast. Media endpoint supports both JSON (with URL) and multipart/form-data (file upload). Thanks @Eduardo-gato (#15)
Webhook routing for GROUP / NEWSLETTER — when the primary MESSAGE / SEND_MESSAGE / READ_RECEIPT subscription is absent, events from @g.us chats are forwarded to GROUP subscribers and events from @newsletter chats to NEWSLETTER subscribers. Thanks @oismaelash (#18)

🔧 Improvements

Proxy protocol — new optional protocol field (and PROXY_PROTOCOL env) supporting http, https, socks5. Replaces the hardcoded SOCKS5 dialer with client.SetProxyAddress, fixing HTTP-proxy QR pairing (#12). Thanks @TBDevMaster (#13)
WhatsApp Web version cache — fetchWhatsAppWebVersion now caches the result for 1 hour with a mutex instead of issuing one request per instance startup. Thanks @VitorS0uza (#24)
Manager flicker fix — instance page no longer replaces the list with skeleton cards on every 5s polling cycle (hasLoaded flag). Thanks @TBDevMaster (#14), closes #11
WEBHOOKFILES → WEBHOOK_FILES — .env.example, docker-compose and docs aligned with the env var the runtime actually reads. Thanks @VitorS0uza (#22)
Dependency cleanup — removed unused github.com/evolution-foundation/evo-gate from go.mod
whatsmeow-lib bumped to 0923702fb
Telemetry removed — dropped legacy pkg/telemetry

🐛 Bug Fixes

/message/edit — was silently ignored because the edit payload used Conversation while the original message was sent as ExtendedTextMessage. WhatsApp requires matching types; now the edit uses ExtendedTextMessage and the response returns the actual server timestamp instead of the zero value. Closes #16
Sticker upload to S3/MinIO — when webp.Decode or png.Encode failed, the whole media pipeline aborted and the sticker was lost from the webhook. Now we log a warning and keep the raw .webp bytes so the sticker still reaches the bucket. Closes #5
Multipart /send/media — the binary-upload branch silently dropped mentionAll, mentionedJid and quoted. These fields now parse from the form (with mentionedJid accepting repeated or comma-separated values) and reach the send service. Closes #2

⚠️ Breaking changes

Proxy — previously all proxies were forced through SOCKS5. If you run SOCKS5 on a non-standard port (anything outside 1080/2080/42000-43000), set PROXY_PROTOCOL=socks5 in the env or pass "protocol": "socks5" in the proxy body explicitly — otherwise the new protocol inference will fall back to HTTP.

📝 Docs

README — updated WhatsApp support number and issue templates
Interactive messages guide — new docs/wiki/guias-api/api-interactive.md
Proxy docs — environment variables, configuration guide and API reference updated with the new protocol field

v0.6.1

🆕 New Features

Group invite info endpoint — GET /group/invite-info to get group details from invite link
Enhanced media sending — GIF playback, video stickers, and transparent sticker support

🐛 Bug Fixes

Admin revoke — Allow deleting messages from others in groups (admin revoke)

🔧 Improvements

Version management — Reads version from VERSION file with ldflags fallback
CORS global middleware — Applied before all routes
Makefile compatibility — Fixed $(shell) syntax for GNU Make 3.81 (macOS default)
CI/CD cleanup — Removed develop branch trigger and homolog tag from Docker workflow
README updated — New links, documentation, and hosting info

v0.6.0

🆕 New Features

Version from VERSION file — Reads version from VERSION file at startup instead of hardcoded value

🔧 Improvements

Makefile compatibility — Fixed $(shell) syntax for GNU Make 3.81 (macOS default)

v0.5.4

🔧 Improvements

Update whatsmeow lib

v0.5.3

Docker: evoapicloud/evolution-go:0.5.3

🔧 Improvements

Update context handling in service methods
- Refactored multiple service methods across various packages to include context.Background() as the first argument in client calls. This change ensures that all client interactions are properly context-aware, allowing for better cancellation and timeout management.
- Updated methods in call_service.go, community_service.go, group_service.go, message_service.go, newsletter_service.go, send_service.go, user_service.go, and whatsmeow.go to enhance consistency and reliability in handling requests.
- This adjustment improves the overall robustness of the API by ensuring that all client calls can leverage context for better control over execution flow and resource management.

v0.5.2

Docker: evoapicloud/evolution-go:0.5.2

🆕 New Features

SetProxy Endpoint: New endpoint POST /instance/proxy/{instanceId} to configure proxy for instances
- Support for proxy with/without authentication
- Validation of required fields (host, port)
- Automatic cache update via reconnection
- Integrated Swagger documentation

🔧 Improvements

CheckUser Fallback Logic: Implemented intelligent fallback logic
- If formatJid=true returns IsInWhatsapp=false, automatically retries with formatJid=false
- Significant improvement in valid user detection
- Added RemoteJID field to use WhatsApp-validated JID
LID/WhatsApp JID Swap: Automatic handling of special cases
- When Sender comes as @lid and SenderAlt comes as @s.whatsapp.net
- Automatic inversion: Sender and Chat receive @s.whatsapp.net, SenderAlt receives @lid
- Detailed logs for tracking swaps

🐛 Bug Fixes

SendMessage: Standardization of WhatsApp-validated remoteJID usage
User Validation: Improvement in phone number validation and formatting

v0.5.1

Docker: evoapicloud/evolution-go:0.5.1

🔧 Improvements

Instance Deletion: Enhance instance deletion and media storage path resolution
Media Storage: Improvements in media storage and path resolution

v0.5.0

Docker: evoapicloud/evolution-go:0.5.0

🔧 Improvements

Media Storage: Enhance media storage and logging in Whatsmeow event handling
Retry Logic: Implement retry logic for client connection and message sending
Media Handling: Enhance media handling in event processing

v0.4.9

Docker: evoapicloud/evolution-go:0.4.9

🔧 Improvements

Connection Handling: Add instance update test scenarios and improve connection handling
FormatJid Field: Update FormatJid field to pointer type for better handling in message structures
Dependencies: Update dependencies and fix presence handling in Whatsmeow integration

v0.4.8

Docker: evoapicloud/evolution-go:0.4.8

🔧 Improvements

Audio Duration: Improve audio duration parsing in convertAudioToOpusWithDuration function

v0.4.7

Docker: evoapicloud/evolution-go:0.4.7

🔧 Improvements

Phone Number Formatting: Improve phone number formatting and validation in user service
Brazilian/Portuguese Numbers: Update Brazilian and Portuguese number formatting in utils

🆕 New Features

Media Handling: Enhance media handling in event processing

v0.4.6

Docker: evoapicloud/evolution-go:0.4.6

🆕 New Features

User Existence Check: Add user existence check configuration and JID validation middleware

v0.4.5

Docker: evoapicloud/evolution-go:0.4.5

🔧 Improvements

Dependencies: Update dependencies and enhance audio conversion functionality

v0.4.4

Docker: evoapicloud/evolution-go:0.4.4

🆕 New Features

CLAUDE.md: Add CLAUDE.md for project documentation and enhance RabbitMQ connection handling

v0.4.3

Docker: evoapicloud/evolution-go:0.4.3

🔧 Improvements

PostgreSQL Connection: Fix in PostgreSQL connection configuration for session auth
- Controlled configuration of pool, idle, etc.
- Adjustment on top of whatsmeow lib
User Endpoints: Fix in 'User Info' and 'Check User' endpoints
- Now return with contact's LID information

v0.3.0

🆕 New Features

Own Message Reactions: Additional 'fromMe' parameter using Chat id
CreatedAt Field: CreatedAt field added to instances table

v0.2.0

🆕 New Features

Advanced Settings: Advanced configurations in instance creation
- alwaysOnline (still to be implemented)
- rejectCall - Automatically reject calls
- msgRejectCall - Call rejection message
- readMessages - Automatically mark messages as read
- ignoreGroups - Ignore group messages
- ignoreStatus - Ignore status messages
Advanced Settings Routes: New routes for get and update of advanced settings
QR Code Control: QRCODE_MAX_COUNT variable to control how many QR codes to generate before timeout
AMQP Events: AMQP_SPECIFIC_EVENTS variable to individually select which events to receive in RabbitMQ