IA · Automatización

AzirbotAgente de ventas con IA para Instagram, Facebook y WhatsApp

Agente de ventas con IA que responde los comentarios de Instagram y Facebook, abre el DM y lleva al seguidor a WhatsApp con el lead ya capturado y calificado.

Tecnologías

  • NestJS
  • Prisma
  • PostgreSQL
  • OpenAI
  • Anthropic Claude
  • Qdrant
  • API oficial de Meta
  • WAHA
  • Next.js
  • React Flow
  • TanStack Query
  • Recharts
  • TypeScript
Portada del sitio de Azirbot, agente de ventas con IA para Instagram, Facebook y WhatsApp

Mi rol

Desarrollador web y de aplicaciones en Azirgo SAS. Trabajé en el backend de la plataforma, en su integración con IA y búsqueda semántica, y en el panel de administración.

El problema

Un comentario sin responder es una venta que se enfría. En Instagram y Facebook la gente pregunta el precio en público, y para cuando alguien contesta, el interés ya pasó. Responder cada comentario a mano, abrir el privado y pasar la conversación a WhatsApp no escala: el negocio pierde ventas fuera de horario y repite las mismas respuestas todo el día.

Qué construí

  • Detección de comentarios en Instagram y Facebook por palabra clave o por patrón, con respuesta pública y DM automático en segundos.
  • Bandeja unificada: DMs de Instagram, Messenger y chats de WhatsApp en un solo lugar.
  • Botones que abren WhatsApp con el mensaje ya escrito, para no perder al seguidor en el salto de canal.
  • Captura de leads con un interés de 0 a 100 % calculado por la IA (frío, tibio, caliente o muy caliente), con el post de origen y el historial completo.
  • Extracción automática de nombre, teléfono, email e interés a partir de la propia conversación, sin formularios.
  • Constructor visual de flujos: disparadores por comentario, DM o lead; condiciones por palabra clave, canal u horario; acciones que responden, etiquetan y derivan.
  • Catálogo con búsqueda semántica: entiende «algo azul para verano» y recomienda el producto real con su precio.
  • Métricas en tiempo real del embudo y de qué publicación trae más leads.
  • Plataforma multi-tenant sobre una API REST en NestJS, con Prisma y PostgreSQL.

El dashboard

El panel es una app Next.js que habla con la API NestJS por REST en /api/v1 a través de un único cliente fetch, y TanStack Query cachea y refresca cada vista. El guion del bot no vive en el código del panel: los workflows se dibujan en un lienzo de React Flow y se guardan tal cual, como el JSON del grafo que ejecuta el motor de la API.

  • Cada petición lleva el JWT como Bearer y la cabecera x-workspace-id, así la API separa los datos de cada negocio; la sesión dura 14 días, se renueva al abrir el panel y un 401 devuelve al login.
  • La bandeja junta Instagram, Messenger y WhatsApp, refresca la lista cada 15 s y el hilo abierto cada 8 s, marca quién respondió (chatbot o persona) y permite pausar el bot por conversación con reactivación automática.
  • El editor usa @xyflow/react: varios disparadores por flujo, condiciones y acciones, y nodos de Claude o ChatGPT que consultan catálogos, leen imágenes y transcriben notas de voz.
  • Antes de activar un flujo se prueba en un simulador que solo registra lo que haría, y cada ejecución queda en un historial paso a paso con el modelo y los tokens usados.
  • Las estadísticas (KPIs, actividad de 14 días, embudo comentario a lead y termómetro de interés de la IA) se dibujan con Recharts.
  • Los catálogos se indexan en Qdrant con embeddings text-embedding-3-small y el panel incluye una caja para probar la búsqueda por significado.

Por dentro del sitio

  • Azirbot: Resumen del panel: KPIs, actividad de 14 días y embudo de comentario a lead (datos de ejemplo)
    Resumen del panel: KPIs, actividad de 14 días y embudo de comentario a lead (datos de ejemplo).
  • Azirbot: Bandeja unificada con una conversación de WhatsApp atendida por el chatbot y una asesora (datos de ejemplo)
    Bandeja unificada con una conversación de WhatsApp atendida por el chatbot y una asesora (datos de ejemplo).
  • Azirbot: Editor visual de workflows: disparadores, condiciones y nodos de IA (datos de ejemplo)
    Editor visual de workflows: disparadores, condiciones y nodos de IA (datos de ejemplo).
  • Azirbot: Configuración del nodo de Claude: instrucciones del agente y catálogos que consulta (datos de ejemplo)
    Configuración del nodo de Claude: instrucciones del agente y catálogos que consulta (datos de ejemplo).
  • Azirbot: Leads con canal, estado y porcentaje de interés calculado por la IA (datos de ejemplo)
    Leads con canal, estado y porcentaje de interés calculado por la IA (datos de ejemplo).
  • Azirbot: Catálogo de productos con la prueba de búsqueda semántica (datos de ejemplo)
    Catálogo de productos con la prueba de búsqueda semántica (datos de ejemplo).
  • Azirbot: Sitio: guías prácticas organizadas por cuello de botella de ventas
    Sitio: guías prácticas organizadas por cuello de botella de ventas.
  • Azirbot: Sitio: landing por industria, agente de IA para clínicas y consultorios
    Sitio: landing por industria, agente de IA para clínicas y consultorios.

