> ## Documentation Index
> Fetch the complete documentation index at: https://docs.talkturo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Telefonnummern kaufen und zuweisen

> Verfügbare Nummern nach Land und Vorwahl suchen, in Sekunden kaufen und einem KI-Assistenten in Ihrem Talkturo-Workspace zuweisen.

Eine Telefonnummer zu Talkturo hinzuzufügen dauert weniger als eine Minute. Sie suchen mit Filtern nach Land und Vorwahl, klicken auf **Kaufen**, und die Nummer erscheint in Ihrem Konto — bereit zur Zuweisung an einen Assistenten. Diese Seite führt Sie durch den gesamten Ablauf inklusive Aufheben der Zuweisung, wenn Sie die Nummer neu routen möchten.

<Steps>
  <Step title="Telefonnummern öffnen">
    Öffnen Sie in der linken Seitenleiste **Telefonnummern**. Sie sehen eine Tabelle aller Nummern in Ihrem Konto. Beim ersten Mal ist die Tabelle leer.
  </Step>

  <Step title="Kaufdialog öffnen">
    Klicken Sie oben rechts auf der Karte auf **Nummer kaufen**. Der Dialog **Telefonnummer erhalten** öffnet sich.
  </Step>

  <Step title="Anbieter wählen">
    Wählen Sie **TalkTuro** als Anbieter. Das ist die empfohlene und derzeit einzige Option. Weitere Anbieter (Twilio, Telnyx, Plivo, Wavix) folgen.
  </Step>

  <Step title="Suchfilter setzen">
    Formulieren Sie die Suche nach verfügbaren Nummern:

    * **Nummerntyp** — **Lokale Nummer (geografisch)** für eine normale Ortsnummer oder **Gebührenfrei** (800, 888, 877 usw.) für eine kostenlose Anwahl für Ihre Anrufer.
    * **Land** — Land, in dem Sie die Nummer brauchen.
    * **Vorwahl** *(nur lokale Nummern)* — Dreistellige Vorwahl, z. B. `415` für San Francisco.
    * **Bundesland / Stadt** *(nur lokale Nummern)* — Optional noch genauer nach Staatskürzel oder Stadt.
    * **Präfix** *(nur gebührenfrei)* — Z. B. `800` oder `888`.

    <Tip>
      Lassen Sie die Vorwahl leer, um beliebige verfügbare Nummern im gewählten Land zu sehen. Sie können mit engerer Vorwahl erneut suchen, wenn Sie einen lokalen Eindruck wollen.
    </Tip>
  </Step>

  <Step title="Nach Nummern suchen">
    Klicken Sie auf **Nummern suchen**. Talkturo fragt das Carrier-Netz ab und zeigt bis zu 20 verfügbare Nummern mit Telefonnummer, Ort und monatlichen Kosten.
  </Step>

  <Step title="Nummer kaufen">
    Wählen Sie die gewünschte Nummer und klicken Sie daneben auf **Kaufen**. Während der Bestellung erscheint ein Ladeindikator. Bei Erfolg erscheint eine grüne Bestätigung und die Nummer verschwindet aus der Liste — sie gehört nun Ihrem Konto.

    <Note>
      Free-Konten erhalten **eine** Testnummer ohne Kosten. Testnummern laufen nach **5 Tagen** ab und werden wieder freigegeben. Mit einem kostenpflichtigen Tarif behalten Sie Nummern dauerhaft.
    </Note>
  </Step>

  <Step title="Nummer einem Assistenten zuweisen">
    Nach dem Kauf öffnen Sie **Assistenten** und den gewünschten Assistenten. Gehen Sie zu **Telefonie** in den Einstellungen. Wählen Sie die neue Nummer im Dropdown **Telefonnummern** und speichern Sie.

    Der Assistent ist aktiv — eingehende Anrufe auf diese Nummer werden angenommen, ausgehende Kampagnen können sie als Anrufer-ID nutzen.
  </Step>
</Steps>

## Zuweisung eines Assistenten aufheben

Um eine Nummer vom aktuellen Assistenten zu trennen, ohne sie zu löschen:

1. Öffnen Sie den Assistenten unter **Assistenten**.
2. Öffnen Sie den Bereich **Telefonie**.
3. Entfernen Sie die Nummer aus der Zuweisungsliste und speichern Sie.

Die Nummer erscheint wieder als nicht zugewiesen in **Telefonnummern** und kann jederzeit einem anderen Assistenten zugewiesen werden.

## API-Referenz

Sie können Telefonnummern auch per Talkturo-REST-API verwalten.

**Verfügbare Nummern suchen**

```http theme={null}
POST /api/phone-numbers/search
Authorization: Bearer <token>
Content-Type: application/json

{
  "filters": {
    "countryCode": "US",
    "areaCode": "415",
    "numberType": "local",
    "limit": 20
  }
}
```

**Nummer kaufen**

```http theme={null}
POST /api/phone-numbers/purchase
Authorization: Bearer <token>
Content-Type: application/json

{
  "phoneNumber": "+14155550100",
  "teamId": "your-team-id"
}
```

**Ihre Nummern auflisten**

```http theme={null}
GET /api/phone-numbers/purchase?teamId=your-team-id
Authorization: Bearer <token>
```

**Nummer einem Assistenten zuweisen**

```http theme={null}
PATCH /api/assistants/{assistantId}/telephony/phone-numbers
Authorization: Bearer <token>
Content-Type: application/json

{
  "accountSlug": "your-account-slug",
  "phoneNumberIds": ["phone-number-uuid"]
}
```

Um alle Nummern von einem Assistenten zu entfernen, senden Sie ein leeres Array für `phoneNumberIds`.

<Warning>
  Die Zuweisung zu einem neuen Assistenten gilt sofort. Ein laufender eingehender Anruf auf dieser Nummer wird noch vom bisherigen Assistenten beendet; alle **folgenden** Anrufe gehen an den neu zugewiesenen Assistenten.
</Warning>

## Fehlerbehebung

<Accordion title="Die Nummer bleibt im Status „purchasing“">
  Aktualisieren Sie die Seite nach etwa 60 Sekunden. Wechselt der Status nicht zu `active`, kann die Bereitstellung beim Carrier hängen bleiben. Versuchen Sie eine andere Nummer zu kaufen. Wenn das Problem bleibt, schreiben Sie an [support@talkturo.com](mailto:support@talkturo.com).
</Accordion>

<Accordion title="Beim Kauf erhalte ich einen 403-Fehler">
  Ihr aktueller Tarif hat das Limit für Nummern erreicht. Upgraden Sie den Tarif oder heben Sie zuerst die Zuweisung auf und entfernen Sie eine bestehende Nummer.
</Accordion>

<Accordion title="Die Suche liefert keine Ergebnisse">
  Lockern Sie die Filter — z. B. Vorwahl entfernen oder den Nummerntyp ändern. In manchen Regionen ist die Verfügbarkeit begrenzt, besonders bei gebührenfreien Nummern.
</Accordion>