---
title: "WhatsApp agents — setup, permissions and first task — AgentSky"
description: "Use the linked-device pairing flow to let incoming messages reach your selected agent. This is an unofficial connection; review the risks before choosing a number."
url: https://agentsky.dev/channels/whatsapp
---

# WhatsApp

Use the linked-device pairing flow to let incoming messages reach your selected agent. This is an unofficial connection; review the risks before choosing a number.

[Repo](https://agentsky.dev/auth/start?returnTo=%2Fchannels%2Fwhatsapp%3Fresume%3D1)

A task starts here in your browser. To receive messages through WhatsApp, [connect WhatsApp on your Channels page](https://agentsky.dev/channels?connect=whatsapp) . Channel setup opens separately; it does not automatically bind this new task.

Setup

## Connect WhatsApp and verify your first task.

A secondary WhatsApp number you control, access to its Linked Devices settings, and an AgentSky agent.

01

### Read the pairing consent

On your Channels page, select Connect WhatsApp. The consent explains that Meta can ban the linked number and recommends using a secondary number.

02

### Scan the current QR code

On the phone for the number being paired, open WhatsApp Settings → Linked Devices → Link a Device. Scan the displayed QR; it rotates while waiting.

03

### Test from a different number

Send a small request to the paired number from another account you control. Messages sent by the paired number itself do not reach the agent. Confirm the response and usage.

Before you connect

## Know what this connection does.

A channel provides a conversation entry point. Configure task-specific tools, credentials and permissions separately, and review model and runtime pricing before running work.

- Number risk This connection is unofficial and is not the WhatsApp Business Platform API. A ban affects the WhatsApp account you pair.
- Who can run work Anyone messaging the paired number can reach the selected agent, and those messages count toward your usage. Choose the number and audience accordingly.
- Pairing recovery Wait for a current QR and the connected state. If the flow reports a disconnect, use its retry control; a screenshot of an old QR is not a completed connection.

## WhatsApp setup questions

## Related resources

[Claude Code + WhatsAppUse Claude Code from WhatsApp after testing the same agent in the shared Composer.](https://agentsky.dev/agents/claude-code/channels/whatsapp) [Codex + WhatsAppUse Codex from WhatsApp after testing the same agent in the shared Composer.](https://agentsky.dev/agents/codex/channels/whatsapp) [OpenClaw + WhatsAppUse OpenClaw from WhatsApp after testing the same agent in the shared Composer.](https://agentsky.dev/agents/openclaw/channels/whatsapp) [OpenCode + WhatsAppUse OpenCode from WhatsApp after testing the same agent in the shared Composer.](https://agentsky.dev/agents/opencode/channels/whatsapp) [Hermes + WhatsAppUse Hermes from WhatsApp after testing the same agent in the shared Composer.](https://agentsky.dev/agents/hermes/channels/whatsapp) [Kimi Code + WhatsAppUse Kimi Code from WhatsApp after testing the same agent in the shared Composer.](https://agentsky.dev/agents/kimi-code/channels/whatsapp) [DeepSeek Harness + WhatsAppUse DeepSeek Harness from WhatsApp after testing the same agent in the shared Composer.](https://agentsky.dev/agents/dsh/channels/whatsapp) [pi + WhatsAppUse pi from WhatsApp after testing the same agent in the shared Composer.](https://agentsky.dev/agents/pi/channels/whatsapp) [All channelsCompare setup methods and supported conversation surfaces.](https://agentsky.dev/channels) [ConnectorsAuthorize application access separately.](https://agentsky.dev/connectors) [PricingReview model and runtime charges.](https://agentsky.dev/pricing)

## Choose the agent that answers in WhatsApp.

[Connect WhatsApp](https://agentsky.dev/channels?connect=whatsapp)

## Frequently asked questions

### Is AgentSky’s WhatsApp connection the official Business API?

No. The current setup uses an unofficial linked-device connection with QR pairing. It should not be described as a WhatsApp Business API integration.

### Should I use my primary WhatsApp number?

The current setup consent recommends a secondary number you control and explains that Meta may ban the linked account. Review that risk before pairing.

### How do I pair my phone?

In WhatsApp, open Settings, then Linked Devices, then Link a Device. Scan the current QR code shown by AgentSky and wait for the connected state.

### What if the QR code expires?

Use the refreshed QR shown in setup and complete pairing again. An expired code or an open setup window does not establish a connection.

### How do I know messages reach the selected agent?

After pairing completes, send a short request and verify a useful reply in the intended conversation. Check the agent binding if the response is unexpected.

### How do I remove the linked device?

Use WhatsApp’s Linked Devices controls to log out the relevant device. Removing that session interrupts the linked-device connection.

### Does a messaging channel make agent usage free?

No. A channel is a way to communicate with an agent. Model, tool and runtime usage remain subject to the applicable AgentSky charges.

### Is this suitable for a business-critical support number?

The current connection is unofficial and its setup warns of possible account bans. Consider that risk before linking an important number; the existing flow recommends a secondary number you control.

### Is the setup QR a normal website QR code?

It is a linked-device pairing code for the WhatsApp account. Scan it through WhatsApp’s Link a Device flow. Pair only the account you intend to connect and do not share the pairing code.

### Does unlinking the device delete the WhatsApp account?

Logging out a linked device removes that device’s session. It is distinct from deleting the WhatsApp account. The agent connection needs a valid linked session to continue.

---

Markdown copy of https://agentsky.dev/channels/whatsapp. Every agentsky.dev page has one: add `.md` to its address or send `Accept: text/markdown`. Start from https://agentsky.dev/llms.txt.
