# Voice Logica numbers

> **If you only see Add SIP trunk:** On some workspaces **Channels - Telephony** shows **No SIP trunk yet** and **+ Add SIP trunk** instead of **Get your free Phone Number**. That is expected - start with [Get a number](https://docs.voicelogica.ai/telephony/) and [Your own carrier](https://docs.voicelogica.ai/telephony/your-own-carrier/). This page is for plans that expose the free Voice Logica DID controls.
Use this path when your plan offers a Voice Logica number and you do **not** already have a SIP trunk. You still attach it on the agent - a DID sitting on the company is silent until **Channels - Telephony** says this agent answers it.

Onboarding's test number is separate. Customers never dial the PIN line.

  <ShotPlaceholder
    src="/assets/telephony/agent-telephony.png"
    name="agent-telephony"
    alt="Agent Channels → Telephony — assign or connect a number"
    capture="Agent editor → Channels → Telephony. 1600×900. Banner + Get your free Phone Number or Connect existing. Redact any DID."
  />

## When which button appears

Which button you see on **Channels → Telephony** depends on the plan. If **Get your free Phone Number** is missing, you are on Demo or the free DID is already used.

- **Get your free Phone Number** — The company has not used its one free number. Click this. One free number per company — not per agent.
- **Activate Subscription** — No production DID on Demo. [Activate your subscription](https://docs.voicelogica.ai/getting-started/activate-subscription/) first. The button goes to billing, not to Yuboto.
- **Connect existing number** — The company already requested or assigned its free number. The tab says so (it can show the number). Connect that DID, buy another from **Subscription & Billing**, or [add your own carrier](https://docs.voicelogica.ai/telephony/your-own-carrier/).

The tab is hidden until the agent is saved, and you need **phones** access. If you do not see **Telephony** under **Channels**, you are on a new unsaved agent or your role cannot edit phones.

## First setup — assign the free DID and prove it

Do this on the onboarding agent after [Your First Agent](https://docs.voicelogica.ai/getting-started/your-first-agent/) sounds right.

1. **Open the agent → Channels → Telephony**

   No trunk yet is expected. The assign flow creates the Voice Logica side for you.

2. **Click Get your free Phone Number**

   Greece companies: enter the **Owner's email address**, confirm, then **Open Assignment Link** and finish the Yuboto form.

   Companies outside Greece are sent to **Add SIP trunk** on this same tab — Voice Logica is still the path, but you connect through a trunk instead of the Greece order form.

     <ShotPlaceholder
       src="/assets/telephony/voice-logica-numbers-dialog.png"
       name="voice-logica-numbers-dialog"
       alt="Get your free Phone Number assignment"
       capture="Agent → Channels → Telephony → Get your free Phone Number. Greece: Owner's email + Open Assignment Link. Outside Greece: Add SIP trunk on this tab. 1600×900. Redact numbers/emails/PINs."
     />

3. **Finish the form, then come back and refresh**

   The number appears on a trunk once Yuboto activates it. If the tab still says the free number was requested and will appear once activated, wait and refresh — do not click assign again.

4. **Confirm this agent answers it**

   The trunk row should show that a number **reaches this agent**, or **Answers unrouted calls**. If the DID landed on the company but not here, use **Connect a number** on the trunk row.

5. **Call the new number from your mobile**

   Not the test PIN. Open **Calls**. If nobody answers, the number is on a different agent, the trunk is **Disabled**, or activation is still pending.

     <ShotPlaceholder
       src="/assets/telephony/voice-logica-numbers-prove.png"
       name="voice-logica-numbers-prove"
       alt="Calls after dialing the new Voice Logica number"
       capture="Call the new DID from a mobile (not the test PIN). Sidebar → Calls → History. 1600×900. Redact numbers/emails/PINs."
     />

6. **Leave Routing alone**

   One DID on one trunk does not need an inbound override. [Routing](https://docs.voicelogica.ai/telephony/routing/) is for a *second* number that should land somewhere else.

> **One agent per number:** Only one agent answers a given number. Enabling it here takes it off whoever had it — immediately, no Save.
## What the minutes pay for

- **Inbound** to a Voice Logica number uses **AI minutes** on the plan.
- **Outbound** (campaigns, and most transfers to a phone) also uses **VoIP credits** at Yuboto. Top up at the [Yuboto My Number](https://services.yuboto.com/mynumber/) before you dial out or transfer.

A transfer to *another Voice Logica agent* does not spend VoIP credits.

## After the number is live

Put it on the website, email signatures, and listings. **Live on** in the editor header should show at least one telephony channel.

Then [Transfer](https://docs.voicelogica.ai/telephony/transfer/) if a human should take leftovers — not before the DID answers.

## Troubleshooting

**I do not see Get your free Phone Number**

Work through this list:

1. The plan is still Demo — the button is **Activate Subscription**.
2. The free DID is already used — the button is **Connect existing number**.
3. The tab is still loading plan status — refresh once after you subscribe.
4. You are on a different agent than the one you expect, or **Channels → Telephony** is hidden (unsaved agent).

Otherwise connect an existing number or [add a trunk](https://docs.voicelogica.ai/telephony/your-own-carrier/).

**The number is assigned but nobody answers**

It is on a different agent, the trunk is **Disabled**, or activation has not finished. Open **Channels → Telephony** on the agent you expect. Open **Telephony → Routing → Inbound** only if this DID is supposed to override the trunk default.

**Outbound or transfer fails with insufficient_balance_in_voip_provider**

Yuboto credits are empty. Add funds, then retry. The reason is on **Calls**.

**Can each agent get its own free number?**

No. One free number per *company*. Extra DIDs are purchased, or you [bring your own carrier](https://docs.voicelogica.ai/telephony/your-own-carrier/).

## Next Steps

[Forward your number](https://docs.voicelogica.ai/telephony/forward-your-number/) — keep your existing number and forward it to the agent.  
[Your own carrier](https://docs.voicelogica.ai/telephony/your-own-carrier/) — keep numbers you already have.  
[Transfer](https://docs.voicelogica.ai/telephony/transfer/) — after this DID rings.  
[Outbound campaigns](https://docs.voicelogica.ai/outbound-calls/campaigns/) — outbound also spends VoIP credits.
