Seitentyp: docs
Zahlen
Mieten, verbinden und konfigurieren Sie SMS-Nummern zum Senden und Empfangen.
Direkte Antwort
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.