Skip to main content
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 agent has access to Wassist’s shared test number. To use it:
  1. Open your agent in the editor
  2. Click Test Agent in the top right
  3. Scan the QR code with WhatsApp
  4. Start chatting
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

1

Connect WhatsApp (if needed)

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

Open Your Agent

Go to your dashboard and click on the agent you want to deploy.
3

Go to Deployment Settings

Click the Deploy tab or button in the agent editor.
4

Select Phone Number

Choose which phone number to deploy to:
  • See all available numbers from your connected WABAs
  • Each number can only have one active agent
If a number already has an agent, deploying a new agent will replace it.
5

Confirm Deployment

Click Deploy to make your agent live. The change takes effect immediately.

What Happens After Deployment

Once deployed:
  1. New conversations — Anyone messaging your number will chat with your agent
  2. Existing conversations — Active conversations continue with the new agent
  3. Webhook updates — All WhatsApp webhooks route to your deployed agent

Managing Deployments

Viewing Active Deployments

To see where your agents are deployed:
  1. Go to SettingsWhatsApp Accounts
  2. Click on an account to see its phone numbers
  3. Each number shows which agent (if any) is deployed
Or view from the agent side:
  1. Open any agent
  2. The Deployment section shows connected numbers

Changing Deployments

To swap which agent is on a number:
  1. Open the new agent you want to deploy
  2. Deploy it to the number
  3. The old agent is automatically undeployed

Undeploying an Agent

To remove an agent from a number without replacing it:
  1. Go to SettingsWhatsApp Accounts
  2. Click on the account and number
  3. Click Remove Agent
The number will no longer respond to messages until you deploy another agent.

Deployment Checklist

Before going live, verify:
  • System prompt is complete and accurate
  • First message is welcoming and clear
  • Icebreakers are helpful
  • Profile picture is set
  • Tested common user questions
  • Verified tool integrations work
  • Checked edge cases and error handling
  • Tested on mobile device
  • Business name is correct
  • Description is complete
  • Contact information is accurate
  • Profile picture is professional
  • 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.
  1. Go to your agent’s Deploy section
  2. Click Get QR Code
  3. Download for use in marketing materials
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:
// Deploy agent to a phone number
const updatedAgent = await client.agents.deploy(agentId, {
  phoneNumberId: 'phone-number-uuid',
});

console.log(`Deployed to: ${updatedAgent.phoneNumbers[0].phoneNumber}`);

// Or deploy via WhatsApp account
await client.whatsappAccounts.deployAgent(wabaId, {
  agentId: agentId,
  phoneNumberId: 'phone-number-uuid',
});

What’s Next