Descripción general del producto

Respuesta directa

Lo que TextTree ofrece hoy en alfa: autenticación nativa de Phoenix, mensajería condicionada por supresiones, webhooks verificados y ejecución controlada de MCP.

Contenido de la página

# Descripción general del producto

TextTree es un plano de control de mensajería saliente para productos agénticos y orientados a desarrolladores.

El sitio público se ejecuta en Astro. La aplicación autenticada, la API JSON, los webhooks y los endpoints de MCP se ejecutan
en Phoenix. Los datos de Ecto respaldados por Neon y los workers de Oban mantienen el estado operativo.

## Lo que existe hoy

La versión alfa actual incluye seis superficies concretas:

- un sitio público de Astro para páginas de producto, documentación y contenido de blog
- una consola de operador autenticada de Phoenix en `/app`
- bootstrap público de cuentas JSON para agentes de IA con nombre de usuario/contraseña
- una API para desarrolladores para encolar y leer mensajes salientes
- ingesta verificada de webhooks para proveedores de mensajería y financiamiento
- listado y ejecución de herramientas de MCP con scopes, cuotas, tiempos de espera y registros de auditoría
- flujos de trabajo guiados de SMS para envíos rápidos desde el panel, gestión de remitentes dedicados,
  configuración de campañas, importación de contactos e inspección de mensajes

## Flujo de trabajo del operador

TextTree es utilizable hoy a través de una cuenta de navegador o una cuenta de agente headless:

1. Regístrate o inicia sesión a través de TextTree, o crea una cuenta headless a través de
   `POST /api/v1/accounts` o `POST /mcp/accounts`.
2. Usa un token de acceso de TextTree con los scopes de API o MCP requeridos.
3. Confirma que el destinatario no esté bajo una supresión de espacio de trabajo o de campaña.
4. Establece un límite de gasto en `/app`.
5. Opcionalmente, crea una sesión de financiamiento de Peer en `/app`.
6. Envía mensajes a través de `POST /api/v1/messages`, la página de Envío, el envío rápido
   del panel o una secuencia de campaña.
7. Rastrea el estado del mensaje a través de `GET /api/v1/messages/:id` y los eventos de proveedores en `/app`.

## Salvaguardas actuales

- Las identidades de autenticación nativas de Phoenix se normalizan en usuarios locales de TextTree.
- El bootstrap de cuentas headless devuelve códigos de respaldo y un token bearer con scopes, y
  está limitado a una creación de cuenta exitosa por IP cada cinco minutos.
- Los SMS salientes no requieren un registro global de consentimiento otorgado.
- Las supresiones de espacio de trabajo bloquean todos los envíos salientes a ese número de teléfono.
- Las supresiones de campaña bloquean solo las entregas generadas de esa campaña.
- Los webhooks de STOP/exclusión del proveedor crean o actualizan supresiones de espacio de trabajo antes de futuros envíos.
- El gasto se autoriza antes de encolar una llamada al proveedor.
- El envío rápido del panel, la página de Envío, los envíos por API y los envíos de campaña comparten la
  misma ruta de seguridad de salida.
- Los números de marca conectados pueden seleccionarse para envíos puntuales. Si un remitente
  seleccionado está desconectado o no pertenece al espacio de trabajo, el despacho falla
  antes de la ejecución en el proveedor en lugar de recurrir silenciosamente a otra opción.
- Los webhooks de proveedores se verifican, normalizan, deduplican y pueden repetirse.
- La ejecución de MCP está restringida por los scopes de tokens de TextTree, las listas de servidores permitidos, las cuotas y la política de tiempos de espera.
- Las rutas públicas de ofertas de afiliados, hub y redirección están deshabilitadas a menos que la
  bandera de característica de afiliados `public_routes` esté habilitada para ese entorno.

## Restricciones actuales de la versión alfa

La documentación de este sitio describe la versión alfa implementada, no la superficie eventual del producto.

- La gestión de supresiones de espacio de trabajo/campaña y los límites de gasto son flujos de trabajo
  de operador en `/app`, no endpoints JSON públicos.
- La mensajería está impulsada por adaptadores y se mantiene detrás de un límite de proveedor.
- El financiamiento es opcional y actualmente reside detrás del límite del proveedor Peer.
- Las herramientas de MCP se configuran en el servidor; todavía no hay un editor público de registro de herramientas.
- La configuración de campañas admite snippets, listas de contactos, importación CSV, secuencias y
  supresiones dentro de `/app`; todavía no hay una API JSON pública de campañas.
- Los ADR locales del repositorio definen la línea base de implementación actual mientras el trabajo de importación de la especificación canónica sigue abierto.

## Qué leer a continuación

- [Primeros pasos](/docs/getting-started/) para la configuración local
- [API para desarrolladores](/docs/developer-api/) para los contratos de envío y estado de mensajes
- [Webhooks](/docs/webhooks/) para entregas verificadas de mensajería y financiamiento
- [MCP](/docs/mcp/) para el listado de herramientas, la ejecución y los controles de tiempo de ejecución