# Zahlen

Kanonische URL: https://texttree.ai/de/docs/nummern/
Markdown-URL: https://texttree.ai/de/docs/nummern.md
Seitentyp: docs
Translation status: draft
Legal status: english_controls

## Zusammenfassung

Mieten, verbinden und konfigurieren Sie SMS-Nummern zum Senden und Empfangen.

## Seiteninhalt

Telefonnummern definieren die Absenderidentität, das eingehende Routing, den Compliance-Status und die Nachrichtenfunktionen.

Beginnen Sie mit einem Testsender und registrieren Sie sich oder verbinden Sie dann einen Produktionssender, bevor Sie zu Live wechseln.

## Nummernregistrierung

```json
{
  „id“: „num_123“,
  „Nummer“: „+15557654321“,
  "Friendly_name": "Support-Hotline",
  „capabilities“: [„sms“, „mms“],
  „Status“: „aktiv“,
  "inbound_webhook_url": " https://example.com/textree/inbound", 
  „compliance_status“: „genehmigt“,
  „created_at“: „2026-04-28T14:00:00Z“
}
```

## Konfigurationsablauf

1. Überprüfen Sie die Telefonnummern in der App.
2. Wählen Sie `Buy number` oder `Connect existing number`.
3. Geben Sie beim Kauf einer Ortsnummer eine Vorwahl ein.
4. Fügen Sie einen benutzerfreundlichen Namen hinzu, damit Bediener den Absender erkennen können.
5. Wenn Sie den Webhook oder die Fallback-URL verwenden, erscheint der TextTree erneut.
6. Führen Sie die Registrierungs- und Compliance-Schritte aus, bevor der Datenverkehr live geht.

Verbundene Markennummern werden in der Absenderauswahl der App für den Versand angezeigt
Schnellanzeige und Seite „Senden“. TextTree validiert den Eigenschafts- und Verbindungsstatus
Vor dem Kleben und Nacht einmal vor dem Versand.

## Absenderstaaten

-`connected`: in TextTree gespeichert und für konfigurierte Versandrouten verfügbar.
-`pending`: Warten auf Registrierung, Verbindung oder Konformitätsprüfung.
-`disabled`: nicht verfügbar für anfängliche Sendungen.

Wenn eine In-App-Einreichung auf eine Markennummer verweist, wird die später oder nicht mehr verbunden
Gehört zum Arbeitsbereich, der Versand schlägt mit `sender_number_unavailable` fehl 
anstatt einen anderen Absender zu verwenden.

Der SMS-Anbieter stellt derzeit keine dokumentierte Webhook-Konfigurations-API für eingehenden Datenverkehr zur Verfügung. Wollen
TextTree kauft eine Zeile, API-Antworten geben `webhook_configured: false` mit zurück
`provider_inbound_webhook_configuration_api_not_documented` ; Betreiber müssen das eingehende Routing überprüfen
Bevor man den Antworten vertraut.

## Konfiguration pro API

Die Start-API stellt Folgendes bereit:

-`GET /api/v1/numbers` mit`numbers:read` 
-`POST /api/v1/numbers` mit`numbers:write` 

`POST /api/v1/numbers` akzeptiert `area_code`, `friendly_name` und optional
`inbound_webhook_url` . Live-Käufe bleiben blockiert, es sei denn, die Bereitstellung ermöglicht dies ausdrücklich
die Sicherheit beim Kauf von Live-Nummern.

## Eingehendes Routing

Eine eingehende SMS, die auf eine Nummer empfangen wird, kann wie folgt erstellt oder aktualisiert werden:

- Nachrichtenprotokolle
- Konversationsthreads
- Kontakthistorie
- Webhook-Lieferungen an Kunden
- Status an AI übertragen

Wenn eine eingehende Webhook-URL fehlt, wird die Nachricht weiterhin in TextTree, aber in Ihrer Anwendung protokolliert
External empfängt das Ereignis erst, wenn ein Endpunkt konfiguriert ist.