WhatsThat icon

WhatsThat

Connect sessions, link chats, and send WhatsApp messages

Actions11

Session → Connect Session

AI-generated

Summary

Connect WhatsApp by starting a session using a stable session ID and optional metadata, returning QR code and pairing details for authentication.

Inputs

  • sessionId (required) — Stable internal name for this session, e.g., 'main-phone' or 'support-phone'. Used to identify the WhatsApp session internally.
  • label — Friendly display name for the session, e.g., 'Luca phone' or 'Support phone'. Defaults to sessionId if not provided.
  • phoneNumberForPairing — Optional WhatsApp number (country code + number digits only) to aid pairing by generating a pairing code. Should be digits only without '+' or '00' prefix.

Output shape

a single record output representing the session details

Returns the session object including fields such as sessionId, status, qr code data (qr, qrCodeUrl, qrDataUrl), pairing code, phone identifier, label, and timestamps. The session status will initially be 'starting' or 'pairing' with QR details until connection is established.

Examples

Example 1: Start a new WhatsApp session connection to obtain a QR code and pairing information to authenticate the session within n8n workflow.

Provide a unique sessionId to identify the session. Optionally provide a friendly label and the WhatsApp phone number to generate a pairing code.

Links

Discussion