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

# Voicebot Installation

> Connect your voicebot to a phone number and make it reachable for callers

## Introduction

After you have tested your voicebot in the Playground and assigned a phone number, it is ready to receive real calls. The assigned number is the direct line to your AI agent: when someone calls it, the voicebot answers with your configured first message and uses the same knowledge base as your chat agent.

You can make the voicebot reachable in two simple ways:

* **Use the assigned number directly** — publish the number on your website, contact page, help center, email signature, or other customer-facing material.
* **Forward your own number** — keep an existing business or local number and configure your phone system to forward calls to the assigned Cosmo number.

<Note>
  Call forwarding is supported by many phone systems, but the exact setup depends on your provider, PBX, or telecom configuration. We cannot document every phone system, but forwarding to the assigned Voicebot number is possible whenever your provider supports call forwarding.
</Note>

## Basic Installation Steps

<Steps>
  <Step title="Assign a Phone Number">
    Go to **Agent Settings → Voicebot** and select the phone number that should connect callers to this voicebot.
  </Step>

  <Step title="Test the Voicebot">
    Use the Voicebot Playground first, then place a real test call to confirm the greeting, voice, and answers feel right.
  </Step>

  <Step title="Choose How Callers Reach It">
    Decide whether to show the assigned number directly or forward an existing number to it.
  </Step>

  <Step title="Publish or Forward the Number">
    Add the assigned number to your customer-facing channels, or configure call forwarding in your phone system.
  </Step>
</Steps>

## Using the Assigned Number Directly

This is the fastest setup. Once the number is assigned to the voicebot, you can place it anywhere customers expect to find a phone contact option.

Common places include:

* Website header or footer
* Contact page
* Help center
* Booking or support pages
* Email signatures
* Printed material or QR-code destinations

## Forwarding Your Own Number

If you already have a public business number, you can keep using it. Configure that number to redirect or forward calls to the phone number assigned to your Cosmo Voicebot.

This is useful when you want callers to keep dialing a familiar number while the voicebot handles the conversation in the background.

<Tip>
  After enabling forwarding, call your public number from an external phone and confirm that the voicebot answers. This verifies both your phone-system forwarding and the Cosmo Voicebot configuration.
</Tip>

## Related Pages

<CardGroup cols={2}>
  <Card title="Phone Numbers" icon="sim-card" href="/voicebot/phone-numbers">
    Purchase, manage, and assign phone numbers for your voicebot agents.
  </Card>

  <Card title="Voicebot Playground" icon="flask" href="/voicebot/playground">
    Test responses before making the number available to callers.
  </Card>
</CardGroup>
