title: "Addendum 18 — A2A Inter-Org & Convertidor Web-to-WebApp" date: "2026-09-01" author: "GoWeBa Platform Team" tags: ["a2a", "inter-org", "google-a2a", "agent-card", "json-rpc", "web-to-app", "converter", "capacitor", "pwa"]

Addendum 18 — A2A Inter-Org & Convertidor Web-to-WebApp

Descripción General

La Fase 5 incorpora dos capacidades principales a la plataforma:

A2A Inter-Org — Implementación del protocolo Google A2A v1.0 (Agent-to-Agent) que permite a MyAtlas comunicarse con agentes de inteligencia artificial de otras organizaciones mediante un estándar abierto.
Convertidor Web-to-WebApp — Una herramienta que analiza sitios web existentes y genera automáticamente configuraciones de aplicaciones móviles listas para su despliegue a través de WebaApp Studio.

A2A Inter-Org — Protocolo Agent-to-Agent

¿Qué es A2A?

A2A es un protocolo abierto creado por Google que permite a los agentes de inteligencia artificial comunicarse entre sí de manera estandarizada, independientemente de su proveedor o framework. MyAtlas implementa la versión 1.0 del protocolo.

Arquitectura

┌───────────────────────────────────────────────────────────────┐
│                    MYATLAS (Nuestro Agente)                    │
│                                                               │
│  /.well-known/agent-card.json   ← Tarjeta pública del agente  │
│  /api/v1/a2a-interorg/rpc       ← Endpoint JSON-RPC 2.0      │
│  /api/v1/a2a-interorg/partners  ← Registro de socios          │
│  /api/v1/a2a-interorg/tasks     ← Ciclo de vida de tareas     │
└───────────────┬───────────────────────────────┬───────────────┘
                │ HMAC-SHA256                    │
                ▼                               ▼
┌──────────────────────┐         ┌──────────────────────────┐
│ Agente Socio A       │         │  Agente Socio B           │
│ (p. ej. Soporte)     │         │  (p. ej. Contabilidad IA) │
└──────────────────────┘         └──────────────────────────┘

Agent Card — Identidad del Agente

MyAtlas expone su agent card (tarjeta de identidad del agente) en la URL estandarizada:

GET https://api.myatlas.world/.well-known/agent-card.json

Esta tarjeta declara 8 habilidades:

Habilidad	Descripción
crm-contact-lookup	Buscar contactos en el CRM
deal-pipeline-query	Consultar el pipeline de ventas
knowledge-search	Buscar en la base de conocimiento
conversation-summary	Resumir conversaciones con clientes
appointment-booking	Agendar citas
invoice-generation	Generar facturas
lead-qualification	Calificación de leads con IA
report-generation	Generar reportes analíticos

Registro de Socios

Las organizaciones pueden registrar agentes socios para establecer canales de comunicación seguros.

Endpoint	Método	Descripción
`/partners`	POST	Registrar un agente socio
`/partners`	GET	Listar agentes socios
`/partners/:id`	GET	Detalle del socio
`/partners/:id/refresh`	POST	Actualizar agent card
`/partners/:id/status`	PATCH	Activar/desactivar socio
`/partners/:id`	DELETE	Eliminar un socio
`/partners/discover`	POST	Descubrir un agente por URL

Ciclo de Vida de las Tareas

Las tareas A2A siguen un ciclo de vida estandarizado:

submitted → working → input-required → completed
                                      → failed
                                      → canceled

Endpoint	Método	Descripción
`/tasks`	POST	Crear una tarea (saliente o interna)
`/tasks`	GET	Listar tareas (filtro: estado, socio)
`/tasks/:id`	GET	Detalle de la tarea con mensajes
`/tasks/:id/status`	PATCH	Actualizar estado
`/tasks/:id/cancel`	POST	Cancelar una tarea
`/tasks/:id/messages`	POST	Enviar un mensaje
`/tasks/:id/messages`	GET	Obtener mensajes
`/tasks/:id/artifacts`	POST	Agregar un artefacto

Seguridad

HMAC-SHA256 para la verificación de solicitudes JSON-RPC entrantes
Cada socio cuenta con un shared_secret único para la firma
Las tareas están aisladas por organización (multi-tenant)

Estadísticas del Dashboard

