Connect WhatsApp

WhatsApp doesn't offer OAuth to third parties, but they publish the pairing protocol WhatsApp Web uses. Mediator implements it via the wa-bridge microservice — a small Node process bundled with the app that speaks Baileys, an open-source WhatsApp Web client.

Steps

1. On this page, click Generate QR code.
2. On your phone open WhatsApp → Settings → Linked devices → Link a device.
3. Point your phone's camera at the QR code shown here.
4. Wait for the status to become Connected. The listener starts automatically.

What Mediator can do afterwards

• Read every incoming message your account receives (1:1 and groups).
• Send messages, media, and reactions as your account.
• Edit sent messages (WhatsApp allows this for ~15 minutes after sending).
• Delete for everyone (same time window).

Known limits

• WhatsApp counts this as a linked device. If you exceed WhatsApp's device limit (~5) you'll be prompted to remove one on your phone. That includes actual WhatsApp Web/desktop sessions.
• Your phone must remain online. Since 2021 the phone no longer relays every message, but WhatsApp still ties auth to your phone; if it's offline for 14+ days the session drops and you'll need to re-pair.
• Business API accounts don't work here — Mediator uses the personal-account protocol.

Security note

The session state includes cryptographic keys that let Mediator act as your WhatsApp. They're encrypted at rest and never leave your server. If you ever want to revoke: Settings → Linked devices on your phone, tap the Mediator entry, log out. The next request from Mediator will fail and the account will show as disconnected.