# Phone connection

Mit hostware können Sie seit Version 1.0.9 direkt aus hostware Telefonanrufe starten und Anrufe protokollieren.

## Einrichtung

Konfigurieren Sie dazu zunächst unter *Einstellungen -> Telefonanbindungen* einen von hostware unterstützten Provider wie z.B. 3CX*.* Wenn Sie Ihren Provider nicht finden können, fragen Sie die Integration gerne bei uns an.

<figure><img src="/files/VHqIzQgcMyZba2NuztdE" alt=""><figcaption></figcaption></figure>

Konfigurieren Sie den Host-, und Benutzername sowie das Passwort/API Key.

Sobald die Anbindung als "aktiv" markiert wurde, werden über dem Formular Informationen zu den per API abgefragten Geräten und unter dem Formular die Mitarbeiterzuweisung sichtbar. Weisen Sie nun jedem Mitarbeiter das zugehörige Gerät zu, damit hostware Anrufe starten kann.

<figure><img src="/files/pw2bFsnBvHy8Pvpk3CCN" alt=""><figcaption></figcaption></figure>

## Kunden anrufen

Sobald die Anbindung aktiv ist, kannst du den Kunden in der Kundenansicht direkt anrufen. Dabei werden alle dir verfügbaren Geräte angezeigt und du kannst wählen, mit welchem Gerät du anrufen möchtest.

Ein Gerät kann als Standard markiert werden, damit es beim nächsten mal direkt vorausgewählt wird.

<figure><img src="/files/oZYFy9ukt8AMEmm83AEt" alt=""><figcaption></figcaption></figure>

## Kundeninformationen abfragen

hostware stellt Endpunkte bereit, um anhand verschiedener Informationen wie z.B. die Telefonnummer oder ID weitere Informationen aus der Datenbank zu erhalten. Die Endpunkte sind wie folgt definiert und können in der Regel in Ihrer Telefonanlage hinterlegt werden.

In der Übersicht der Anbindungen sind alle Endpunkte sichtbar. Ersetzen Sie die Variablen in eckigen Klammern mit der entsprechenden Variable aus Ihrer Telefonanlage.

{% hint style="info" %}
Für 3CX können wir eine CRM-Vorlage zur Verfügung stellen.
{% endhint %}

<figure><img src="/files/noQIGjHCkEbbMUhAnK5Z" alt=""><figcaption></figcaption></figure>

### API-Antwort

Die API Antwort ist für alle drei Such-Anfragen identisch. Wird kein Datensatz gefunden, wird ein HTTP 400 zurückgegeben.

```
{
  "id": 1,
  "number": "10002",
  "first_name": "Max",
  "last_name": "Mustermann",
  "full_name": "Max Mustermann",
  "email": "max@mustermann.de",
  "phone": "+49 176 1234567",
  "phone_mobile": null,
  "company": "Mustermann GmbH"
}
```


---

# Agent Instructions: 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 current page URL with the `ask` query parameter:

```
GET https://docs.hostware.io/system-and-configuration/settings/phone-connection.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.