WhatsApp Personal Integration

This page describes how to connect a SipPulse AI Agent to a personal WhatsApp number using QR Code scanning, similar to WhatsApp Web.

1. What is WhatsApp Personal?

WhatsApp Personal is an alternative deployment channel that allows you to connect your personal WhatsApp number to an agent via QR Code. It works similarly to WhatsApp Web - you scan a code and your number becomes linked to the platform.

Beta Feature

This integration uses an unofficial library and is considered beta/experimental. While functional, it may experience occasional instabilities. Meta can make changes to WhatsApp that affect this integration at any time.

When to Use WhatsApp Personal

Ideal scenarios:

• Quickly validate conversational flows before production deployment
• Personal projects or small-scale implementations
• Demonstrations and proof of concept
• Situations where you need manual control over conversations

Comparison with WhatsApp Business

Feature	WhatsApp Business	WhatsApp Personal
Meta Business Verification	Required	Not required
Proactive Messages (Templates)	Yes	No
Official API	Yes	No (QR Code connection)
Message Debug Panel	Yes	No
Send via API	Yes	No
Stability	High	May vary
Manual Intervention	Limited	Full (it's your number)
Best for	Production / Scale	Validation / Small scale

2. Initial Setup

Prerequisites

• A WhatsApp number (we strongly recommend using a dedicated number)
• The number cannot be connected to another agent

Important: Use a Dedicated Number

We strongly recommend using a dedicated number for this integration, not your primary personal number.

Why? When connected, all messages received on this number will be processed by the agent. If you use your personal number, conversations with family, friends, and work contacts will also go through the agent.

Connect via QR Code

1. Open ⋮ → Deploy on the Agent row and locate the WhatsApp Personal card.
2. Click Scan QR Code.
3. A modal will appear with instructions and a QR Code.
4. On your phone, open WhatsApp → Settings → Linked Devices → Link a Device.
5. Scan the QR Code displayed in SipPulse AI.
6. Once connected, the card will display your phone number and status will change to Connected.

About the QR Code:

• Each code is valid for approximately 45 seconds
• If it expires, a new one is automatically generated
• The system tries up to 10 times before ending the session
• If this happens, simply reopen the modal and try again

One number per agent

Each WhatsApp number can only be connected to one agent at a time. If you try to connect a number that's already in use, you'll see an error message: "This phone number is already connected to another agent."

3. How It Works in Practice

Message Flow

User sends message → WhatsApp → SipPulse AI → Agent processes → Automatic response

When the integration is active, every message received on the connected number is sent to the agent for processing. The agent analyzes the message and generates an appropriate response based on its configuration.

Human Intervention

Since the number is yours, you can manually intervene at any moment:

• Open WhatsApp on your phone and respond directly
• The agent will see your message as part of the conversation
• Useful for situations the agent cannot resolve

Exclusive Advantage

This is a unique advantage of WhatsApp Personal: you have full access to conversations and can intervene when necessary, unlike WhatsApp Business where control is via API only.

4. Management

Enable or Disable Quickly

Use the toggle switch on the card to control the integration:

• On → The agent processes incoming messages in real time.
• Off → Incoming messages are ignored; no token charges apply.

Connection Status

The card displays the current connection status:

Status	Description
Offline	Not connected. Click "Scan QR Code" to connect.
Connecting	QR Code generated, waiting for scan.
Connected	Successfully connected and receiving messages.
Reconnecting	Connection lost, attempting to restore automatically.

Disconnect

To disconnect your WhatsApp number:

1. Click the ⋮ menu on the WhatsApp Personal card.
2. Select Disconnect.
3. The connection will be closed and the status will return to Offline.

You can also disconnect via WhatsApp on your phone (Settings → Linked Devices).

5. Limitations and Considerations

What is NOT Possible

• No proactive messages: You cannot send template messages to initiate conversations.
• No API sending: Messages can only be received and responded to, not sent programmatically.
• No debug panel: Message history is not available in the debug interface.
• Session dependency: The connection depends on your phone staying connected to the internet.

Stability Considerations

• This integration uses an unofficial library
• There may be occasional instabilities
• Meta can make changes that affect functionality
• It's recommended to have a contingency plan for production use

Ideal for Validation

WhatsApp Personal is designed for quick testing and validation of your agent's behavior. For production use cases requiring proactive messaging, API integration, or higher reliability, use WhatsApp Business integration instead.

6. Troubleshooting

QR Code Expired

If the QR Code expires before you scan it, the system automatically generates a new one (up to 10 times). If all codes expire, simply close the modal and click "Scan QR Code" again to start a new session.

Phone Number Already in Use

If you see "This phone number is already connected to another agent", you need to either:

• Disconnect the number from the other agent first, or
• Use a different WhatsApp number.

Connection Keeps Reconnecting

If the status keeps switching between "Connected" and "Reconnecting":

• Ensure your phone has a stable internet connection.
• Check that WhatsApp is running in the background on your phone.
• Try disconnecting and reconnecting via QR Code.
• Restart WhatsApp on your phone if the problem persists.