El panel de administración

Cada módulo resuelve una parte de la operación diaria del negocio, sin salir del panel.

  • Resumen

    KPIs de automatizaciones, comentarios, tasa de respuesta, leads y conversaciones sin responder, con la actividad de 14 días, el embudo de comentario a lead y el termómetro de leads de la IA.

  • Bandeja unificada

    DMs de Instagram, Messenger y WhatsApp en una sola lista. Cada respuesta indica si la escribió el chatbot o qué persona del equipo, y el bot se pausa por conversación para pasar a humano.

  • Editor visual de workflows

    Lienzo con disparadores por comentario, DM o nuevo lead, condiciones (palabra clave, horario, día, canal, regex) y acciones que responden, etiquetan, anotan o pausan el bot. Admite varios disparadores por flujo.

  • Nodos de IA

    Respuestas con Claude o ChatGPT con instrucciones propias, modelo, temperatura y catálogos de productos; leen imágenes, transcriben notas de voz y pueden dividir la respuesta en varios mensajes.

  • Simulador, historial y uso de IA

    Prueba un flujo con mensajes de ejemplo sin enviar nada, revisa cada ejecución paso a paso y consulta los tokens y el coste estimado por modelo en 7, 14 o 30 días.

  • Catálogos con búsqueda semántica

    Productos con precio, categoría y atributos indexados en Qdrant con embeddings de OpenAI, con reindexado y una caja para probar qué encontraría la IA.

  • Leads con puntuación de IA

    Ficha por contacto con canal, estado (nuevo, contactado, cliente, descartado), interés de 0 a 100 % calculado por la IA y los datos que la IA capturó de la conversación.

  • Automatizaciones de comentarios

    Palabra clave en un comentario de Instagram o Facebook: respuesta pública, DM y tarjeta con botones de enlace, por publicación y sin repetir al mismo usuario dentro de una ventana.

  • Workspaces y permisos

    Cada negocio en su workspace, con roles de propietario, admin y miembro, y permisos por sección y por acción (enviar en la bandeja, editar o simular workflows, publicar).

  • Conexiones y credenciales

    Apps de Meta y cuentas de Instagram, Facebook y WhatsApp (API oficial o WAHA por QR), claves de IA cifradas en el servidor y una API para que otros sistemas envíen WhatsApp.

Decisiones técnicas

  • Búsqueda semántica con Qdrant y embeddings de OpenAI sobre el catálogo: el agente responde con productos que existen de verdad y con su precio, en vez de improvisarlos.
  • API oficial de Meta con tokens cifrados como vía principal, en lugar de automatizaciones no oficiales que se caen o acaban con la cuenta bloqueada. WAHA queda como transporte opcional de WhatsApp autoalojado, vinculado por QR y con límites contra bloqueos: nunca inicia la conversación, respeta la ventana de respuesta y tiene un tope por contacto.
  • El flujo se configura en un lienzo visual, no en código: quien conoce el negocio puede cambiar el guion sin pedir un despliegue.
  • Multi-tenant desde el diseño, para que cada negocio tenga su catálogo, su tono y su contexto sin instancias separadas.
  • Trazabilidad y logs de cada acción, porque un agente que actúa solo sobre cuentas de redes tiene que ser auditable.

Retos

  • Que el modelo se mantenga dentro del catálogo y las reglas del negocio y no invente productos ni condiciones.
  • Sostener el hilo de una conversación que empieza en un comentario público, sigue en un DM y termina en WhatsApp.
  • Trabajar dentro de los límites y permisos de la API de Meta sin degradar el tiempo de respuesta.
  • Separar bien el contexto entre negocios en una plataforma compartida.

Resultado

Azirbot está en producción como producto propio en azirbot.ai, con agentes por industria (e-commerce, clínicas, inmobiliarias, belleza), atendiendo comentarios y conversaciones sin intervención manual en cada mensaje.

Ver el proyecto

¿Necesitas algo parecido?

Cuéntame qué estás construyendo y te respondo con alcance, stack y una fecha realista.