Skip to content

fix(baileys): prevent healthy instances from being killed after stream:error 515 #2509

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
octo-patch wants to merge 2 commits into
base: main
Choose a base branch
from
+19 −1
Open

fix(baileys): prevent healthy instances from being killed after stream:error 515 #2509

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
b76325d
fix(baileys): prevent healthy instances from being killed after strea…
Apr 20, 2026
d803c9f
fix(baileys): name the 515 reconnect grace + tighten stream-error types
octo-patch Apr 20, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
20 changes: 19 additions & 1 deletion src/api/integrations/channel/whatsapp/whatsapp.baileys.service.ts
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -251,11 +251,19 @@ export class BaileysStartupService extends ChannelStartupService {
private endSession = false;
private logBaileys = this.configService.get<Log>('LOG').BAILEYS;
private eventProcessingQueue: Promise<void> = Promise.resolve();
private _lastStream515At = 0;

// Cache TTL constants (in seconds)
private readonly MESSAGE_CACHE_TTL_SECONDS = 5 * 60; // 5 minutes - avoid duplicate message processing
private readonly UPDATE_CACHE_TTL_SECONDS = 30 * 60; // 30 minutes - avoid duplicate status updates

// Reconnect behaviour for the Baileys "stream:error 515" sequence.
// After WhatsApp emits 515 it usually closes with `loggedOut`; that close is *not* a real logout
// and we should reconnect. We treat any close arriving within this grace window as 515-driven.
private static readonly STREAM_515_RECONNECT_GRACE_MS = 30_000;
// The numeric WhatsApp stream-error code that triggers the grace-period reconnect above.
private static readonly STREAM_ERROR_CODE_RECONNECT = '515';

public stateConnection: wa.StateConnection = { state: 'close' };

public phoneNumber: string;
Expand Down Expand Up @@ -426,7 +434,11 @@ export class BaileysStartupService extends ChannelStartupService {
if (connection === 'close') {
const statusCode = (lastDisconnect?.error as Boom)?.output?.statusCode;
const codesToNotReconnect = [DisconnectReason.loggedOut, DisconnectReason.forbidden, 402, 406];
const shouldReconnect = !codesToNotReconnect.includes(statusCode);
const recentStream515 =
Date.now() - this._lastStream515At < BaileysStartupService.STREAM_515_RECONNECT_GRACE_MS;
const shouldReconnect =
!codesToNotReconnect.includes(statusCode) ||
(statusCode === DisconnectReason.loggedOut && recentStream515);
if (shouldReconnect) {
await this.connectToWhatsapp(this.phoneNumber);
} else {
Expand Down Expand Up @@ -715,6 +727,12 @@ export class BaileysStartupService extends ChannelStartupService {
this.sendDataWebhook(Events.CALL, payload, true, ['websocket']);
});

this.client.ws.on('CB:stream:error', (node: { attrs?: { code?: string | number } }) => {
if (String(node?.attrs?.code) === BaileysStartupService.STREAM_ERROR_CODE_RECONNECT) {
this._lastStream515At = Date.now();
}
});

this.phoneNumber = number;

return this.client;
Expand Down