Errores

Direkte Antwort

Häufige TextTree-API- und Übermittlungsfehler mit Ursachen, Lösungen und Wiederholungsanleitungen.

Seiteninhalt

## Versender oder Lieferant nicht bereit

Ursache: TextTree konnte keine Absendernummer reservieren oder der Messaging-Anbieter hat die Anfrage abgelehnt.

Lösung: Bestätigen Sie, dass der Arbeitsbereich über einen verbundenen Absender oder einen verfügbaren Absender aus dem Instant-Pool verfügt, und versuchen Sie es anschließend erneut
dass die Verfügbarkeit des Lieferanten wiederhergestellt ist.

Wiederholen: Versuchen Sie es erst erneut, nachdem das Absender- oder Anbieterproblem behoben ist.

Beispielantwort:

```json
{
  „Fehler“: {
    „code“: „branded_number_missing“,
    „message“: „Für diesen Arbeitsbereich ist kein verbundener Markensender verfügbar.“,
    „fix“: „Verbinden Sie einen Markensender oder wechseln Sie zu einem unterstützten Sendemodus.“,
    „retry“: „retry_after_sender_ready“
  }
}
```

## Arbeitsbereich gelöscht

Ursache: Die Telefonnummer des Empfängers verfügt über eine aktive Unterdrückung auf Arbeitsbereichsebene. Das kommt normalerweise
durch ein STOP/Opt-out-Ereignis des Anbieters oder durch eine manuelle Unterdrückung durch den Betreiber.

Lösung: Akzeptieren Sie die Löschung oder entfernen Sie sie nur dann aus den Workspace-Einstellungen, wenn Ihr Compliance-Prozess erfolgt
ermöglicht es dem Empfänger, erneut SMS zu empfangen.

Wiederholen: Versuchen Sie es nicht erneut, bis die Löschung entfernt wurde.

Beispielantwort:

```json
{
  „Fehler“: {
    „code“: „workspace_suppressed“,
    „message“: „Empfänger wird für diesen Arbeitsbereich unterdrückt.“,
    „fix“: „Entfernen Sie die Arbeitsbereichsunterdrückung erst, nachdem bestätigt wurde, dass der Empfänger SMS empfangen kann.“,
    „retry“: „do_not_retry“
  }
}
```

## Kampagne gelöscht

Ursache: Die Telefonnummer des Empfängers verfügt über ein aktives Opt-out für eine bestimmte Kampagne.

Lösung: Überspringen Sie die Kampagnenzustellung oder melden Sie die Kampagne auf der Kampagnenseite ab, wenn
wurde versehentlich erstellt.

Wiederholen: Versuchen Sie die generierte Zustellung nicht erneut, bis die Kampagnenunterdrückung entfernt wurde.

## Ausgabenlimit überschritten

Ursache: Das Ausgabenlimit für den Arbeitsbereich würde überschritten.

Lösung: Erhöhen Sie das Limit oder warten Sie bis zum nächsten Abrechnungszeitraum.

Wiederholen: Versuchen Sie es nur erneut, wenn Ausgaben verfügbar sind.

Beispielantwort:

```json
{
  „Fehler“: {
    „code“: „spend_limit_exceeded“,
    „message“: „Diese Nachricht würde das Workspace-Ausgabenlimit überschreiten.“,
    „fix“: „Ausgabenlimit erhöhen oder bis zum nächsten Abrechnungszeitraum warten.“,
    „retry“: „retry_after_spend_available“
  }
}
```

## Unzureichendes Gleichgewicht

Ursache: Auf dem Konto ist nicht genügend SMS-Prepaid-Guthaben für die angeforderte Zustellung vorhanden.

Lösung: Erstellen Sie eine USDC-Finanzierungsrechnung, zahlen Sie den genauen Betrag und warten Sie, bis sich der Rechnungsstatus in ändert
`paid`, bevor Sie es erneut versuchen.

Wiederholen: Wiederholen Sie den Vorgang, nachdem der Restbetrag gutgeschrieben wurde.

Beispielantwort:

```json
{
  „error“: „insufficient_balance“
}
```

## Betrag unter dem Mindestbetrag

Ursache: Der Betrag der Finanzierungsrechnung liegt unter dem aktuellen Onboarding- oder Produktminimum.

Lösung: Senden Sie einen größeren Betrag, der dem zurückgegebenen `minimum_cents` entspricht.

Wiederholen: Sofort mit einem gültigen Betrag erneut versuchen.

Beispielantwort:

```json
{
  „error“: „amount_below_minimum“,
  „minimum_cents“: 1000
}
```

## Onchain-Rechnung nicht gefunden

Ursache: Die Rechnung existiert für den authentifizierten Benutzer nicht oder die ID ist falsch.

Lösung: Verwenden Sie die von `POST /api/v1/onboarding/funding-invoices` oder zurückgegebene Rechnungs-ID
`onboarding.create_invoice`.

Wiederholen: Wiederholen Sie den Vorgang mit einer gültigen Rechnungs-ID.

Beispielantwort:

```json
{
  „error“: „onchain_invoice_not_found“
}
```

## Webhook-Zustellungsfehler

Ursache: Ihr Webhook-Endpunkt hat eine Antwort zurückgegeben, die nicht `2xx` entspricht, oder es ist eine Zeitüberschreitung aufgetreten.

Lösung: Überprüfen Sie den Übermittlungsantworttext auf der Webhooks-Seite, stellen Sie einen Fix bereit und spielen Sie dann das Ereignis ab.

Wiederholen: Manuell wiederholen, nachdem der Endpunkt fehlerfrei ist.

Beispiel für einen Lieferdatensatz:

```json
{
  „event_id“: „evt_123“,
  „status“: „fehlgeschlagen“,
  „response_code“: 500,
  „latency_ms“: 842,
  „next_retry“: null
}
```

## Ungültiges Zugriffstoken

Ursache: Das TextTree-Bearer-Token fehlt, ist fehlerhaft, abgelaufen, widerrufen oder es fehlt das
erforderlichen Umfang.

Lösung: Aktualisieren Sie die Browsersitzung, stellen Sie ein neues Agent-Token aus oder schließen Sie den fehlenden Bereich ein.

Wiederholen: Wiederholen Sie den Versuch mit einem gültigen Token.

```json
{
  „Fehler“: {
    „code“: „unautorisiert“,
    „message“: „Ein gültiges TextTree-Zugriffstoken ist erforderlich.“
  }
}
```