# Telefonnummern

Die SIP-Nummer des Kunden mit einem Agenten für eingehende Anrufe verknüpfen

> Full REST + WebSocket API reference: https://api.happ.tools/reference

Fügen Sie eine SIP-Telefonnummer hinzu, verknüpfen Sie sie mit einem Agenten, und der KI-Sprachagent nimmt eingehende Anrufe an.

<VoiceSetupDemo />

## Telefonnummer verbinden [#connect-a-phone]

1. Besorgen Sie sich die SIP-Zugangsdaten bei einem [unterstützten Anbieter](/docs/integrations/telephony): Telefonnummer, SIP-Login, SIP-Passwort, Telefonie-URL.
2. **Telefonnummern** > **Telefonnummer hinzufügen**, die Felder unten ausfüllen, **Speichern**.
3. Verknüpfen: In den Einstellungen der Nummer einen **Agenten** wählen (eine Nummer → ein Agent), **Speichern**.
4. Fügen Sie die Integration des Telefonieanbieters hinzu: **Integrationen** > **Integration hinzufügen** > Anbieter wählen, Zugangsdaten eingeben, aktivieren.
5. Konfigurieren Sie die Stimmeinstellungen des Agenten und rufen Sie anschließend die Nummer an, um die Begrüßung und ein Tool zu testen.

## Felder der Telefonnummer [#phone-fields]

| Feld          | Wert                                    |
| ------------- | --------------------------------------- |
| Telefonnummer | SIP-Telefonnummer (z. B. +380501234567) |
| SIP-Login     | Benutzername für die Authentifizierung  |
| SIP-Passwort  | Passwort für die Authentifizierung      |
| Anbieter-URL  | Adresse des SIP-Servers                 |
| Codec         | A-law (Standard) oder μ-law             |
| Kommentar     | Optionale Bezeichnung                   |

## Stimmeinstellungen (im Agenten) [#voice-settings-on-assistant]

| Einstellung           | Wert                                                          |
| --------------------- | ------------------------------------------------------------- |
| Stimme                | 30 integrierte Stimmen oder ElevenLabs                        |
| Audioformat           | Ein-/Ausgabeformat (Standard PCM 8000)                        |
| Reaktionsbereitschaft | Eifrig, Normal oder Geduldig                                  |
| Nach Stille reagieren | Sekunden, bevor der Agent spricht (Standard 7)                |
| Soft-Timeout          | Max. Wartezeit auf eine Antwort des Anrufers; -1 = unbegrenzt |

Siehe [Agenten > Stimmeinstellungen](/docs/agents).

## API [#api]

```bash
POST /api/phones
X-Access-Token: happ_your_token_here
Content-Type: application/json

{
  "phoneNumber": "+380501234567",
  "sipLogin": "your-sip-login",
  "password": "your-sip-password",
  "telephonyUrl": "sip.provider.com",
  "codec": "alaw",
  "comment": "Main office line"
}
```

Mit einem Agenten verknüpfen Sie die Nummer über `PATCH /api/phones/{phoneId}` (`{ "assistantId": "..." }`). Auflisten mit `GET /api/phones`, aktualisieren mit `PATCH`, entfernen mit `DELETE /api/phones/{phoneId}`.

**API:** [api.happ.tools/reference](https://api.happ.tools/reference)

## Fehlerbehebung [#troubleshooting]

| Problem            | Lösung                                                                   |
| ------------------ | ------------------------------------------------------------------------ |
| Kein Ton           | SIP-Zugangsdaten und Anbieter-URL prüfen                                 |
| Abgehackter Ton    | Netzwerk prüfen; den jeweils anderen Codec ausprobieren (alaw bzw. ulaw) |
| Langsame Antworten | Reaktionsbereitschaft auf Eifrig stellen                                 |
| Keine Verbindung   | Prüfen, ob die Integration des Telefonieanbieters aktiv ist              |
| Falsche Stimme     | Stimmeinstellung in der Konfiguration des Agenten prüfen                 |

## Weiter [#next]

* [Telefonieanbieter](/docs/integrations/telephony) — Liste der Anbieter
* [Sprachagent](/docs/agents/voice) — Überblick