# Números

URL canónica: https://texttree.ai/es-es/docs/numeros/
URL de Markdown: https://texttree.ai/es-es/docs/numeros.md
Tipo de página: docs
Translation status: draft
Legal status: english_controls

## Resumen

Renta, conecta y configura números de SMS para enviar y recibir.

## Contenido de la página

Los números de teléfono definen la identidad del remitente, el enrutamiento entrante, el estado de cumplimiento y las capacidades de mensajería.

Comienza con un remitente de prueba y luego registra o conecta un remitente de producción antes de cambiar a Live.

## Registro del número

```json
{
  "id": "num_123",
  "number": "+15557654321",
  "friendly_name": "Support line",
  "capabilities": ["sms", "mms"],
  "status": "active",
  "inbound_webhook_url": "https://example.com/textree/inbound",
  "compliance_status": "approved",
  "created_at": "2026-04-28T14:00:00Z"
}
```

## Flujo de configuración

1. Abre Números de teléfono en la aplicación.
2. Elige `Buy number` o `Connect existing number`.
3. Introduce un código de área al comprar un número local.
4. Añade un nombre descriptivo para que los operadores puedan reconocer al remitente.
5. Añade el webhook entrante o la URL de respaldo que quieres que TextTree use.
6. Completa los pasos de registro y cumplimiento antes del tráfico en vivo.

Los números de marca conectados aparecen en el selector de remitente de la aplicación para el envío
rápido del panel y la página Enviar. TextTree valida la propiedad y el estado de conexión
antes de encolar y de nuevo antes del despacho.

## Estados del remitente

- `connected`: guardado en TextTree y disponible para las rutas de envío configuradas.
- `pending`: en espera de registro, conexión o revisión de cumplimiento.
- `disabled`: no disponible para envíos salientes.

Si un envío desde la aplicación hace referencia a un número de marca que luego se desconecta o ya no
pertenece al espacio de trabajo, el despacho falla con `sender_number_unavailable`
en lugar de usar otro remitente.

El proveedor de SMS actualmente no expone una API documentada de configuración de webhooks entrantes. Cuando
TextTree compra una línea, las respuestas de la API devuelven `webhook_configured: false` con
`provider_inbound_webhook_configuration_api_not_documented`; los operadores deben verificar el enrutamiento entrante
antes de confiar en las respuestas.

## Configuración por API

La API de lanzamiento expone:

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

`POST /api/v1/numbers` acepta `area_code`, `friendly_name` y opcionalmente
`inbound_webhook_url`. Las compras en vivo permanecen bloqueadas a menos que el despliegue habilite explícitamente
la salvaguarda de compra de números en vivo.

## Enrutamiento entrante

Un SMS entrante recibido en un número puede crear o actualizar:

- registros de mensajes
- hilos de conversación
- historial de contactos
- entregas de webhooks a clientes
- estado de transferencia a IA

Si falta una URL de webhook entrante, el mensaje se registra de todas formas en TextTree, pero tu aplicación
externa no recibirá el evento hasta que se configure un endpoint.