# Telefonansage

> Symcon Dokumentation · Deutsch · erzeugt am 2026-09-26  
> Index: https://www.symcon.de/de/llms.txt

Quelle: https://www.symcon.de/de/service/dokumentation/modulreferenz/benachrichtigungen/telefonansage/

_Benötigt Symcon >= 5.5_

Das Telefonansage-Modul ermöglicht die komfortable Verknüpfung einer VoIP-Instanz und einer Text-to-Speech-Instanz (Polly) um eine Telefonnummer anzurufen und bei Annahme des Anrufs einen Text auszugeben. Darüber hinaus, kann das Modul auf DTMF-Töne reagieren und weitere Texte ausgeben.

### Funktionsumfang
- Anrufen einer Telefonnummer und Ausgabe eines Textes
- Auswerten von DTMF-Tönen
- Ausgabe von weiteren Texten auf einer bestehenden Verbindung

### Voraussetzungen
- Eingerichtete VoIP-Instanz
- Eingerichtete [Text-to-Speech-Instanz (AWS Polly)](ttsawspolly.md)

### Software-Installation
- Über den [Module Store](https://www.symcon.de/de/service/dokumentation/komponenten/verwaltungskonsole/module-store/) das 'Telefonansage'-Modul installieren.

### Einrichten der Instanzen in IP-Symcon
- Unter 'Instanz hinzufügen' kann das 'Telefonansage'-Modul mithilfe des Schnellfilters gefunden werden.
  - Weitere Informationen zum Hinzufügen von Instanzen in der [Dokumentation der Instanzen](https://www.symcon.de/service/dokumentation/konzepte/instanzen/#Instanz_hinzuf%C3%BCgen)

#### Konfigurationsseite:

| Name                                   | Beschreibung                                                         |
| -------------------------------------- | -------------------------------------------------------------------- |
| VoIP-Instanz                           | Die VoIP-Instanz, welche die Anrufe verwaltet                        |
| Text-to-Speech-Instanz (Polly)         | Die Text-to-Speech-Instanz, welche die Texte in Tondaten umwandelt   |
| Dauer bis die Verbindung getrennt wird | Die maximale Zeit, die gewartet wird, dass ein Anruf angenommen wird |

### Statusvariablen
Die Statusvariablen/Kategorien werden automatisch angelegt. Das Löschen einzelner kann zu Fehlfunktionen führen.

#### Statusvariablen

| Name          | Typ    | Beschreibung                                                                                                                                                                           |
| ------------- | ------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Telefonnummer | String | Die Telefonnummer, welche bei der Betätigung von "Anruf starten" angerufen wird                                                                                                        |
| Text          | String | Der Text, welcher bei der Betätigung von "Anruf starten" initial ausgegeben wird. Wird diese Variable geschaltet während eine Verbindung besteht, wird der neue Text direkt ausgegeben |
| DTMF-Ton      | String | Wird während des Anrufs ein DTMF-Ton verwendet, wird er in dieser Variable gespeichert                                                                                                 |
| Anruf starten | Skript | Startet einen Anruf mit der aktuell eingestellten Telefonnummer und dem aktuellen Text                                                                                                 |

## TA_StartCall

Quelle: https://www.symcon.de/de/service/dokumentation/modulreferenz/benachrichtigungen/telefonansage/ta-startcall/

`void TA_StartCall(int $InstanzID)`

_Benötigt Symcon >= 5.5_

**Parameter**

- `$InstanzID` (int): ID der Instanz

ID der Instanz

**Beispiel**

```text
TA_StartCall(12345);
```

## TA_StartCallEx

Quelle: https://www.symcon.de/de/service/dokumentation/modulreferenz/benachrichtigungen/telefonansage/ta-startcallex/

`void TA_StartCallEx(int $InstanzID, string $Telefonnummer, string $Text)`

_Benötigt Symcon >= 5.5_

Startet einen Anruf an eine Telefonnummer und gibt den Text aus

**Parameter**

- `$InstanzID` (int): ID der Instanz
- `$Telefonnummer` (string): Anzurufende Telefonnummer
- `$Text` (string): Auszugebender Text

Auszugebender Text

**Beispiel**

```text
TA_StartCallEx(12345, "+4945130500511", "Ich liebe IP-Symcon!");
```