☰

Help › Tutorials › Desk phone & apps

Set up a desk phone

Plug it in; it finds us.

Video tutorial, 1:22 · English captions · Download the video

A desk phone rings for nobody until someone signs it in. You need the desk phone in front of you and your own AIMERICA login on a computer or a cell.

In this video

Step by step

1
A new desk phone, or one that was signed out, shows Sign in this phone, with a six-digit code and a QR code.
2
Fastest: scan the QR code with your cell's camera. It opens the pairing page, with the code filled in.
3
Or, on your computer or your cell, open the pairing page, signed in with your own login.
4
Only use a code you can see on the desk phone in front of you, never one someone reads or sends you.
5
Owners and admins are asked who will use this phone. For yourself, keep Me.
6
Type the six digits shown on the desk phone.
7
Then tap Sign in the desk phone. If you signed in on this page more than five minutes ago, it asks for your password first.
8
The desk phone then shows your name, and asks: is this you? Tap Yes, sign me in. Not me cancels, and nothing is signed in.
9
Signed in the wrong person? For fifteen minutes, the desk phone's Menu offers Not me? Undo this sign-in, with no password.

Never type a code that someone reads to you or sends you: only a code shown on the desk phone in front of you.

Set up your own Yealink, Poly or Grandstream phone

Give a desk phone you already own one provisioning link, so it sets itself up with your AIMERICA number.

Video tutorial, 1:13 · English captions · Download the video

Open Settings › Me › Desk phone. Under Plug-in-and-go setup, choose the phone brand, add the MAC address if you have it, pick up to six busy lamps, then press Switch on provisioning: you get a QR code and one link to paste into the phone's auto provision field.

In this video

Step by step (9 steps)

1
Your own desk phone's settings are in Settings, under Me. Click Desk phone.
2
The Desk phone card has everything your phone needs.
3
Plug-in-and-go setup gives the phone one link. It then fetches the server, the login, the number, a phone password, park keys and busy lamps by itself.
4
Choose the brand of the phone.
5
Add the MAC address from the label under the phone, if you have it. It is optional.
6
Pick up to six colleagues for busy lamps: a key that lights while they are on a call.
7
Switch on provisioning makes the link, and a phone password that is shown only once. In this demo, we stop here.
8
You then get a QR code and the link, to paste into the phone's auto provision field.
9
Prefer typing it in? The server, the port, the username and the register name are just above.

The phone password is shown only once when provisioning is switched on: keep it somewhere safe.

Enter AIMERICA's SIP settings on your own desk phone

Type the server, username and register name into a desk phone you own, and give it a phone password of its own.

Video tutorial, 1:14 · English captions · Download the video

Open Settings › Me › Desk phone. Type into your phone: the SIP server on port 5060 UDP; as Username, the phone number of the line (one account per number); as Register Name, your AIMERICA email; and as password, your AIMERICA login, or better, a phone password of its own made with Make a phone password (shown once). Once the phone connects, it is listed under the card.

In this video

Step by step (9 steps)

1
To set up your own phone by hand, open Settings, Me, and click Desk phone.
2
The Desk phone card lists everything to type into the phone.
3
First the SIP server, on port 5060, UDP.
4
The username is the phone number of the line. With two numbers, add one account on the phone for each.
5
The register name is your AIMERICA email.
6
The password is your AIMERICA login. Safer: make a phone password of its own. It is shown once, so your login is never typed into a handset.
7
The codecs to allow are listed at the bottom.
8
Once the phone connects, it is listed here. Until then, the page says No desk phone connected yet.
9
Steps for Yealink, Poly and Grandstream, and for encryption with TLS, are in Help, under Set up a desk phone.

A phone password keeps your login out of the handset. Plug-in-and-go setup, on the same page, can also do all of this with one link.

In short

For a phone you already own, open Settings → Desk phone. It shows your username, the server name (sip.a1merica.ai) and lets you set the phone password. The same page can give you a provisioning link: paste it into the phone once and it fetches its whole configuration, busy lamps included.

What to enter, on any brand

Server / registrar: sip.a1merica.ai, port 5060, transport UDP.
Username, register name and authentication name: the username from Settings → Desk phone.
Password: the desk-phone password you set there (not your sign-in password).
Registration (“expires”): 300 to 900 seconds. Longer works too — a phone re-registers on its own schedule after a server restart.
The phone must reach the internet on UDP 5060 and 12000–12800. Most offices need no change.
If the phone shows “registered” but calls have no sound, the office firewall is blocking the audio ports.

Yealink (T3x, T4x, T5x)

Open the phone’s web page (its IP address is under Menu → Status), sign in, then Account → Register.
Line Active: On. Label and Display Name: your name. Register Name and User Name: your username. Password: the desk-phone password.
SIP Server 1: sip.a1merica.ai, Port 5060, Transport UDP, Server Expires 600. Confirm.
Busy lamps: Dsskey → Line Key, Type BLF, Value = the colleague’s extension, Line 1. The key turns red while they are on a call.

Poly (VVX, Edge E)

Open the phone’s web page (Settings → Status → Platform → Phone shows the IP), sign in as Admin, then Settings → Lines → Line 1.
Display Name: your name. Address, Auth User ID: your username. Auth Password: the desk-phone password.
SIP Server 1: Address sip.a1merica.ai, Port 5060, Transport UDPOnly, Expires 600. Save.
Busy lamps: with the provisioning link the keys are set for you; by hand they are the line keys marked BLF (called “Enhanced Feature Keys” on older firmware).

Grandstream (GXP, GRP)

Open the phone’s web page (Menu → Status → Network shows the IP), sign in, then Accounts → Account 1 → General Settings.
Account Active: Yes. Account Name and Name: your name. SIP Server: sip.a1merica.ai. SIP User ID and Authenticate ID: your username. Authenticate Password: the desk-phone password.
Account 1 → SIP Settings → Basic Settings: SIP Transport UDP, Register Expiration 10 (minutes). Save and Apply.
Busy lamps: Settings → Programmable Keys → Multi-Purpose Keys, Mode BLF, Account 1, Value = the colleague’s extension.

Encrypted connection (SIP over TLS and SRTP)

Every current phone can encrypt both the signalling and the audio. Use it whenever the phone sits outside the office or on Wi-Fi. There is nothing to install: the server presents the a1merica.ai certificate (Let’s Encrypt), which phones trust out of the box.

Server sip.a1merica.ai, port 5061, transport TLS. The phone must reach TCP 5061 as well as UDP 12000–12800.
Audio encryption (SRTP): set it to optional / “enabled but not forced”. Compulsory works too — we answer with SRTP whenever the phone asks for it.
Yealink: Account → Register → Transport TLS, Port 5061; Account → Advanced → RTP Encryption (SRTP): Optional.
Poly: Settings → Lines → Line 1 → SIP Server 1 → Transport TLS, Port 5061. Most firmware has no SRTP switch on the web page: import a two-line configuration file (Utilities → Import & Export Configuration) with sec.srtp.enable="1" and sec.srtp.offer="1".
Grandstream: Account 1 → SIP Settings → Basic Settings → SIP Transport TLS; Account 1 → Audio Settings → SRTP Mode: Enabled but not forced.

A padlock on the phone’s screen (Yealink and Grandstream show one on the line) means both ends are encrypted. Phones already on UDP keep working; nobody has to change.

Was this not what you needed? Write to us.