Deploy Your Agent

Once you’ve created and tested your agent, deploy it to a phone number so users can start real conversations.

Deployment Options

Test Number

Free, shared Wassist number

Great for testing and demos
No setup required
Shared with other Wassist users
Limited features

Dedicated Number

Your own WhatsApp Business number

Your brand, your number
Full WhatsApp Business features
Message templates
Business profile

Using the Test Number

Every account can use Wassist’s shared sandbox number. Routing on it is per user, so connecting an agent only changes your own chat:

Go to Numbers and click the number under Sandbox numbers
In Routing, set Mode to Agent, click Connect agent and pick your agent
From the phone you signed in with, message the sandbox number on WhatsApp

See the managed agent quickstart for the full walkthrough.

The test number is shared across all Wassist users and doesn’t support business profiles or templates. For production use, connect your own WhatsApp Business Account.

Deploying to Your Number

Connect WhatsApp (if needed)

If you haven’t already, connect your WhatsApp Business Account.

Open the number

Go to Numbers in the dashboard and click the number you want the agent to answer. (From an agent, Publishing → Manage Numbers takes you to the same place.)

Connect the agent

In Routing, set Mode to Agent: let the connected agent reply, click Connect agent, choose the agent and type its name to confirm.

Each number has one agent. Connecting a new one replaces the old one on every existing conversation, drops any subscribed webhook, and starts fresh sessions.

You're live

The change takes effect immediately. Anyone who messages the number now talks to your agent.

What Happens After Deployment

Once deployed:

New conversations — Anyone messaging your number will chat with your agent
Existing conversations — Switch to the new agent with a fresh session
Routing — The number’s routing mode is agent; any webhook it was routed to stops receiving subscription.message.received

Managing Deployments

Viewing Active Deployments

Numbers lists every number with the agent it’s routed to. From the agent side, the Publishing section on the agent’s page shows the numbers it’s connected to.

Changing Deployments

Open the number, then in Routing click Change agent and pick the new one. The old agent stops replying straight away.

Undeploying an Agent

To stop a number replying without connecting something else, set its Routing mode to No action and click Save routing. Messages are still stored under Conversations, and nothing replies until you connect an agent or a webhook.

Deployment Checklist

Before going live, verify:

Agent Configuration

System prompt is complete and accurate
First message is welcoming and clear
Icebreakers are helpful
Profile picture is set

Testing Complete

Tested common user questions
Verified tool integrations work
Checked edge cases and error handling
Tested on mobile device

Business Profile

Business name is correct
Description is complete
Contact information is accurate
Profile picture is professional

Monetization (if applicable)

Paywall settings configured
Credit limits set appropriately
Payment links working

Promoting Your Agent

Once deployed, share your agent with the world:

QR Code

Every phone number has a WhatsApp QR code. When scanned, it opens a chat with your agent.

Go to your agent’s Deploy section
Click Get QR Code
Download for use in marketing materials

Direct Link

Share a click-to-chat link:

https://wa.me/1234567890?text=Hello!

Replace 1234567890 with your phone number (no plus sign or spaces).

WhatsApp Button

Add a WhatsApp button to your website:

<a href="https://wa.me/1234567890?text=Hi%20there!" 
   target="_blank"
   style="background: #25D366; color: white; padding: 12px 24px; border-radius: 8px; text-decoration: none;">
  Chat on WhatsApp
</a>

Monitoring Your Deployment

After deployment, monitor your agent through:

Dashboard analytics — Message volume, response times
Conversation logs — Review actual conversations
Error alerts — Get notified of issues

See Analytics for detailed monitoring options.

SDK Alternative

Deploy an agent to a phone number programmatically:

import { Wassist } from '@wassist/sdk';

const wassist = new Wassist({ apiKey: process.env.WASSIST_API_KEY });

// The number is E.164 without the leading "+"
await wassist.phoneNumbers.connectAgent('447700900100', {
  agentId,
  applyToExisting: true, // also switch conversations already in progress
});

This works for numbers your organization owns. Sandbox routing has to be set from the dashboard, because API keys can’t route the sandbox.

Start Here

Shopify

Managed Agents

Webhooks

Apps (Alpha)

WhatsApp Numbers

Platforms

Developer Tools

Deployment Options

Test Number

Dedicated Number

Using the Test Number

Deploying to Your Number

What Happens After Deployment

Managing Deployments

Viewing Active Deployments

Changing Deployments

Undeploying an Agent

Deployment Checklist

Promoting Your Agent

QR Code

Direct Link

WhatsApp Button

Monitoring Your Deployment

SDK Alternative

What’s Next

Set Up Analytics

Configure Monetization

​Deployment Options

Test Number

Dedicated Number

​Using the Test Number

​Deploying to Your Number

​What Happens After Deployment

​Managing Deployments

​Viewing Active Deployments

​Changing Deployments

​Undeploying an Agent

​Deployment Checklist

​Promoting Your Agent

​QR Code

​Direct Link

​WhatsApp Button

​Monitoring Your Deployment

​SDK Alternative

​What’s Next

Set Up Analytics

Configure Monetization

Deployment Options

Using the Test Number

Deploying to Your Number

What Happens After Deployment

Managing Deployments

Viewing Active Deployments

Changing Deployments

Undeploying an Agent

Deployment Checklist

Promoting Your Agent

QR Code

Direct Link

WhatsApp Button

Monitoring Your Deployment

SDK Alternative

What’s Next