# phone.systems(TM) App Integration Protocols

Integration protocols are predefined rules that enable seamless communication between applications. In
phone.systems(TM), these URL-based commands let systems, scripts, or users perform specific actions such as initiating
calls, entering numbers in the dial pad, or authenticating the app.

Benefits of integration protocols:
:   - Automate repetitive tasks to save time and reduce errors.
    - Enable one-click actions to boost productivity.
    - Link the phone.systems(TM) app with other tools to create custom workflows.
    - Simplify user experience by reducing manual steps.

For example, a **CRM system** can use these protocols to initiate calls directly from a customer's profile. They can
also be embedded in links, emails, or scripts to streamline communication workflows.

---



## phone.systems(TM) App Supported URL Protocols

The phone.systems(TM) app supports both **industry-standard** and **custom URL protocols** for initiating calls and
performing app-specific functions.



### Industry-Standard Protocols

The following protocols are commonly used for initiating calls through web links:

> Supported Industry Protocols
>
>
>
>
>
> | **Protocol URL** | **Description** | **Example** |
> | --- | --- | --- |
> | ``` callto:some_number ``` | Used to initiate a call using a hyperlink. | <callto:12124613663> |
> | ``` tel:some_number ``` | Used to initiate a call using a hyperlink. | <tel:12124613663> |

### phone.systems(TM) Custom URL Protocols

In addition to standard protocols, phone.systems(TM) provides unique URL-based protocols for extended functionality:

> phone.systems(TM) Unique Protocols
>
>
>
>
>
> | **Protocol URL** | **Description** | **Example** |
> | --- | --- | --- |
> | ``` phone.systems://dialpad?number=some_number ``` | Opens the dial pad with a pre-filled number. | [Open Dialpad](phone.systems://dialpad?number=12124613663) |
> | ``` phone.systems://call?number=some_number ``` | Initiates a call using the phone.systems(TM) app. | [Initiate Call](phone.systems://call?number=12124613663) |
> | ``` phone.systems://authenticate?code=some_code ``` | Authenticates the phone.systems(TM) app with a provided code. | [Authenticate](phone.systems://authenticate?code=3:eyJhbGciOiJIUzg1NiJ9.eyJzdWIiOiI5ZWYyNTBmNy0wYzBjLTQ2OTYtYmRkZSf2MTNjYjlhN2VlZTQiLCJleH8iOjE3MzUyMDIzMTN9.UZdvuLdB1nSAKI45MXgQOFG3WF8jpGA-QNb6OcVhjwc) |

Note

phone.systems(TM) URL protocols are considered deep links and must be clickable to function properly. When pasted into a
browser's search bar, the URL can be automatically modified, typically by adding a `https://` prefix, which may result
in an incorrect URL. To avoid this issue, ensure the URLs are clicked to open the app, rather than being pasted directly
into a browser's address bar.

---

## Setting phone.systems(TM) as the Default App

To use URL protocols, set phone.systems(TM) as the default app for handling tel and callto protocols. Follow the steps
for your operating system:

### macOS

To set phone.systems(TM) for `tel` or `callto` protocols:

> 1. Open **FaceTime**.
> 2. Go to **Preferences**.
> 3. In **Default for calls**, select **phone.systems(TM)**.
>
> Tip
>
> If **phone.systems(TM)** does not appear in the dropdown, ensure the app is installed and up to date. Alternatively, use a third-party tool like **RCDefaultApp** to assign the `callto` protocol to **phone.systems(TM)**.

### Windows

To set phone.systems(TM) for `tel` or `callto` protocols:

> 1. Open **Settings**.
> 2. Go to **Apps > Default Apps**.
> 3. Select **Choose default apps by protocol**.
> 4. Assign **phone.systems(TM)** to the `tel` and `callto` protocols.

### Android

To enable all supported protocols:

> 1. Open the phone.systems(TM) app **Settings**.
> 2. Select **Open by default**.
> 3. Under **Supported links**, choose **phone.systems(TM)**.

### iOS

To set phone.systems(TM) for the `tel` protocol:

> 1. Use the Safari browser.
> 2. Long press a link with the `tel` protocol.
> 3. Select **phone.systems(TM)** as the app.
>
> Important
>
> - The tel protocol does not work in Chrome on iOS. Use **Safari** instead.
> - For other protocols use **Chrome** Browser.

On this page