# Phone numbers and SIP credentials

> How voicast handles phone numbers, and how to issue the credentials (username and password) a PBX or cloud PBX uses to send calls over SIP, in the dashboard.

Source: https://voicast.jp/en/docs/dashboard-sip

## Phone numbers

voicast doesn't sell or manage phone numbers, and the dashboard has no phone number page. Get numbers and lines from your phone service (Twilio, a cloud phone system, a PBX and so on) and connect calls from there to voicast. See [Phone](https://voicast.jp/en/docs/phone.md) for how.

| How you connect | What you set up in the dashboard |
| --- | --- |
| Twilio Media Streams | The tenant's connection secret ([Tenants](https://voicast.jp/en/docs/dashboard-tenants.md)) |
| Other audio senders | The tenant's connection secret |
| SIP from a PBX or cloud PBX | The tenant's SIP credentials (this page) |

## Add a SIP credential

Requires the developer role or above.

1. Press **Edit** on the tenant in the **Tenants** list.
2. Under **SIP credentials**, press **+ Add a credential**.
3. Fill in the settings below and press **Add**.
4. Set the destination, realm, username and password that appear on your PBX.

| Setting | What |
| --- | --- |
| Credential name | A name to tell the PBX apart (optional) |
| Agent | The agent for calls received with this credential. Leave **The tenant's agent** to use the agent chosen for the tenant |
| Transfer to | When the AI hands the call to staff, the PBX transfers it here (REFER). An extension number or a SIP URI (`sip:…`). Leave empty to hang up without transferring |

The password is shown only once, when the credential is added. Set it on your PBX right away; you can't see it again after closing.

Values to set on the PBX:

| Value | What |
| --- | --- |
| Destination | `sip.voicast.jp` (UDP and TCP 5060, TLS 5061) |
| Authentication | Digest (realm `voicast`) |
| Encrypted audio | SRTP supported |

A tenant can have any number of credentials.

## Change a credential

Press **Edit** in the **SIP credentials** list, change the name, agent or transfer target, and press **Save**. The username and password don't change.

## Delete a credential

Press **Remove** in the **SIP credentials** list, then **Remove** in the confirmation dialog. Calls using this credential are refused right away. To change the password, add a new credential, then delete the old one.
