> 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/setup/endpoints/hardware-phones-ringtone.md). # Klingeltöne für Hardware-Telefone Richten Sie individuelle Klingeltöne für Ihre Hardware-Telefone abhängig von Anrufer oder Routing ein. Mit individuellen Klingeltönen (**Distinctive Ringing**) können Sie festlegen, mit welcher Melodie oder Signalton ein Hardware-Telefon bei eingehenden Anrufen läutet. So erkennen Ihre Mitarbeiter sofort am Klingeln, ob es sich beispielsweise um einen wichtigen **VIP-Kunden**, einen Anruf aus einer bestimmten **Warteschlange** oder einen internen Kollegen handelt. ## Funktionsweise PASCOM nutzt für die Steuerung der Klingeltöne den SIP-Standard-Header `Alert-Info`. 1. In PASCOM definieren Sie eine Aktion **Klingelton setzen** vor dem eigentlichen Rufaufbau (z.B. im Anrufverteiler, beim Benutzer oder im Team). 2. In dieser Aktion hinterlegen Sie ein eindeutiges Schlagwort (z. B. `VIP` oder `CustomRingtone`). 3. Bei einem eingehenden Anruf überträgt PASCOM diesen Wert im SIP-Header `Alert-Info` an das Telefon: `;info=CustomRingtone;x-line-id=0`. 4. Das Hardware-Telefon gleicht den übermittelten Text mit seiner internen Klingelton-Tabelle ab und spielt den zugewiesenen Klingelton ab. {% hint style="info" %} Wird keine Aktion gesetzt oder bleibt das Feld leer, greift automatisch das Standard-Verhalten von PASCOM (Unterscheidung zwischen internen Anrufen, externen Anrufen und Gegensprechen). {% endhint %} ## Schritt 1: Aktion in PASCOM einrichten Die Aktion **Klingelton setzen** steht an allen Stellen zur Verfügung, an denen Anruf-Aktionen unterstützt werden: * **Anrufverteiler** * **Benutzer** * **Warteschlangen / Teams** {% hint style="warning" %} Klingelton-Aktionen können **nur vor dem Anruf** ausgeführt werden. Fügen Sie die Aktion daher immer in den Bereichen **Vorher** (z.B. *Extern/Vorher* oder *Intern/Vorher*) ein. {% endhint %} ### Aktion anlegen 1. Öffnen Sie das gewünschte Objekt zur Bearbeitung (z.B. einen Benutzer oder einen Anrufverteiler). 2. Klicken Sie auf **Hinzufügen** und wählen Sie die Aktion **Klingelton setzen**. 3. Tragen Sie in das Textfeld den gewünschten Bezeichner ein (z.B. `CustomRingtone` oder `VIP`). Erlaubt sind Buchstaben (`a-z`, `A-Z`), Ziffern (`0-9`), Punkte (`.`), Bindestriche (`-`) und Unterstriche (`_`). 4. Speichern Sie die Aktion mit **Speichern**. 5. Wenden Sie die Änderungen über das **grüne Häkchen** in der Job-Leiste oben rechts an. {% hint style="success" %} Achten Sie auf die exakte Schreibweise (Groß- und Kleinschreibung). Der hier eingetragene Text muss exakt mit der Konfiguration auf dem Hardware-Telefon übereinstimmen. {% endhint %} ## Schritt 2: Hardware-Telefon konfigurieren Damit das Hardware-Telefon beim Eintreffen des `Alert-Info`-Headers den richtigen Klingelton abspielt, muss auf dem Telefon eine entsprechende Zuordnungsregel hinterlegt sein. Sie können diese Einstellung wahlweise zentral über die PASCOM **Basis-Konfiguration** des Endgeräts oder direkt über die Web-Oberfläche des Telefons hinterlegen. ### Übersicht der Endgeräte-Einstellungen Die folgende Tabelle zeigt die Konfiguration und Provisionierungs-Parameter für die gängigsten Hersteller: | Gerät | Verwendeter Header (PASCOM) | Provisionierung / Konfiguration | | ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Yealink Desktop-Telefone** |

