explaingit

uazapi/whatsapp-web-session-importer

Analysis updated 2026-05-18

15TypeScriptAudience · ops devopsComplexity · 3/5Setup · moderate

TLDR

A browser extension that migrates an already logged in WhatsApp Web session into an authorized business messaging API without rescanning a QR code.

Mindmap

mindmap
  root((Session Importer))
    What it does
      Migrates WA Web session
      Skips QR rescan
      Connects API instance
    Tech stack
      TypeScript
      Chrome Extension
    Use cases
      Client onboarding
      Platform migration
      History anchoring
    Audience
      Platform operators
      Support teams
    Limits
      Needs prior QR login
      Not for shared PCs

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Migrate a customer's active WhatsApp Web login into your business messaging API instance.

USE CASE 2

Skip re-scanning a QR code when onboarding a client onto a WhatsApp automation platform.

USE CASE 3

Automatically start an API instance connection right after capturing the session.

USE CASE 4

Optionally carry over recent chat history as an anchor when migrating a session.

What is it built with?

TypeScriptChrome ExtensionWhatsApp Web

How does it compare?

uazapi/whatsapp-web-session-importeraestheticsuraj234/chai-gpt-buildalexvilelabah/age-of-ai
Stars151515
LanguageTypeScriptTypeScriptTypeScript
Setup difficultymoderateeasymoderate
Complexity3/52/54/5
Audienceops devopsdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires an existing authorized API instance with a valid subscription name and token.

In plain English

This is a Chrome and Edge browser extension that moves an already connected WhatsApp Web session into an authorized business API instance. It is meant for people who run a WhatsApp automation platform and need to migrate a customer's existing WhatsApp Web login into that platform without asking them to scan a new QR code from scratch. To use it you need the extension installed, the name of your API subscription instance, its access token, and access to the WhatsApp account you want connected. After installing the extension from the Chrome Web Store, or manually by loading the unpacked folder in developer mode, you open WhatsApp Web as usual and let it fully load your conversations. The extension can then be triggered by opening a special WhatsApp Web link that includes your instance name and token as URL parameters, which automatically opens its migration panel. Once the panel is open, you confirm the instance name and token are correct and click a migrate button. Behind the scenes the extension verifies the instance against the authorized API, captures the currently connected WhatsApp Web session, waits until that session is fully ready, sends it to the API along with recent chat history as a reference point, clears the local browser session, and starts the instance's connection automatically. During this process the WhatsApp Web tab may reload or appear to log out, which is expected. After migration finishes, the instance should show as connected on the platform's dashboard, while the original WhatsApp Web browser session becomes disconnected since its session has moved to the instance. The extension explicitly does not create a new WhatsApp account, and it cannot connect an instance on its own if WhatsApp Web has not already been authenticated by scanning a QR code first. It is not meant to be used on public or shared computers, and the README warns not to share your instance token with anyone. A settings panel lets you control whether the panel opens automatically, choose a light, dark, or WhatsApp-matching theme, and decide whether message history is included in the migration. Developer documentation covering integration details and available endpoints is included in the repository for teams building on top of this extension. The full README is longer than what was shown.

Copy-paste prompts

Prompt 1
Walk me through installing this extension manually by loading the unpacked folder in Chrome.
Prompt 2
Explain the client and token URL parameters this extension reads from a WhatsApp Web link.
Prompt 3
Help me troubleshoot why the migration panel is not opening after I load the special link.
Prompt 4
Explain what happens to the original WhatsApp Web session after a successful migration.

Frequently asked questions

What is whatsapp-web-session-importer?

A browser extension that migrates an already logged in WhatsApp Web session into an authorized business messaging API without rescanning a QR code.

What language is whatsapp-web-session-importer written in?

Mainly TypeScript. The stack also includes TypeScript, Chrome Extension, WhatsApp Web.

How hard is whatsapp-web-session-importer to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is whatsapp-web-session-importer for?

Mainly ops devops.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.