Erreurs

Réponse directe

Erreurs de livraison courantes des API et TextTree avec causes, solutions et guide de nouvelle tentative.

Contenu source

## L'expéditeur ou le fournisseur n'est pas prêt

Cause : TextTree n'a pas pu réserver de numéro d'expéditeur ou la demande a été rejetée par le fournisseur de messagerie.

Solution : confirmez que l'espace de travail dispose d'un expéditeur connecté ou d'un expéditeur disponible dans le pool instantané, puis réessayez après
que la disponibilité du fournisseur soit rétablie.

Réessayer : réessayez uniquement une fois le problème de l'expéditeur ou du fournisseur résolu.

Exemple de réponse :

```json
{
"erreur": {
"code": "branded_number_missing",
"message": "Aucun expéditeur de marque connecté n'est disponible pour cet espace de travail.",
"fix": "Connectez un expéditeur de marque ou passez à un mode d'envoi pris en charge.",
"retry": "retry_after_sender_ready"
  }
}
```

## Espace de travail supprimé

Cause : Le numéro de téléphone du destinataire a une suppression active au niveau de l'espace de travail. Cela vient généralement
d'un événement STOP/opt-out du fournisseur ou d'une suppression manuelle par l'opérateur.

Solution : Honorez la suppression ou supprimez-la des paramètres de l'espace de travail uniquement si votre processus de conformité
permet à ce destinataire de recevoir à nouveau SMS.

Réessayer : ne réessayez pas tant que la suppression n'est pas supprimée.

Exemple de réponse :

```json
{
"erreur": {
"code": "workspace_suppressed",
"message": "Le destinataire est supprimé pour cet espace de travail.",
"fix": "Supprimez la suppression de l'espace de travail uniquement après avoir validé que le destinataire peut recevoir SMS.",
"retry": "do_not_retry"
  }
}
```

## Campagne supprimée

Cause : Le numéro de téléphone du destinataire dispose d'un désabonnement actif pour une campagne spécifique.

Solution : ignorez la diffusion de la campagne ou désabonnez-la de la page Campagne si
a été créé par erreur.

Réessayer : ne réessayez pas la diffusion générée tant que la suppression de la campagne n'est pas supprimée.

## Limite de dépenses dépassée

Cause : La limite de dépenses de l'espace de travail serait dépassée.

Solution : augmentez la limite ou attendez la prochaine période de facturation.

Réessayer : réessayez uniquement lorsque les dépenses sont disponibles.

Exemple de réponse :

```json
{
"erreur": {
"code": "spend_limit_exceeded",
"message": "Ce message dépasserait la limite de dépenses de l'espace de travail.",
"fix": "Augmentez la limite de dépenses ou attendez la prochaine période de facturation.",
"retry": "retry_after_spend_available"
  }
}
```

## Solde insuffisant

Cause : Le compte ne dispose pas d'un solde prépayé SMS suffisant pour l'envoi demandé.

Solution : Créez une facture de financement dans USDC, payez le montant exact et attendez que le statut de la facture passe à
`paid` avant de réessayer.

Réessayer : réessayez une fois le solde crédité.

Exemple de réponse :

```json
{
"erreur": "balance_insuffisante"
}
```

## Montant inférieur au minimum

Cause : Le montant de la facture de financement est inférieur au minimum actuel d'intégration ou de produit.

Solution : Envoyez un montant plus important correspondant au `minimum_cents` renvoyé.

Réessayer : réessayez immédiatement avec un montant valide.

Exemple de réponse :

```json
{
"erreur": "montant_inférieur_minimum",
"minimum_cents": 1000
}
```

## Facture Onchain introuvable

Cause : La facture n'existe pas pour l'utilisateur authentifié ou l'ID est incorrect.

Solution : Utilisez l'ID de facture renvoyé par `POST /api/v1/onboarding/funding-invoices` ou
`onboarding.create_invoice`.

Réessayer : réessayez avec un identifiant de facture valide.

Exemple de réponse :

```json
{
"erreur": "onchain_invoice_not_found"
}
```

## Échec de livraison du webhook

Cause : Votre point de terminaison de webhook a renvoyé une réponse non `2xx` ou a expiré.

Solution : Inspectez le corps de la réponse de livraison sur la page Webhooks, déployez un correctif, puis exécutez l'événement.

Réessayer : rejouez manuellement une fois que le point de terminaison est sain.

Exemple d'enregistrement de livraison :

```json
{
"event_id": "evt_123",
"status": "échec",
"code_réponse": 500,
"latency_ms": 842,
"next_retry": nul
}
```

## Jeton d'accès invalide

Cause : Le jeton du porteur pour TextTree est manquant, mal formé, expiré, révoqué ou n'a pas le
portée requise.

Solution : actualisez la session du navigateur, émettez un nouveau jeton d'agent ou incluez la portée manquante.

Réessayer : réessayez avec un jeton valide.

```json
{
"erreur": {
"code": "non autorisé",
"message": "Un jeton d'accès TextTree valide est requis."
  }
}
```