> 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/user/pascom-app-userguide/client-actions.md).

# PASCOM App Aktionen verwenden

In dieser Anleitung zeigen wir Ihnen, wie Sie PASCOM App Aktionen nutzen und Anrufdaten an eine externe Anwendung übergeben.

## Trainings Video

{% embed url="<https://www.youtube.com/watch?v=n9QQMU1CrTM>" %}

## Übersicht

Mit App-Aktionen können Sie Daten an Drittanwendungen übergeben, um diese weiterzuverarbeiten (z. B. eine CRM/ERP Webanwendung mit Kundendaten). App-Aktionen können Sie manuell steuern oder auch automatisieren.

## Neue Aktion anlegen

Die App-Aktionen finden Sie in den **App-Einstellungen**.

1. Öffnen Sie die **App-Einstellungen** über das PASCOM Menü.

![App-Einstellungen öffnen](https://1983379169-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLe82Z891Z9TUVDeTD5WX%2Fuploads%2Fgit-blob-c4a4bcf8655b2611f171482cd10614fb8b2e4052%2Fopen_clientsettings.jpg?alt=media)

2. Klicken Sie im **Einstellungs-Menü** auf **Aktionen**.

![Die Aktionen](https://1983379169-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLe82Z891Z9TUVDeTD5WX%2Fuploads%2Fgit-blob-89fa9c01a17c0744a7a86f74c64253ece98af459%2Factions.de.jpg?alt=media)

3. Erstellen Sie eine neue Aktion über **Aktionen hinzufügen**.

### Daten an URL oder Anwendung übergeben

An diesem Punkt müssen Sie sich entscheiden, ob Sie Daten an eine **URL** weitergeben wollen (z. B. eine Web-Anwendung) oder an eine **Anwendung**, die auf Ihrem Computer installiert ist.

![URL oder App](https://1983379169-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLe82Z891Z9TUVDeTD5WX%2Fuploads%2Fgit-blob-2156c5b9d6166167eca5d5b99296f64c09124538%2Factions-url-app.de.jpg?alt=media)

## Aktion einrichten

Hier bestimmen Sie, welche Daten Sie übergeben möchten und wie sich Ihre Aktion verhalten soll. In unserem Beispiel übergeben wir die **Telefonnummer** des Anrufers an eine **URL**.

![Aktionen einstellen](https://1983379169-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLe82Z891Z9TUVDeTD5WX%2Fuploads%2Fgit-blob-26937dc3050099ed0eedd0f52d7da6d31cc7feaf%2Factions-settings.de.jpg?alt=media)

### Namen vergeben

Vergeben Sie beim Punkt **Namen** eine eindeutige Bezeichnung für die Aktion, da Sie sich mehrere Aktionen anlegen können und daher gleich erkennen, was die Aktion macht.

### URL hinterlegen

Setzen Sie beim Punkt **URL** die Adresse Ihrer Web-Anwendung, gefolgt von einer Variable und den Daten, die Sie übergeben möchten.

**Beispiel**

| Beschreibung              | Parameter                                                                       |
| ------------------------- | ------------------------------------------------------------------------------- |
| URL                       | [www.webadresse.com](http://www.webadresse.com)                                 |
| Variable der Webanwendung | ?phone=                                                                         |
| Daten aus der PASCOM App  | ${number}                                                                       |
| Ergibt                    | [www.webadresse.com?phone=${number}](http://www.webadresse.com?phone=${number}) |

{% hint style="info" %}
Bei der Zusammensetzung der **URL** haben Sie natürlich komplett freie Hand und können die Daten daher so übergeben, wie sie benötigt werden.
{% endhint %}

**PASCOM Parameter, die verwendet werden können**

| Parameter          | Beschreibung                                                      |
| ------------------ | ----------------------------------------------------------------- |
| ${name}            | Enthält den Namen des Anrufers, aufgelöst aus dem Telefonbuch     |
| ${number}          | Enthält die Telefonnummer des Anrufers. (Format: 0049123456789)   |
| ${number\_e123}    | Enthält die Telefonnummer des Anrufers. (Format: +49123456789)    |
| ${number\_display} | Enthält die Telefonnummer des Anrufers: (Format: +49 123 45678 9) |
| ${MDC\_LABEL-X}    | Enthält die Systemvariable eines Labels des Anrufers              |
| ${MDC\_SKILL-X}    | Enthält die Systemvariable eines Skills                           |
| ${journalNotes}    | Enthält die Notizen des Anrufers aus dem Anrufjournal             |

## Aktionen automatisch ausführen

Aktionen können in Verbindung mit der **Rufrichtung** und einem **Anrufergebnis** automatisch für folgende **Anruftypen** gestartet werden:

1. Interne Anrufe von Kollegen
2. Externe Anrufe auf der eigenen Durchwahl
3. Externe Anrufe über ein Team / Warteschlange

### Anrufrichtung bei automatischen Aktionen

Legen Sie bei der **Rufrichtung** fest, ob die Aktion bei **eingehenden**, **ausgehenden** oder **beiden** Rufrichtungen automatisch starten soll.

### Anrufergebnis bei automatischen Aktionen

Stellen Sie beim Punkt **Ergebnis** ein, wann die Aktion automatisch starten soll: schon beim **Klingeln**, nach dem **Annehmen** des Anrufs oder beim **Auflegen** des Anrufs.

## Aktionen manuell starten

Aktionen können Sie auch manuell zu jeder Zeit selbst ausführen bzw. starten. Bei Aktionen, die beim jeweiligen Anruf zutreffen, finden Sie ein **Aktion öffnen** Symbol.

![Aktionen selbst starten](https://1983379169-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLe82Z891Z9TUVDeTD5WX%2Fuploads%2Fgit-blob-4772b37c2d2fd9b26d30ee54edb246f69260e365%2Factions-manuel.de.jpg?alt=media) *Aktionen mit einem Klick manuell starten*

1. Klicken Sie bei einem eingehenden Anruf auf den **Aktion öffnen** Button. Ein Pop-up zeigt Ihnen auch den Namen der Aktion an, welche ausgeführt wird.
2. Aktionen können auch direkt aus dem **Anrufjournal** heraus gestartet werden. Dort finden Sie denselben **Aktionen Öffnen** Button.

## Daten in Drittanwendung auslesen

Die Daten, welche Sie an eine Drittanwendung übergeben, sollten Sie natürlich auch weiterverarbeiten (z. B. Telefonnummer in einer CRM/ERP-Webanwendung suchen).

![Daten in Drittanwendung](https://1983379169-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLe82Z891Z9TUVDeTD5WX%2Fuploads%2Fgit-blob-36624934f509b3c7236146ffc0c59af6170f8329%2Fdata_extern.jpg?alt=media) *Daten aus der PASCOM App an externe Anwendung übergeben*

1. Wie Sie in der oberen Grafik erkennen können, wurde der **URL** die **Telefonnummer** des Kunden mitgegeben, welche nun **extern** weiter genutzt werden kann.

## Aktionen verwalten

In den **App-Einstellungen** können Sie Ihre Aktionen verwalten. Fügen Sie neue Aktionen hinzu, entfernen Sie bestehende Aktionen und favorisieren Sie Aktionen, welche standardmäßig genutzt werden sollen.

![Aktionen verwalten](https://1983379169-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLe82Z891Z9TUVDeTD5WX%2Fuploads%2Fgit-blob-468457d743dbbbea0530f4e12d471dba196a9e9c%2Factions_manage.de.jpg?alt=media) *Verwalten Sie Ihre Aktionen in der PASCOM App*

1. **Deaktivieren** Sie Aktionen, welche Sie vorübergehend nicht benötigen.
2. Klicken Sie auf eine **Aktion**, um diese zu **bearbeiten**.
3. Bitte beachten Sie, dass immer eine Aktion als **Favorit** markiert werden muss. Eine einzelne Aktion ist daher immer **favorisiert**.

## App-Aktionen Troubleshooting

#### Debugging der Aktionen mithilfe des App-Logs

Das Ausführen von Aktionen wird in den Log-Dateien der PASCOM App mitgeschrieben. Somit erhält man auch Rückgabewerte von Anwendungen, welchen man Daten übergibt. Wenn sich z. B. PowerShell (Windows) über die Ausführungsrichtlinien beschwert, wird das als Ausgabewert mitprotokolliert.

#### Wie man Parameter korrekt escaped

Tokens mit Leerzeichen können von doppelten Anführungszeichen umgeben werden. Drei aufeinanderfolgende doppelte Anführungszeichen stehen für das Anführungszeichen selbst.

#### Daten an PowerShell (Windows) übergeben

Das folgende Anwendungsbeispiel für App-Aktionen übergibt Daten an PowerShell, sodass ein Skript ausgeführt wird.

**PowerShell Skript Beispiel:**

```powershell
param(
[Parameter(Mandatory=$true)][string]$number
)

Invoke-WebRequest -URI "https://example.com/action1?number=$number"
```

**PASCOM Aktions-Beispiel:**

1. App-Aktion auswählen
2. App-Pfad: `powershell.exe`
3. App-Parameter:

```
{{-noprofile -ExecutionPolicy UnRestricted -File C:\...\incoming-call-notification.ps1 -number ${number} }}
```

In der Aktion übergeben wir die Telefonnummer des Anrufers in der Variable `${number}` an PowerShell, wo das Skript die Telefonnummer weiterverarbeitet.

{% hint style="warning" %}
Bitte beachten Sie, dass wir für Skripte keinerlei Support anbieten können.
{% endhint %}


---

# 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/user/pascom-app-userguide/client-actions.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.