<[http://www.notused.com>\\](https://docs.pascom.net/setup/endpoints/http:/www.notused.com>\\);
info=CustomRingtone;
x-line-id=0

|

distinctive\_ring\_tones.alert\_info.1.text = CustomRingtone
distinctive\_ring\_tones.alert\_info.1.ringer = Ring3.wav

| | **Snom Desktop-Telefone** |

<[http://www.notused.com>\\](https://docs.pascom.net/setup/endpoints/http:/www.notused.com>\\);
info=CustomRingtone;
x-line-id=0

|

\CustomRingtone\
\Ringer3\

| | **Grandstream** |

<[http://www.notused.com>\\](https://docs.pascom.net/setup/endpoints/http:/www.notused.com>\\);
info=CustomRingtone;
x-line-id=0

|

\CustomRingtone\
\3\

| | **Fanvil Desktop-Telefone** |

<[http://www.notused.com>\\](https://docs.pascom.net/setup/endpoints/http:/www.notused.com>\\);
info=CustomRingtone;
x-line-id=0

|

\
\CustomRingtone\
\3.wav\
\

| *** ## Detaillierte Einrichtung nach Hersteller ### Yealink Auf Yealink-Telefonen wird die Funktion über **Distinctive Ring Tones** gesteuert. #### Konfiguration über die Basis-Konfiguration Fügen Sie folgende Zeilen in die PASCOM Basis-Konfiguration Ihres Yealink-Telefons ein (**Endgeräte** > **Basis-Konfigurationen**): ```ini # Aktiviert differenzierte Klingeltöne für das Konto distinctive_ring_tones.alert_info.1.text = CustomRingtone distinctive_ring_tones.alert_info.1.ringer = Ring3.wav ``` #### Konfiguration über die Web-Oberfläche des Telefons 1. Rufen Sie die Weboberfläche des Yealink-Telefons auf und melden Sie sich an. 2. Navigieren Sie zu **Account** > **Advanced**. 3. Aktivieren Sie die Option **Distinctive Ring Tones** (auf *Enabled* setzen). 4. Hinterlegen Sie unter **Alert Info** den gewünschten Text (z.B. `CustomRingtone`) und wählen Sie den zugehörigen internen Klingelton (z.B. `Ring3.wav`). 5. Speichern Sie die Konfiguration mit **Confirm**. *** ### Snom Snom-Telefone unterstützen bis zu 10 verschiedene Alert-Info-Zuordnungen über einen Index (`idx="0"` bis `idx="9"`). #### Konfiguration über die Basis-Konfiguration Fügen Sie im Reiter **Konfiguration** der Snom Basis-Konfiguration folgende XML-Elemente ein: ```xml CustomRingtone Ringer3 ``` * **internal\_ringer\_text**: Das Schlagwort, das in der PASCOM Aktion eingetragen ist. * **internal\_ringer\_file**: Der gewünschte Klingelton des Telefons (`Ringer1` bis `Ringer10`). *** ### Grandstream Bei Grandstream-Endgeräten erfolgt der Abgleich über Matching Rules. #### Konfiguration über die Basis-Konfiguration Tragen Sie die entsprechenden P-Werte in die Grandstream Basis-Konfiguration ein: ```xml CustomRingtone 3 ``` #### Konfiguration über die Web-Oberfläche des Telefons 1. Melden Sie sich an der Weboberfläche des Grandstream-Telefons an. 2. Gehen Sie zu **Account** > **Call Settings**. 3. Suchen Sie den Bereich **Matching Rule** / **Distinctive Ring Tone**. 4. Tragen Sie bei der Regel den Übereinstimmungstext (z.B. `CustomRingtone`) ein und weisen Sie den gewünschten Klingelton zu. 5. Speichern Sie die Änderungen mit **Save and Apply**. *** ### Fanvil Fanvil-Telefone werten den `Alert-Info`-Text über die Medien-Einstellungen aus. #### Konfiguration über die Basis-Konfiguration Fügen Sie den folgenden XML-Block in die Basis-Konfiguration ein: ```xml CustomRingtone 3.wav ``` #### Konfiguration über die Web-Oberfläche des Telefons 1. Melden Sie sich an der Weboberfläche des Fanvil-Telefons an. 2. Navigieren Sie zu **Phone Settings** > **Media Settings** > **Alert Info Ring Settings**. 3. Tragen Sie den Abgleich-Text bei **Text** ein (z.B. `CustomRingtone`). 4. Wählen Sie unter **RingType** die gewünschte Tondatei (z.B. `3.wav`). 5. Klicken Sie auf **Apply**. *** ## Praxisbeispiel: VIP-Klingelton einrichten Ein häufiges Anwendungsszenario ist die akustische Hervorhebung von Anrufen wichtiger Kunden: 1. **Bedingung anlegen**: Erstellen Sie unter **Anrufverteilung** > **Aktionsbedingungen** eine Bedingung, die prüft, ob die Anrufernummer zu einem VIP-Kunden gehört. Weitere Informationen zu Aktionen finden sie [hier](/setup/acd/actions.md) 2. **Aktion in Anrufverteilung einfügen**: Fügen Sie im Anrufverteiler oder beim Team eine Vorher-Aktion vom Typ **Klingelton setzen** ein und weisen Sie dieser die erstellte VIP-Bedingung zu. 3. **Text vergeben**: Tragen Sie als Wert `VIP` ein. 4. **Telefon konfigurieren**: Hinterlegen Sie am Hardware-Telefon (oder in der Basis-Konfiguration) den Text `VIP` und verknüpfen Sie diesen mit einem markanten Klingelton (z.B. `Ring5.wav`). 5. **Änderungen anwenden**: Speichern Sie alle Einstellungen und wenden Sie die Telefonie-Konfiguration an. Sobald ein VIP-Kunde anruft, erkennt PASCOM die Bedingung, sendet den Header `info=VIP` an das Telefon, und das Telefon läutet mit dem ausgewählten VIP-Klingelton. --- # 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/setup/endpoints/hardware-phones-ringtone.md?ask=&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.