> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://breakcold-aicrm.crisp.help/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# How to Connect My WhatsApp Account?

Connect your WhatsApp account to send and receive WhatsApp messages directly from Breakcold.

## Overview
Connecting your WhatsApp account lets you **send and receive WhatsApp messages directly from Breakcold**, sync your conversation history, and manage all your WhatsApp interactions alongside your other channels (Email, LinkedIn, Telegram). Breakcold offers two connection methods: **QR code** scanning or **Pairing code** via phone number.
## Step 1 — Go to the Accounts Page
1. In the left sidebar, click **Accounts** under the Workspace section.
2. Scroll down to the **Social Channels** section and click **+ Connect** under WhatsApp.
Click "+ Connect" under WhatsApp in the Social Channels section.
## Step 2 — History Import
Choose how much WhatsApp message history to import into Breakcold.
3. Use the dropdown to select your preference:
* **Don't import history** — Start fresh with no past messages
* **Import last 1 month**
* **Import last 3 months**
* **Import last 6 months**
* **Import last 12 months** — Bring in the past year of conversations
4. Click **Next** to continue.
Choose how far back to import — from 1 month to 12 months, or start fresh.
## Step 3 — Sharing Settings
Choose whether this WhatsApp account is private or shared with your team.
* **No, this is a private account** — Only you can access this account. You can share it later.
* **Yes, this is a shared account** — Allows other workspace members to use this account.
5. Select your preference and click **Connect**.
Choose private or shared — you can always change this later.
## Step 4 — Choose a Connection Method
You will see the **"Sign in to WhatsApp"** page with two tabs:
* **QR code** — Scan a QR code from your WhatsApp mobile app (recommended)
* **Pairing code** — Enter your phone number and receive a pairing code
Choose between QR code scanning or Pairing code — both connect your WhatsApp account.
## Method 1 — QR Code (Recommended)
1. Select the **QR code** tab. A QR code will appear with a countdown timer.
2. Follow these steps on your phone:
3. Open **WhatsApp** on your phone
4. Tap **Menu** or **Settings** and select **Linked devices**
![](https://storage.crisp.chat/users/helpdesk/website/-/c/f/1/8/cf18dcba819a5000/image_gubnff.png)

1. Tap on **Link a Device**
2. Point your phone at the screen to **scan the QR code**
Scan the QR code from your WhatsApp app — you have 60 seconds before it expires.
**Warning —** The QR code expires after **60 seconds**. If it expires, a new code will be generated automatically. Have your phone ready before this step.
## Method 2 — Pairing Code
1. Select the **Pairing code** tab.
2. Enter the **phone number** linked to your WhatsApp account. Include the country code without the local leading 0 (e.g. `+33600000000`). The + is optional.
3. Click **Show code**. A pairing code will be generated that you enter in your WhatsApp mobile app to complete the link.
![](https://storage.crisp.chat/users/helpdesk/website/-/c/f/1/8/cf18dcba819a5000/image_anuyy2.png)

Enter your phone number with country code, then click "Show code" to get the pairing code.
| Tip — The QR code method is faster and recommended for most users. Use the Pairing code method if you cannot scan a QR code (e.g. if you are setting up from a device without a camera).
## WhatsApp Connected!
After scanning the QR code or entering the pairing code, your WhatsApp account will be connected. You will see the **"Account Connected"** success page. Your WhatsApp conversations will begin syncing and will appear in the **Inbox** under the **WhatsApp** channel view.
| Note — Once connected, you can manage your WhatsApp account from the Account Details page, where you can configure sharing settings, view sync status, and reconnect if needed.
## Frequently Asked Questions
**How do I connect my WhatsApp account?**
Go to Accounts > Social Channels > WhatsApp > + Connect. Choose history import and sharing settings, then scan the QR code or use a pairing code.
**What are the two connection methods?**
**QR code** (scan from your WhatsApp app) and **Pairing code** (enter your phone number and receive a code). QR code is faster and recommended.
**How do I scan the QR code?**
Open WhatsApp on your phone, go to Settings > Linked devices > Link a Device, then point your camera at the QR code on screen.
**What if the QR code expires?**
A new QR code is generated automatically every 60 seconds. Wait for the new one and scan it quickly.
**How do I format my phone number for the pairing code?**
Include the country code without the local leading 0. For example: `+33600000000` (not +3306...). The + sign is optional.
**Can I import my existing WhatsApp conversations?**
Yes. During setup, choose from 1 month, 3 months, 6 months, or 12 months of history import.
**Can I share my WhatsApp account with my team?**
Yes. Choose "shared account" during setup, or change it later from the Sharing section in the account details. You can set granular read/write permissions per team member.
**Where do WhatsApp messages appear in Breakcold?**
Once connected, WhatsApp conversations appear in the Inbox under the **WhatsApp** channel view, alongside your Email, LinkedIn, and Telegram messages.