# Phones

## Phones Introduction

Replica supports two phone offerings:

* **Physical Phones**: An optional add-on that provides one or more real Android phones you can control from Replica.
* **Virtual Phones**: Software-based calling and messaging features tied to assigned phone numbers.

Use the sections below to understand which workflow applies to your setup.

{% hint style="info" %}
Phone features depend on your organization's subscription and configuration.
{% endhint %}

## Physical Phones

Physical Phones are an optional add-on. They add one or more real Android phones to the platform so you can control them from Replica.

Physical Phones are made available through a special enclave provided for that purpose.

### Launch a Physical Phone

To launch a Physical Phone, create a Virtual Environment and complete both of these connectivity steps:

* Attach the phone enclave.
* Add the `phone network` private route.

After the environment is ready, launch it to access the attached physical device.

## Virtual Phones

Virtual Phones extend Virtual Environments and Profiles with calling and messaging features. They are commonly used for workflows such as two-factor authentication.

To get phone numbers assigned, contact your administrator. Manage assigned numbers from the **Phones** section. Use them inside a Virtual Environment from the `SMS` icon in the overlay. For usage details, see [SMS Messaging](/user-guide/virtual-environments.md#sms-messaging).

### View Virtual Phone Numbers

Open **Phones** from the left-hand menu to see the phone numbers available to you.

You will see cards for numbers assigned to you directly or indirectly through a profile or group.

* **Provider**: The Software Defined Telephony (SDT) provider, such as Twilio or Bandwidth, or an SMS Device. **SMS Device** means the number is tied to a physical device.
* **Number**: The phone number in international `E.164` format.
* **Name**: A label that identifies the number's purpose.
* **Number Is**: Shows whether the number is active.
* **Call Forwarding No.**: *(Optional, Twilio only)* Inbound calls to **Number** are forwarded to this number. The caller does not see the forwarding destination. If this field is empty, inbound calls to **Number** return a busy tone. If you call the Replica number from the configured forwarding number, a service answers and prompts you for the number to dial. The outbound call then appears to come from **Number**, not the forwarding number.
* **Assignee**: The assigned user, group, or profile. In environments assigned to a profile, you can access numbers assigned to that profile while using that environment. In all other environments, you can access numbers assigned directly to you or through a group.
* **Is Use As Relay**: *(Administrator feature)* Shows whether an SDT provider number is acting as a relay for an SMS Device and which numbers it supports.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.replicacyber.com/user-guide/phones.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.