> For the complete documentation index, see [llms.txt](https://docs.pascom.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.pascom.net/en/user/pascom-app-userguide/pairing.md).

# Mobile App Pairing

Learn how to pair the PASCOM mobile app with your desktop application to stay professionally reachable even when you're on the move.

To log in to the PASCOM mobile app, a one-time pairing process is required. During this process, the PASCOM mobile app is linked to the desktop application. This can either be prepared by your system administrator or – with the appropriate permissions – performed directly by yourself.

## The Pairing Process

In a few simple steps, you can connect your mobile device with the PASCOM app. This process is only required once. After successful pairing, the mobile app can be used permanently and independently of the desktop application.

1. Open the **Settings** in the PASCOM app via the gear icon.
2. Navigate to the menu item **My Devices**.
3. Click on the **Pair** button.

![Menu navigation in the PASCOM app to start device pairing via the settings.](https://2713225-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVIw0BpSv358R2Pr2HflD%2Fuploads%2Fgit-blob-e27f9e5e0ef56e4076bd9d100839837dfed441fe%2Fpascom-app-start-pairing.en.png?alt=media)

A QR code will now appear on your screen, ready to be scanned with your mobile device.

![Display of the generated QR code in the desktop app for the scanning process.](https://2713225-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVIw0BpSv358R2Pr2HflD%2Fuploads%2Fgit-blob-c2e1dfedda525688dea186910335e08a60c96d41%2Fpascom-app-qrcode.en.png?alt=media)

1. Download the **PASCOM Mobile App** from the corresponding store for your smartphone and install it.
2. Start the **PASCOM Mobile App** on your smartphone.
3. Tap on **Start Mobile Pairing**.

![Start screen of the PASCOM mobile app with the option for pairing.](https://2713225-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVIw0BpSv358R2Pr2HflD%2Fuploads%2Fgit-blob-8a176e6c6432fa820cf349adc15935a4a2b6832d%2Fmobile-start-pairing.de.png?alt=media)

1. Accept the license terms.
2. Grant the PASCOM app the necessary permissions for smooth operation.

{% hint style="info" %}
You can also grant permissions individually, but you should expect limited functionality of the app if critical access is missing.
{% endhint %}

![Overview of the necessary app permissions for telephony and notifications.](https://2713225-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVIw0BpSv358R2Pr2HflD%2Fuploads%2Fgit-blob-6adf12b34016d2a1eeb0a6fa78c303d91781ff3f%2Fmobile-permissions.de.png?alt=media)

1. Tap on **Start Mobile Pairing** again to activate your smartphone's camera.
2. Scan the QR code displayed on your desktop application.

![Camera view in the mobile app for scanning the QR code.](https://2713225-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVIw0BpSv358R2Pr2HflD%2Fuploads%2Fgit-blob-b7dcc32d80ec4c2d13097ac797c56d507a61389f%2Fmobile-scan-qrcode.de.png?alt=media)

After a successful scan, the mobile app requires your private mobile number for full setup.

{% hint style="info" %}
Your private mobile number is required exclusively for **GSM fallback**. If you do not have a stable data connection (WLAN/LTE), the PASCOM mobile app will deliver calls via the classic mobile network. Your business office number will still be signaled to the outside world.
{% endhint %}

![Input field for the mobile phone number for configuring GSM fallback.](https://2713225-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVIw0BpSv358R2Pr2HflD%2Fuploads%2Fgit-blob-0361bc096acbfc83b3827d87875c97f38c0969f8%2Fmobile-number-for-gsm.de.png?alt=media)

The mobile app now completes the connection to the PASCOM infrastructure. Once the setup is finished, you will be automatically redirected to the main view of the app.

![Confirmation of the successful connection between the smartphone and the PASCOM system.](https://2713225-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVIw0BpSv358R2Pr2HflD%2Fuploads%2Fgit-blob-916c8b47f00b755378f794bdb1bb7464322bb64f%2Fpairing-done.de.png?alt=media)

The process is then also completed in the desktop application. You can close the window by clicking on **Done**.

![Closing screen of the pairing process in the desktop application.](https://2713225-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVIw0BpSv358R2Pr2HflD%2Fuploads%2Fgit-blob-da42328c970c93b20eb6a58f15c16da1fbaadd05%2Fpascom-app-pairing-done.en.png?alt=media)

## Manual Pairing

If scanning the QR code is not possible, you can bypass the scanning process and authenticate manually.

To do this, tap on **Manual Pairing** before the scan. Enter your **Username**, **Password**, and the server address (default is **pascom.cloud**) in the corresponding fields.

![Option for manual login using username and password.](https://2713225-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVIw0BpSv358R2Pr2HflD%2Fuploads%2Fgit-blob-0628c37c885821fbc75a0f94e6ef7c27a3704948%2Fmanual-pairing.de.png?alt=media)

## Proxy Server Settings

In corporate networks, the use of a proxy server between the PASCOM app and the internet may be required to meet security policies or manage network restrictions.

If necessary, enter the following data in the advanced settings:

* **Server:** The address of your proxy server.
* **Port:** The port of the proxy (default is 3128).
* **Username/Password:** Your personal credentials for proxy access.

![Pairing with Proxy Server](https://2713225-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVIw0BpSv358R2Pr2HflD%2Fuploads%2Fgit-blob-979de8b0ea07c0f7fc4c1dd078b1765e636837dc%2Fproxy-settings-for-pairing.de.png?alt=media)

## Troubleshooting: Double Mobile Number

If an error message regarding a mobile number that has already been assigned appears, this is due to the system architecture of the GSM fallback. A mobile phone number can only be linked to exactly one active mobile device systems-wide at any time.

## Setting up Mobile Integration

Information for administrators regarding server-side configuration can be found in the guide on [Mobile Integration](/en/setup/endpoints/mobile-integration.md).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.pascom.net/en/user/pascom-app-userguide/pairing.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `build a script that syncs our docs to a CMS` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
