# Numéros

URL canonique: https://texttree.ai/fr/docs/numeros/
URL Markdown: https://texttree.ai/fr/docs/numeros.md
Type de page: docs
Translation status: draft
Legal status: english_controls

## Résumé

Louez, connectez et configurez les numéros SMS pour envoyer et recevoir.

## Contenu source

Les numéros de téléphone définissent l'identité de l'expéditeur, le routage entrant, l'état de conformité et les capacités de messagerie.

Commencez avec un expéditeur de test, puis enregistrez ou connectez un expéditeur de production avant de passer à Live.

## Enregistrement du numéro

```json
{
"id": "num_123",
"numéro": "+15557654321",
"friendly_name": "Ligne d'assistance",
"capacités": ["sms", "mms"],
"statut": "actif",
"inbound_webhook_url": "https://example.com/textree/inbound",
"compliance_status": "approuvé",
"created_at": "2026-04-28T14:00:00Z"
}
```

## Flux de configuration

1. Ouvrez les numéros de téléphone dans l'application.
2. Choisissez `Buy number` ou `Connect existing number`.
3. Entrez un indicatif régional lors de l'achat d'un numéro local.
4. Ajoutez un nom convivial afin que les opérateurs puissent reconnaître l'expéditeur.
5. Ajoutez le webhook entrant ou l'URL de secours que vous souhaitez que TextTree utilise.
6. Effectuez les étapes d'enregistrement et de conformité avant le trafic en direct.

Les numéros de marque connectés apparaissent dans le sélecteur d'expéditeur de l'application pour l'expédition
panneau rapide et page de soumission. TextTree valide la propriété et l'état de la connexion
avant le collage et encore avant l'expédition.

##  États de l'expéditeur

- `connected` : enregistré dans TextTree et disponible pour les itinéraires d'expédition configurés.
- `pending` : En attente d'enregistrement, de connexion ou de vérification de conformité.
- `disabled` : non disponible pour les expéditions sortantes.

Si une soumission dans l'application fait référence à un numéro de marque qui est ensuite déconnecté ou n'est plus
appartient à l'espace de travail, la répartition échoue avec `sender_number_unavailable`
au lieu d'utiliser un autre expéditeur.

Le fournisseur SMS n’expose actuellement pas de configuration API documentée des webhooks entrants. Quand
TextTree achète une ligne, les réponses API renvoient `webhook_configured: false` avec
`provider_inbound_webhook_configuration_api_not_documented`; les opérateurs doivent vérifier le routage entrant
avant de faire confiance aux réponses.

## Configuration par API

Le lancement API indique :

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

`POST /api/v1/numbers` accepte `area_code`, `friendly_name` et éventuellement
`inbound_webhook_url`. Les achats en direct restent bloqués sauf si le déploiement le permet explicitement
la garantie de l'achat de numéros en direct.

## Routage entrant

Un SMS entrant reçu sur un numéro peut créer ou mettre à jour :

- journaux de messages
- fils de conversation
- historique des contacts
- Livraisons de webhooks aux clients
- transférer le statut vers IA

Si une URL de webhook entrant est manquante, le message est toujours enregistré sur TextTree, mais votre application
L'externe ne recevra pas l'événement tant qu'un point de terminaison n'est pas configuré.