After you add a person, give their extension a way to ring: an app, a desk phone, or both. This article is the overview. The app articles cover the person's side.

Add an app

  1. In the menu, click People, then click the person's name.
  2. On their extension card, click Add device or app.
  3. Choose one:
    • Telephonica app · iPhone
    • Telephonica app · Android
    • Telephonica app · Mac
    • Telephonica Teams · Windows (the Desktop App)
  4. Optional: type a Device label (optional), for example "Laptop".
  5. Click Add app.

The app now appears on the extension card. An extension can have more than one app. Adding a new one does not stop the others.

Connect the Mac app

The Mac app signs in with a token instead of a QR code.

  1. On the person's Mac, install the Telephonica app from the Mac App Store.
  2. In the portal, open the Mac app's device page, click Show sign-in details, then Show token, and click Copy.
  3. In the Telephonica app on the Mac, paste the token into Token (UUID) and choose PROVISION.

The token keeps working until you replace the sign-in details, so keep it private. The person can also use the setup page sent by Send phone setup instructions.

Add a desk phone

You can use any standard SIP IP phone. If you don't see your model in Template, contact support before you add it.

  1. On the person's extension card, click Add device or app.
  2. Choose Desk phone.
  3. Enter the phone's MAC address. It is printed on a label under the phone.
  4. Pick the phone model in Template.
  5. Click Add phone.

Send the setup instructions

The person still has to sign in to each app. The simplest way is the setup email:

  1. On the People page, click Send phone setup instructions.
  2. Tick the people to send it to, then click Preview.
  3. Check the email, then click the send button, for example Send 3 phone setup emails.

Each person gets an email with download links for their apps and an Open my setup page button. On that page they confirm their email with a 6-digit code, then sign in each app: phones scan a QR code, the Desktop App on Windows uses a computer code, and the Mac app uses a token. The email contains no passwords.

On the person's side

Prefer to watch? This video shows the Telephonica app on iPhone, Android and Mac: installing it, signing in and everyday calls.

If it doesn't work

Symptom Likely cause What to do
Someone is missing from the setup email list They have no email address or no device yet Add an email (Edit details on their page) and at least one app or phone.
The setup page says the link no longer works The private link expired Send the phone setup instructions again.
The app shows Not connected in the portal The person has not signed in yet Ask them to open the setup page, or use Sign in next to the app.
A desk phone does not connect Wrong MAC address or template, or the phone needs setup on its side Check both on the Devices & apps page. If it still fails, contact support with the phone model.