Reporte Técnico Final

Agente de ventas autónomo sobre arquitectura Serverless, utilizando el protocolo MCP para integrar WhatsApp, Chatwoot y D1 Database.

Estado Técnico

100% Operativo
Funcional

Worker, D1 y MCP respondiendo correctamente.

Stack

Serverless

Cloudflare Workers + SQLite D1.

Integración

MCP

Herramientas conectadas a datos reales.

Entrega WA

Pendiente
#131037

Bloqueo administrativo de Meta (Display Name).

Resumen Ejecutivo: Este proyecto implementa un "Middleware Inteligente" que conecta usuarios de WhatsApp con una base de datos de inventario. A diferencia de chatbots tradicionales, utiliza el Model Context Protocol (MCP) para dar a la IA herramientas reales de ejecución (buscar, crear carrito, transferir), todo supervisado a través de Chatwoot.

Arquitectura de Flujo de Datos

El sistema está diseñado para ser asíncrono y escalable. Haga clic en los componentes para entender su función en el flujo.

Usuario WhatsApp
+54 9 11...
Meta Cloud API
Webhook POST
Cloudflare Worker
Orquestador & Lógica
Chatwoot
Dashboard & CRM
Laburen AI
Claude 3.5 Sonnet
D1 Database
SQLite Inventory

Detalle del Componente

Seleccione un nodo del diagrama para ver su función técnica.

Latencia Promedio (ms)

Ingeniería Destacada

La Solución "Espejo" de Chatwoot

La API de Chatwoot bloquea la creación artificial de mensajes entrantes (`incoming`) en canales oficiales de WhatsApp. Esto creaba un problema: el agente humano veía las respuestas del bot, pero no las preguntas del usuario. Solución: Inyectar Notas Privadas.

El Problema

Chatwoot rechaza `POST /messages` con tipo 'incoming' si el canal es WhatsApp Cloud. Resultado: Historial incompleto.

La Solución (Workaround)

El Worker captura el mensaje de Meta y lo inserta como una Nota Privada (`private: true`) antes de procesar la IA. Esto crea una trazabilidad visual perfecta.

Ver Efecto Visual:
Sin Solución Con Solución
U
Usuario WhatsApp
vía Meta Cloud API
ID #21

Protocolo de Contexto (MCP)

La inteligencia del agente reside en estas 5 herramientas que le permiten interactuar con la base de datos y la lógica de negocio.

JSON Payload

Datos del Inventario (D1)

Visualización de los 100 productos cargados en la base de datos D1, categorizados por precio y tipo. El agente utiliza estos datos para responder consultas.

Distribución de Stock por Categoría

Relación Precio vs. Categoría (Plotly)