> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wassist.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Deploy Your Agent

> Make your agent live on a WhatsApp phone number

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

## Deployment Options

<CardGroup cols={2}>
  <Card title="Test Number" icon="flask">
    **Free, shared Wassist number**

    * Great for testing and demos
    * No setup required
    * Shared with other Wassist users
    * Limited features
  </Card>

  <Card title="Dedicated Number" icon="phone">
    **Your own WhatsApp Business number**

    * Your brand, your number
    * Full WhatsApp Business features
    * Message templates
    * Business profile
  </Card>
</CardGroup>

## 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

<Note>
  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.
</Note>

## Deploying to Your Number

<Steps>
  <Step title="Connect WhatsApp (if needed)">
    If you haven't already, [connect your WhatsApp Business Account](/guides/connect-whatsapp).
  </Step>

  <Step title="Open Your Agent">
    Go to your [dashboard](https://wassist.app/agents) and click on the agent you want to deploy.
  </Step>

  <Step title="Go to Deployment Settings">
    Click the **Deploy** tab or button in the agent editor.
  </Step>

  <Step title="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

    <Warning>
      If a number already has an agent, deploying a new agent will replace it.
    </Warning>
  </Step>

  <Step title="Confirm Deployment">
    Click **Deploy** to make your agent live. The change takes effect immediately.
  </Step>
</Steps>

## 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 **Settings** → **WhatsApp 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 **Settings** → **WhatsApp 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:

<AccordionGroup>
  <Accordion title="Agent Configuration" icon="gear">
    * [ ] System prompt is complete and accurate
    * [ ] First message is welcoming and clear
    * [ ] Icebreakers are helpful
    * [ ] Profile picture is set
  </Accordion>

  <Accordion title="Testing Complete" icon="check-double">
    * [ ] Tested common user questions
    * [ ] Verified tool integrations work
    * [ ] Checked edge cases and error handling
    * [ ] Tested on mobile device
  </Accordion>

  <Accordion title="Business Profile" icon="building">
    * [ ] Business name is correct
    * [ ] Description is complete
    * [ ] Contact information is accurate
    * [ ] Profile picture is professional
  </Accordion>

  <Accordion title="Monetization (if applicable)" icon="dollar-sign">
    * [ ] Paywall settings configured
    * [ ] Credit limits set appropriately
    * [ ] Payment links working
  </Accordion>
</AccordionGroup>

## 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

### 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:

```html theme={null}
<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](/guides/analytics) for detailed monitoring options.

## SDK Alternative

Deploy an agent to a phone number programmatically:

```typescript theme={null}
// 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

<CardGroup cols={2}>
  <Card title="Set Up Analytics" icon="chart-line" href="/guides/analytics">
    Monitor your agent's performance.
  </Card>

  <Card title="Configure Monetization" icon="dollar-sign" href="/guides/monetization">
    Start generating revenue.
  </Card>
</CardGroup>