Números

Resposta direta

Alugue, conecte e configure números de SMS para enviar e receber.

Conteúdo fonte

Os números de telefone definem a identidade do remetente, o roteamento de entrada, o status de conformidade e os recursos de mensagens.

Comece com um remetente de teste e depois registre ou conecte um remetente de produção antes de mudar para Live.

## Registro de 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"
}
```

## Fluxo de configuração

1. Abra Números de telefone no aplicativo.
2. Escolha `Buy number` ou `Connect existing number`.
3. Insira um código de área ao adquirir um número local.
4. Adicione um nome amigável para que os operadores possam reconhecer o remetente.
5. Adicione o webhook de entrada ou URL substituto que você deseja que o TextTree use.
6. Conclua as etapas de registro e conformidade antes do tráfego ao vivo.

Os números das marcas conectadas aparecem no seletor de remetente do aplicativo para envio
painel rápido e página de envio. TextTree valida propriedade e status de conexão
antes de colar e novamente antes do envio.

## Estados do remetente

- `connected`: salvo no TextTree e disponível para rotas de envio configuradas.
- `pending`: Aguardando registro, conexão ou revisão de conformidade.
- `disabled`: não disponível para remessas de saída.

Se um envio no aplicativo fizer referência a um número de marca que será posteriormente desconectado ou não será mais
pertence ao espaço de trabalho, o despacho falha com `sender_number_unavailable`
em vez de usar outro remetente.

O provedor de SMS não expõe atualmente uma API de configuração de webhook de entrada documentada. Quando
TextTree compra uma linha, as respostas da API retornam `webhook_configured: false` com
`provider_inbound_webhook_configuration_api_not_documented`; os operadores devem verificar o roteamento de entrada
antes de confiar nas respostas.

## Configuração por API

A API de lançamento expõe:

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

`POST /api/v1/numbers` aceita `area_code`, `friendly_name` e opcionalmente
`inbound_webhook_url`. As compras em tempo real permanecem bloqueadas, a menos que a implantação permita explicitamente
a salvaguarda da compra de números reais.

## Roteamento de entrada

Um SMS recebido em um número pode criar ou atualizar:

- registros de mensagens
- tópicos de conversa
- histórico de contato
- entregas de webhook para clientes
- transferir status para IA

Se um URL de webhook de entrada estiver faltando, a mensagem ainda será registrada no TextTree, mas seu aplicativo
Externo não receberá o evento até que um endpoint seja configurado.