graph TD %%{init: {'theme': 'mc','layout': 'elk'}}%% Webhook-g58p5[Webhook Input] style Webhook-g58p5 stroke:#a170ff WebScraper-02khb[Web Scraper] style WebScraper-02khb stroke:#a170ff Prompt-1rb8o[<div><img alt="logo" src="/_astro/square-terminal.BMOXc-nZ.svg" style="height: 20px !important;width: 20px !important"/></div>Prompt] style Prompt-1rb8o stroke:#a170ff ParseData-noy6u[<div><img alt="logo" src="/_astro/braces.Djq0PW4_.svg" style="height: 20px !important;width: 20px !important"/></div>URL] style ParseData-noy6u stroke:#a170ff GoogleGenerativeAIModel-2im1w[Gemini] style GoogleGenerativeAIModel-2im1w stroke:#a170ff GoogleGenerativeAIModel-ix68f[Gemini2] style GoogleGenerativeAIModel-ix68f stroke:#a170ff Prompt-nl83t[<div><img alt="logo" src="/_astro/square-terminal.BMOXc-nZ.svg" style="height: 20px !important;width: 20px !important"/></div>Prompt2] style Prompt-nl83t stroke:#a170ff ParseData-cmrba[<div><img alt="logo" src="/_astro/braces.Djq0PW4_.svg" style="height: 20px !important;width: 20px !important"/></div>Correo] style ParseData-cmrba stroke:#a170ff GmailMesageComponent-k8vvq[<div><img alt="logo" src="/_astro/gmail.CLxyIGOu.svg" style="height: 20px !important;width: 20px !important"/></div>Google Gmail Message] style GmailMesageComponent-k8vvq stroke:#a170ff TelegramMessage-4yk18[Telegram Message] style TelegramMessage-4yk18 stroke:#a170ff AdvancedAgent-9y2i7[Analista de negocio] style AdvancedAgent-9y2i7 stroke:#a170ff AdvancedAgent-r5sr7[Generador de informe] style AdvancedAgent-r5sr7 stroke:#a170ff Webhook-g58p5 -.- ParseData-noy6u linkStyle 0 stroke:#a170ff ParseData-noy6u -.- Prompt-1rb8o linkStyle 1 stroke:#a170ff Webhook-g58p5 -.- ParseData-cmrba linkStyle 2 stroke:#a170ff ParseData-cmrba -.- Prompt-nl83t linkStyle 3 stroke:#a170ff Prompt-1rb8o -.- AdvancedAgent-9y2i7 linkStyle 4 stroke:#a170ff WebScraper-02khb -.- AdvancedAgent-9y2i7 linkStyle 5 stroke:#a170ff GoogleGenerativeAIModel-2im1w -.- AdvancedAgent-9y2i7 linkStyle 6 stroke:#a170ff AdvancedAgent-9y2i7 -.- Prompt-nl83t linkStyle 7 stroke:#a170ff Prompt-nl83t -.- AdvancedAgent-r5sr7 linkStyle 8 stroke:#a170ff GmailMesageComponent-k8vvq -.- AdvancedAgent-r5sr7 linkStyle 9 stroke:#a170ff TelegramMessage-4yk18 -.- AdvancedAgent-r5sr7 linkStyle 10 stroke:#a170ff GoogleGenerativeAIModel-ix68f -.- AdvancedAgent-r5sr7 linkStyle 11 stroke:#a170ff

📄 Documentación Técnica – Análisis de negocio web con respuesta por Gmail

🧩 Descripción general

El flujo automatizado recibe la URL de un sitio web y el correo electrónico de un cliente mediante un formulario de Google. Con esa información, un agente de IA analiza la página, identifica oportunidades de automatización y genera un correo persuasivo que se envía al cliente a través de Gmail, mientras se envía una notificación por Telegram al equipo interno. El proceso se ejecuta de forma secuencial sin intervención humana.

⚙️ Funcionalidades principales

Captura automática de datos desde un webhook de Google Forms.
Extracción de correo y URL del payload del formulario.
Generación de prompts para guiar a los modelos de IA.
Análisis web mediante scraping y extracción de contenido relevante.
Redacción automática de correos con tono consultivo y orientado a resultados.
Envío de correo electrónico a través de Gmail sin interacción manual.
Notificación instantánea al equipo interno vía Telegram.
Uso de agentes inteligentes con memoria y manejo de herramientas externas.

🔄 Pasos del flujo de trabajo

Nombre del componente	Rol en el flujo	Entradas clave	Salidas clave
Webhook de Entrada	Recibe el JSON del formulario.	`payload JSON (URL + correo)`	`Datos de entrada (Data)`
Parser de Datos (email)	Extrae el correo del payload.	`Datos de entrada`	`Correo electrónico (Text)`
Parser de Datos (URL)	Extrae la URL del payload.	`Datos de entrada`	`URL (Text)`
Generador de Prompt (URL)	Construye el prompt de análisis web.	`URL`	`Prompt para análisis (Message)`
Agente Analista	Analiza la página y devuelve hallazgos.	`Prompt para análisis`	`Resumen de análisis (Message)`
Generador de Prompt (email)	Construye el prompt para redactar el correo.	`Resumen de análisis`, `Correo`	`Prompt para correo (Message)`
Agente Generador de Informe	Redacta el correo de salida.	`Prompt para correo`	`Correo redactado (Message)`
Enviar Correo	Envía el correo al cliente vía Gmail.	`Correo redactado`, `Correo del cliente`	`Confirmación de envío (Data)`
Notificar en Telegram	Envía una notificación al equipo.	`Correo enviado`, `Cliente`, `URL`	`Mensaje de Telegram (Data)`

🧠 Notas

Credenciales: Se requieren claves de API para Google Generative AI, Gmail y Telegram Bot.
Conexión a Internet: El agente necesita acceder a la página web y a los servicios externos; cualquier interrupción bloquea el flujo.
Límite de tokens: El modelo Gemini está configurado con 4096 tokens máximos, lo que puede limitar la profundidad del análisis si el sitio es muy extenso.
Web Scraper: El scraper solo navega URLs distintas y evita repeticiones; se ejecuta únicamente cuando el agente lo solicita.
Memoria del agente: El agente no utiliza memoria persistente (use_checkpointer = false) para mantener la simplicidad y garantizar respuestas rápidas.
Error handling: En caso de fallo en el envío de correo o notificación, el flujo no se detiene automáticamente; se recomienda implementar lógica de reintentos fuera del flujo.
Privacidad: Se procesa la información del cliente de forma segura; los datos sensibles se eliminan después de la ejecución.
Escalabilidad: Para grandes volúmenes de solicitudes, se sugiere mover el webhook a un servidor con capacidad de paralelismo y considerar límites de tasa de la API de Gmail.