Visão geral do produto

Resposta direta

O que o TextTree oferece hoje em versão alfa: autenticação Phoenix nativa, mensagens condicionadas à exclusão, webhooks verificados e execução MCP controlada.

Conteúdo fonte

# Visão geral do produto

TextTree é um plano de controle de mensagens de saída para produtos voltados para agentes e desenvolvedores.

O site público funciona no Astro. Aplicativo autenticado, API JSON, webhooks e endpoints MCP são executados
em Fênix. Os dados da Ecto apoiados pelos trabalhadores da Neon e Oban mantêm o status operacional.

## O que existe hoje

A versão alfa atual inclui seis superfícies específicas:

- um site público do Astro para páginas de produtos, documentação e conteúdo de blog
- um console de operador autenticado Phoenix em `/app`
- bootstrap de conta JSON pública para agentes de IA com nome de usuário/senha
- uma API de desenvolvedor para enfileirar e ler mensagens enviadas
- ingestão verificada de webhook para provedores de mensagens e financiamento
- listagem e execução de ferramentas MCP com escopos, cotas, timeouts e logs de auditoria
- Fluxos de trabalho de SMS guiados para envios rápidos a partir do painel, gerenciamento de remetente dedicado,
  configuração de campanha, importação de contatos e inspeção de mensagens

## Fluxo de trabalho do operador

TextTree pode ser usado hoje por meio de uma conta de navegador ou de um agente sem cabeça:

1. Registre-se ou faça login através do TextTree, ou crie uma conta sem cabeça através
   `POST /api/v1/accounts` ou `POST /mcp/accounts`.
2. Use um token de acesso TextTree com os escopos API ou MCP necessários.
3. Confirme se o destinatário não está em um espaço de trabalho ou exclusão de campanha.
4. Defina um limite de gastos em `/app`.
5. Opcionalmente, crie uma sessão de financiamento entre pares em `/app`.
6. Envie mensagens via `POST /api/v1/messages`, página de envio, Fast Send
   do painel ou de uma sequência de campanha.
7. Rastreie o status da mensagem por meio de `GET /api/v1/messages/:id` e eventos do provedor em `/app`.

## Salvaguardas atuais

- As identidades de autenticação nativa do Phoenix são normalizadas para usuários locais do TextTree.
- O bootstrap da conta headless retorna códigos de backup e um portador de token com escopos, e
  está limitado a uma criação de conta bem-sucedida por IP a cada cinco minutos.
- O envio de SMS não requer um registro global do consentimento concedido.
- As exclusões do espaço de trabalho bloqueiam todos os envios para esse número de telefone.
- As exclusões de campanhas bloqueiam apenas os deliverys gerados a partir dessa campanha.
- Os webhooks STOP/excluem do fornecedor criam ou atualizam exclusões de espaço de trabalho antes de envios futuros.
- A despesa é autorizada antes de colocar a chamada na fila do provedor.
- Fast Send do painel, página de envio, envios de API e envios de campanha compartilham o
  mesma rota de segurança de saída.
- Os números de marca conectados podem ser selecionados para remessas únicas. Se um remetente
  selecionado está offline ou não pertence ao espaço de trabalho, o despacho falha
  antes da execução no provedor, em vez de recorrer silenciosamente a outra opção.
- Os webhooks do provedor são verificados, normalizados, desduplicados e repetíveis.
- A execução do MCP é restrita pelos escopos de token TextTree, listas de permissões de servidores, cotas e política de tempo limite.
- As rotas públicas para ofertas de afiliados, hubs e redirecionamentos são desativadas, a menos que o
  O sinalizador de recurso de afiliado `public_routes` está habilitado para esse ambiente.

## Restrições atuais da versão alfa

A documentação neste site descreve a versão alfa implementada, não a eventual superfície do produto.

- Gerenciar exclusões de espaços de trabalho/campanhas e limites de gastos são fluxos de trabalho
  operador em `/app`, não em terminais JSON públicos.
- As mensagens são conduzidas por adaptadores e mantidas atrás dos limites do provedor.
- O financiamento é opcional e atualmente reside atrás dos limites do fornecedor peer.
- As ferramentas MCP são configuradas no servidor; Ainda não existe um editor de registro de ferramentas públicas.
- As configurações da campanha suportam snippets, listas de contatos, importação de CSV, sequências e
  exclusões em `/app`; Ainda não há API JSON pública para campanhas.
- Os ADRs locais do repositório definem a linha de base de implementação atual enquanto o trabalho de importação de especificação canônica ainda está aberto.

## O que ler a seguir

- [Primeiros passos](/docs/getting-started/) para configuração local
- [API do desenvolvedor](/docs/developer-api/) para envio de mensagens e contratos de status
- [Webhooks](/docs/webhooks/) para entregas verificadas por correio e financiamento
- [MCP](/docs/mcp/) para listagem de ferramentas, execução e controles de tempo de execução