# Send Cloud Voice App Login Credentials to Users

Once you have enabled the Cloud Voice App for your users, they still need their sign-in details before they can start using it. You have two ways to hand those details over: send an automated welcome email for one-tap login, or share the account information so users can sign in manually.

:::tip
The welcome email is the easiest path for most users, because it signs them in with nothing to type. Reach for the manual details only when a user cannot receive or open the email.
:::

## Send welcome emails for quick login

For most users, a welcome email is the fastest route in. Each email carries a login QR code (QR stands for Quick Response, the square barcode you scan with a phone camera) and a login link that take the user straight into the Cloud Voice App with nothing to type.

### Before you begin

- **Email delivery**: Confirm that the system email server is configured and sending mail correctly.
- **Extension setup**:
  - Each target extension has an email address on file.
  - Each target extension has at least one [Cloud Voice App client enabled](/pbx/cloud-voice-app-server-admin-guide/enable-or-disable-cloud-voice-app-clients-for-a-user/#enable-linkus-clients-for-users__section_chk_pm4_qmb).

:::caution
Both requirements are easy to miss. If the system email server is not set up, or an extension has no email address on file, the welcome email will not go out and the user simply receives nothing. Check both before you rely on this method.
:::

### Send the emails

1. Sign in to the PBX (Private Branch Exchange, your phone system's admin portal) web portal and open **Extension and Trunk > Extension**.
2. Select the checkbox for each extension you want to notify, then click **Welcome Email** above the extension list.

Every selected user receives a welcome email. They can scan the QR code or tap the login link to open the Cloud Voice App already signed in.

:::caution
The QR code and the login link each work only once. If a user needs another try after the first use, send a fresh welcome email.
:::

![Cloud Voice, scanning the welcome-email QR code to sign in on the mobile app](/images/pbx/mobile-login-scan-code-new.gif)

![Cloud Voice, tapping the welcome-email login link to sign in on the mobile app](/images/pbx/mobile-login-copy-link-new.gif)

![Cloud Voice, using the welcome-email login link to sign in on the desktop app](/images/pbx/desktop-copy-link-to-login.gif)

![Cloud Voice, using the welcome-email login link to sign in on the web app](/images/pbx/web-click-link-to-login-cloud.gif)

## Share login details for manual sign-in

If a welcome email never reaches a user, or they cannot get to their inbox, give them the details to sign in by hand instead.

Provide the following:

- The PBX domain name (this is the network address of your Cloud Voice App server that the client connects to)
- Their username, either the extension number or the email address, depending on the [login mode](/pbx/cloud-voice-app-server-admin-guide/configure-cloud-voice-app-client-login-mode/) you have set
- The extension's user password

:::note
The username must match the login mode you configured. If the mode expects an extension number and the user enters an email address (or the reverse), the sign-in is rejected. Tell the user which one to use.
:::

With these in hand, users can type the details directly into the Cloud Voice App to sign in.

:::caution
An extension's password lets that account place calls on your system. Send it over a secure channel and avoid leaving it sitting in email or chat threads. Leaked credentials are a toll-fraud risk.
:::

![Cloud Voice, entering the domain name, username, and password to sign in on the mobile app](/images/pbx/log-in-with-cloud-domain-name.png)

![Cloud Voice, entering account details manually to sign in on the desktop app](/images/pbx/log-in-with-cloud-domain-name-desktop.png)

![Cloud Voice, entering account details manually to sign in on the web app](/images/pbx/log-in-with-cloud-domain-name-web.png)