GET /api/v1/a2a-interorg/stats devuelve:

Total de socios (activos/inactivos)
Tareas por estado
Tareas entrantes vs. salientes
Total de mensajes y artefactos

Convertidor Web-to-WebApp

Cómo Funciona

El convertidor analiza un sitio web existente y extrae automáticamente la información necesaria para generar una configuración de aplicación móvil equivalente a través de WebaApp Studio.

Pipeline de Análisis

    URL del Sitio Web
         │
         ▼
┌────────────────────┐
│  1. Obtener HTML   │ ← Descargar la página
│  2. Parsear Meta   │ ← Título, descripción, etiquetas OG
│  3. Branding       │ ← Colores, fuentes, logos
│  4. Navegación     │ ← Descubrimiento de páginas/enlaces
│  5. Tecnologías    │ ← WordPress, React, Angular...
│  6. Verificar PWA  │ ← manifest.json, Service Worker
│  7. Responsivo     │ ← Viewport, media queries
└────────┬───────────┘
         │
         ▼
┌────────────────────┐
│  Reporte de        │
│  Análisis          │
│  + Puntuación de   │
│    Conversión      │
└────────┬───────────┘
         │
         ▼
┌────────────────────┐
│  Config Generada:  │
│  • Pantallas       │
│    mapeadas        │
│  • Template suger. │
│  • Capacitor.json  │
│  • manifest.json   │
│  • Assets de tienda│
└────────────────────┘

Tecnologías Detectadas

El escáner identifica automáticamente:

CMS: WordPress, Wix, Squarespace, Shopify, Webflow
Frameworks: React, Angular, Vue.js, Next.js, Nuxt.js
Servidor: Express, Django, Laravel, Ruby on Rails
eCommerce: WooCommerce, Magento, PrestaShop

Endpoints de la API

Todos los endpoints se encuentran bajo /api/v1/web-to-app/.

Endpoint	Método	Descripción
`/analyze`	POST	Analizar un sitio web
`/conversions`	GET	Listar conversiones
`/conversions/:id`	GET	Detalle de la conversión
`/conversions/:id/generate`	POST	Generar configuración de la app
`/conversions/:id/link-app`	POST	Vincular a una app de WebaApp Studio
`/conversions/:id`	DELETE	Eliminar una conversión

Puntuación de Conversión

El análisis produce una puntuación de conversión (0-100) basada en:

Calidad responsiva del sitio
Presencia de PWA (manifest, Service Worker)
Riqueza de metadatos
Consistencia del branding
Número de páginas descubiertas

Integración con WebaApp Studio

Una vez completado el análisis, el convertidor puede:

Generar una configuración completa de Capacitor
Sugerir un template de WebaApp Studio según el tipo de sitio
Extraer assets (logo, favicon, colores) para el listado en tienda
Mapear páginas del sitio web a pantallas nativas
Vincular automáticamente la conversión a una app existente de WebaApp Studio

Tablas de Datos

A2A Inter-Org

Tabla	Contenido
`a2a_partner_agents`	Registro de agentes socios (URL, tarjeta, secreto, estado)
`a2a_tasks`	Tareas A2A con ciclo de vida completo
`a2a_task_messages`	Mensajes intercambiados dentro de las tareas

Web-to-WebApp

Tabla	Contenido
`web_to_app_conversions`	Análisis de sitios + configuraciones generadas

Casos de Uso

A2A Inter-Org

Alianzas con agencias: El agente de soporte de una agencia socia le solicita a MyAtlas calificar un lead en tiempo real.
Ecosistema SaaS: Interconexión con herramientas de contabilidad, recursos humanos o logística mediante A2A.
Automatización inter-empresarial: Intercambio estructurado de datos entre organizaciones sin integraciones a medida.

Web-to-WebApp

Migración a móvil: Un cliente con un sitio en WordPress quiere una aplicación móvil — el convertidor analiza el sitio y genera la configuración con un solo clic.
Auditoría técnica: Evaluación rápida de la "preparación móvil" de un sitio existente antes de proponer una estrategia.
Aceleración de ventas: El equipo comercial puede mostrarle a un prospecto una vista previa de la app móvil en cuestión de segundos.

Fase 5 — Build #524 — Septiembre 2026