Skip to content

5.44.37.12 dd. 07/30/2026#

Description#

Attention#

This release is partially backwards-compatible with the previous release, as the yellowCard instance status has been replaced by the suspended instance status as part of API unification across various messengers. The behavior of suspended instance status is completely identical to the previous behavior of yellowCard (restricted functionality, message sending blocked, etc.).

Description of changes and recommended integration improvements:

PassKey Support - for working with PassKey, the methods for obtaining a QR code (qr, scanqrcode) have been improved. The response may now include a new status, passkeyRequired, indicating authorization via PassKey.

  • The integration must be updated with logic for processing QR method responses and subsequent authorization. Add a check for the new status and, if present, implement the PassKey authorization scenario according to the instructions.

  • This functionality may become available before the official release, as WhatsApp introduces authorization via PassKey. For quick authorization, you can use the GREEN-API page with authorization instructions.

Suspended status — the yellowCard instance status has been changed to suspended in methods GetStateInstance, GetWaSettings, GetChatHistory, GetMessage, LastIncomingMessages, LastOutgoingMessages, LastIncomingCalls, LastOutgoingCalls. The logic of work remains the same.

  • In the GetWaSettings method, the yellowCardUntil field has been removed and replaced by the suspendedUntil field (unix time format).

  • To maintain the integration's functionality, change the yellowCard status to suspended.

  • When processing the duration of restrictions, use the suspendedUntil field instead of the yellowCardUntil field.

Tasks#

No. Number Result Documentation
1 SW-5769 Added methods for working with catalogs Documentation
2 SW-5381 Added suspended status Documentation
3 SW-3117 Added mechanism for deleting messages in groups Documentation
4 SW-5894 Added display of phone number instead of @lid in the LastIncomingCalls method Documentation
5 SW-5920 Added receiving incomingCallWebhook without setting up incomingWebhook Documentation
6 SW-5905 Added support for working with @lid for GetMessage and GetChatHistory methods Documentation
7 SW-5973 Implemented a PassKey authorization scenario Documentation
8 SW-5838 Added isGroup field to the incoming call journal Documentation
9 SW-5925 Optimized work with the database
10 SW-5921 Optimized authorization when working with @lid
11 SW-5897 Optimized authorization mechanism
12 SW-5953 Changed the yellowCard instance status to suspended

Issues#

No. Number Description Status
1 SW-5913 Error handling disappearing messages with the GetContactInfo Fixed
2 SW-5968 Error connecting to instances with PassKey authentication Fixed
3 SW-5922 Error handling @lid with the sendFileByUpload or sendFileByUrl methods Fixed
4 SW-5908 Error deleting status using the DeleteStatus method Fixed
5 SW-5892 Error processing messages by the microservice Fixed
6 SW-5871 Error writing group media messages to the database Fixed
7 SW-5902 Error sending audio files using the sendFileByUpload and sendFileByUrl methods Fixed
8 SW-5898 Error NotInGroup in message sent to user who left and rejoined group Fixed
9 SW-5895 Error sending messages to existing chats when receiving the suspended status Fixed
10 SW-5770 Error with autoTyping, linkPreview Fixed
11 SW-5874 Error with the quota microservice Fixed
12 SW-5918 Error accessing instance sync history excessively Fixed