Reuse a linked session
Keep the browser profile on the workstation and reconnect through the tray agent when the session needs attention.
Free companion toolWindows
WhatsApp Agent
A local bridge from your business workflow to WhatsApp.
Connect supported SmartCode workflows to your linked WhatsApp session. Send text, documents and images from a Windows tray agent, with connection status and local session management.
Version 2.2.7Ask us for the installer and setup guidance.
A useful connectionWhatsApp Agent01Install on your Windows workstation✓
02Link your WhatsApp account✓
03Connect the business workflow✓
Connect. Configure. Put it to work.
A small tool with a clear purpose
Put your existing tools to work together.
Designed for
- SmartCode software users
- Windows business workstations
- Document and message workflows
- Teams using supported Odoo integrations
WhatsApp Agent connects a supported business workflow to a WhatsApp Web session running on your Windows PC. The agent lives in the system tray, opens a QR sign-in window when needed and keeps its browser profile locally so you can resume the same session.
The tool can accept sending work through its local connection or a configured Odoo Agent Hub pairing. In either setup, your business application prepares the message and attachment, while the Windows agent carries out the WhatsApp Web interaction. It is a practical bridge for supported workflows such as sending a document after a business transaction.
This is browser automation of WhatsApp Web, rather than the official WhatsApp Business API. The compatibility and usage limitations are explained below so you can choose the right connection for your operation.
Keep the file with its message
Submit a document or image with a caption through a supported business workflow.
See the connection state
Follow the agent’s status and logs rather than guessing whether the workstation is linked.
What the tool can do
Explore the details.
See what connects.
Practical capabilities, with the setup and compatibility details explained below.
01
A small Windows tray companion
Run the agent beside your business application. Tray controls give you access to the browser, connection status and logs, without needing to keep a separate main application window in front of your work.
- Windows system-tray controls
- Status and logs
- Configurable startup
02
QR sign-in and a local session
Open the bundled browser and scan the QR code from WhatsApp Linked Devices. The agent keeps a local browser profile between runs, so the linked session can be reused while it remains valid.
- Visible QR sign-in
- Bundled Chromium
- Persistent local browser profile
03
Messages with useful attachments
Supported workflows can submit a text message or an attachment to the agent. Documents and images can carry a caption, keeping the customer-facing file and its explanation together.
- Text sending
- Documents and images
- Optional captions
04
A local application bridge
The local HTTP bridge listens on the same PC at 127.0.0.1:8765. Sending requests require the configured bridge token. Your supported integration prepares the destination and content, and the agent interacts with the linked Web session.
- Loopback connection
- Token-protected sending
- Application-controlled message content
05
Optional Odoo Agent Hub pairing
When your integration uses Agent Hub, pair the workstation to the configured Odoo server and approve the request on the PC. The agent polls the server for work, so the pairing does not need an inbound port forwarded to the workstation.
- Human approval on the PC
- Server polling for queued work
- Configured Odoo connection
06
Connection visibility
Use the status window and logs when a session needs attention or a message cannot be sent. A successful agent action is useful operational feedback; it is not an official WhatsApp delivery or read receipt.
- Session and connection status
- Local troubleshooting logs
- Visible re-linking when needed
At a glance
- Text messages
- Document and image attachments
- Optional attachment captions
- QR sign-in with a persistent local profile
- Windows tray controls and status
- Optional approved Agent Hub pairing
From installation to first use
A clear path to getting started.
Follow these steps, then use a sample or test job to confirm your connection.
- 01
Install on your Windows workstation
Request the installer and install it on the PC that will run the connection. Launch the tray agent, check its status window and decide whether it should start with Windows.
- 02
Link your WhatsApp account
Open the agent’s WhatsApp browser. On your phone, open WhatsApp Linked Devices and scan the displayed QR code. Wait for the chat interface to load before testing the integration.
- 03
Connect the business workflow
Configure your supported application with the local bridge and token, or enter the Odoo Agent Hub pairing details. For Hub pairing, review and accept the device request on the workstation.
- 04
Send a test message
Use a permitted test recipient to confirm a text message and a representative attachment. Check the agent status and the recipient’s conversation, then connect the approved business workflow.
Where it fits
See it in
an everyday moment.
Illustrative scenarios showing how the capabilities work together.
Sharing a business document
A supported SmartCode workflow prepares a document and the intended recipient. The agent sends the attachment through the linked WhatsApp Web session, with a caption where the integration supplies one.
A workstation paired to Odoo
A team approves its Windows workstation in Agent Hub. The agent polls the configured Odoo server for sending work and reports its status, without exposing an inbound connection to the PC.
Compatibility and preparation
What you’ll need.
Check the device, connection and access requirements before your first live job.
Windows- A Windows PC and the supplied WhatsApp Agent installer
- An active WhatsApp account and access to Linked Devices for QR sign-in
- An internet connection and a compatible WhatsApp Web session
- A supported application integration and the configured bridge token
- For Agent Hub pairing: your configured Odoo server, pairing details and permission to approve the device
Is this the official WhatsApp Business API?
No. This agent automates WhatsApp Web in a local browser. It does not provide official API templates, delivery or read callbacks, or an official messaging service guarantee. For an official API requirement, discuss a separately configured WhatsApp Business Platform integration.
What can it send?
The inspected agent supports text, document and image attachments, with an optional caption. The business integration supplies the recipient and content; supported file formats and practical limits should be checked with a representative test.
Does the PC need to remain available?
Yes. The Windows agent, its linked browser session and the network connection need to be available for the configured sending workflow. If the session expires, use the browser window to link the account again.
Where is the linked browser profile stored?
The profile is kept locally under the Windows user’s AppData in SmartWhatsappAgent/whatsapp_profile. Treat the workstation and linked session as account access. Messages still travel through WhatsApp and, when configured, the connected business system.
What are the compatibility and account limitations?
WhatsApp Web changes can interrupt browser automation, and automated use can conflict with the platform’s terms or cause account restrictions. This agent is suitable only where those limitations fit your approved workflow. It cannot guarantee delivery, continued Web compatibility or protection from account restrictions.
How do I get the installer?
Use Request the tool to contact us for the Windows installer and setup guidance. A direct download button will appear here when an approved public installer link is published.
A little help with your setup
Make the connection.
Get the tool, confirm compatibility and connect it to your everyday work.