Hidroperforaciones SA — Blueprint de Automatización

HIDROPERFORACIONES SA

Blueprint de Automatizacion — Bot Inteligente + CRM + Flujos de Campo

Bot Multi-Agentico + Copilotos Super Inteligentes | Servidor Ubuntu 24/7
1
Resumen Ejecutivo

Objetivo: Automatizar el 90%+ del ciclo de ventas y seguimiento de Hidroperforaciones SA mediante un bot inteligente que habla como humano, conoce toda la data tecnica, cierra ventas de forma autonoma, y mantiene un CRM impecable.

Infraestructura

  • Servidor dedicado con Ubuntu (oficina propia)
  • Bot Multi-Agentico 24/7
  • Copilotos Super Inteligentes
  • PostgreSQL local
  • 48-100 conversaciones/mes

Canales

  • WhatsApp (canal principal - Baileys)
  • Web chat (opcional fase 2)
  • Dashboard admin (Next.js)

Capacidades del Bot

  • Habla como asesor humano experto
  • Conoce toda la data tecnica al detalle
  • Cierra ventas de forma autonoma
  • Genera cotizaciones PDF con membrete
  • Escala solo cuando es necesario

Equipo

  • Super Admins: Dueno + Desarrollador
  • Admins (6): Gilda, Mario, Ana, Victor, Rene, Pablo
  • Horario humano: 8:00 AM - 9:00 PM
  • Bot: 24/7 sin parar
2
Arquitectura del Sistema
SERVIDOR (Ubuntu 24/7)
Bot Multi-Agentico :18789
PostgreSQL :5432
Dashboard Web Next.js :3000
Custom Skills
  • Cotizador Tecnico
  • Asignador de Leads
  • Generador PDF
  • Motor de Escalamiento
  • Reporte Diario
  • Flujo de Campo
  • CRM Manager
Copilotos Super Inteligentes OAuth
ClawSec Seguridad
Nginx + SSL Let's Encrypt
WhatsApp Baileys
Clientes
cualquier #
Admins
6 numeros
Super Admins
dueno + dev
Stack tecnologico:
Bot Multi-Agentico Copilotos Super Inteligentes TypeScript PostgreSQL Next.js Baileys (WhatsApp) Puppeteer (PDF) ClawSec Nginx Ubuntu
3
Flujo de Trabajo Completo
Principio fundamental: El bot es el vendedor estrella. Cierra ventas solo, cotiza, agenda, y resuelve. Solo escala a humano cuando el cliente lo pide explicitamente o la pregunta no esta en su base de conocimiento.

FASE 1 — Primer Contacto

Cliente

Escribe por WhatsApp

Bot (como humano)

"Buenas! Bienvenido a Hidroperforaciones, en que le podemos ayudar?"

CRM

Busca numero en BD: ¿Cliente existente o nuevo?

Cliente existente

"Don Juan, que gusto saludarlo de nuevo! ¿Como le fue con el mantenimiento que le hicimos?"

Cliente nuevo

Inicia captura de datos. Abre nuevo registro en CRM automaticamente.

FASE 2 — Deteccion de Intencion + Recoleccion de Datos

Deteccion automatica

¿Que necesita el cliente?

Pozo nuevo
Pregunta los 10 datos obligatorios de forma conversacional

Mantenimiento
6 datos para cotizar: profundidad, diametro, pies, motor, tuberia, perfil

Emergencia
Captura problema urgente, marca como prioritario

Bot recolecta conversacionalmente

No es formulario. Pregunta natural: "¿Sabe a que profundidad esta su pozo?" — va recolectando de a poco

CRM — Actualizacion en tiempo real

Cada dato que el cliente da se guarda inmediatamente. Transcripcion completa adjunta.

FASE 3 — Cotizacion y Cierre (El Bot Vende)

Bot calcula

Con datos completos: calcula bomba/motor/tuberia, genera cotizacion con margenes

Bot presenta por WhatsApp

"Basado en lo que me cuenta, para su pozo de 120m con bomba de 3HP le recomendamos el mantenimiento intermedio. La inversion seria de Q12,500 que incluye..."

Respuesta del cliente

¿Acepta, tiene dudas, o quiere hablar con humano?

Acepta
Genera PDF formal con logo y membrete. Envia por WhatsApp. Agenda visita del tecnico.

Tiene dudas
Bot resuelve con data tecnica completa. Sigue intentando cerrar.

Quiere humano
"Con todo gusto le paso con un asesor" → Fase 4 (Escalamiento)

CRM — Registro completo

Cotizacion adjunta (PDF), transcripcion, estado actualizado, monto, tipo de servicio

FASE 4 — Escalamiento a Humano (solo si lo pide o pregunta rebuscada)

Verificacion de horario

¿Estamos entre 8:00 AM y 9:00 PM?

Horario (8am-9pm)

Asigna admin con menor carga. Timer 5 min. Bot le pasa TODA la info recolectada al admin como resumen.

Fuera de horario

Bot sigue atendiendo solo. Si no puede resolver: "Manana a primera hora le contacta un asesor." Cola para las 8am.

Admin toma el lead

Admin responde "listo" / "va" / cualquier confirmacion. Bot registra en CRM.

Bot hace seguimiento al Admin

30 min despues: "¿En que quedaron con el cliente?" Admin responde → Bot actualiza CRM automaticamente

FASE 5 — Trabajo de Campo

Tecnico en sitio

Reporta por WhatsApp: checklist, fotos de evidencia, materiales usados

¿Necesita materiales extra?

Materiales no contemplados en cotizacion original

Si — Aprobacion

Solicitud a Super Admin por WhatsApp. Aprueba/rechaza desde el chat.

No — Continua

Trabajo sigue normal. Evidencias se suben al CRM.

CRM — Evidencia completa

Fotos, checklist, materiales, tiempos, aprobaciones — todo adjunto al servicio

FASE 6 — Cierre y Post-Servicio

Bot al cliente

"Su servicio ha sido completado. ¿Todo quedo en orden? ¿Alguna observacion?"

CRM

Captura feedback, calificacion. Marca servicio como CERRADO.

Seguimiento automatico (30 dias)

"Don Juan, ya paso un mes desde su mantenimiento. ¿Como ha funcionado su bomba?"

FASE 7 — Reportes Automaticos

Reporte diario — 9:00 PM

Leads nuevos, cotizaciones enviadas, cierres del dia, alertas SLA, resumen por admin

Reporte semanal — Lunes 8:00 AM

KPIs por vendedor, conversion por servicio, ticket promedio, leads perdidos y motivo, ranking

Bot a las 8:00 AM (diario)

Distribuye a cada admin los leads pendientes de la noche anterior, equitativamente por carga

4
Cadena de Escalamiento (8am - 9pm)
Regla: Fuera de horario (9pm-8am) el bot atiende solo. A las 8am distribuye pendientes. El escalamiento a humanos solo corre en horario de atencion.
Bot no puede resolver
o cliente pide humano
Admin 1
(menor carga)
5 min
sin respuesta
Admin 2
(siguiente)
5 min
sin respuesta
Admin N
(rotacion)
Todos
fallaron
DIRECTOR
(Super Admin)
+ Reporte completo
Al escalar al director: El bot envia un reporte detallado con: quien no respondio, tiempos, datos del cliente, y todo el historial de la conversacion. No llega informacion incompleta.

Lo que el Admin recibe cuando le asignan un lead:

Nuevo lead asignado:

Cliente: Juan Perez
Tel: 5555-1234
Ubicacion: Zona 16, Guatemala
Necesidad: Mantenimiento intermedio
Pozo: 120m prof, 6" diametro, bomba 3HP
Cotizacion enviada: Q12,500
Estado: Cliente acepto, pendiente agendar visita

Resumen conversacion: Cliente tiene pozo de 8 anios, nota baja presion hace 2 meses. Nivel dinamico 80m, estatico 45m. Agua para consumo humano.

Tenes 5 minutos para confirmar.
5
CRM — Impecable, Sin Duplicados
Regla anti-duplicados: 1 cliente = 1 numero de telefono = 1 registro. Si el mismo cliente necesita otro servicio, se abre un nuevo SERVICIO dentro de su registro, nunca un cliente duplicado.
Vista Admin (Asesor)
Vista Super Admin
Timeline de Cliente

CRM — Mario Ramirez

8
Leads activos
94%
SLA
Q45K
Pipeline
JP
Juan Perez — Zona 16
Mant. intermedio Q12,500 · Cotizacion enviada · 2 servicios previos
Cotizado
ML
Maria Lopez — Zona 10
Perforacion nueva Q185,000 · Visita agendada 25/mar
En campo
PR
Pedro Ruiz — Mixco
Emergencia bomba · Recibido 11:45pm anoche · Bot atendio
Urgente
CA
Carlos Alvarez — Antigua
Mant. basico Q8,500 · Cerrado ayer · Seguimiento en 30 dias
Cerrado
SG
Sofia Garcia — Zona 14
Mant. completo · Primer contacto hace 20 min · Bot cerrando
Nuevo

CRM GENERAL — Super Admin

47
Leads totales
12
Cierres mes
Q380K
Vendido
MR
Mario Ramirez
8 leads · 3 cierres · SLA 94% · Ticket prom Q18,500
Top
AC
Ana Castro
5 leads · 2 cierres · SLA 100% · Ticket prom Q22,000
Bien
VG
Victor Gomez
6 leads · 1 cierre · SLA 87% · 2 SLA fallidos esta semana
Alerta
GG
Gilda Garcia
10 leads · 3 cierres · SLA 98% · Ticket prom Q15,000
Bien
RD
Rene Dominguez
9 leads · 2 cierres · SLA 91% · Ticket prom Q25,000
Normal
PM
Pablo Mollinedo
9 leads · 1 cierre · SLA 89% · 1 SLA fallido esta semana
Normal

Juan Perez — Historial completo (2 servicios)

15 Mar 2026 · 10:23 AM
Primer contacto — Cliente escribio por WhatsApp pidiendo informacion de mantenimiento
15 Mar 2026 · 10:23 - 10:41 AM
Bot recolecto datos — Pozo 120m, 6", bomba 3HP, nivel dinamico 80m, estatico 45m, agua potable
Transcripcion completa
15 Mar 2026 · 10:42 AM
Cotizacion generada — Mantenimiento intermedio Q12,500
PDF Cotizacion #0247
15 Mar 2026 · 10:45 AM
Cliente acepto cotizacion — Bot cerro la venta sin intervencion humana
15 Mar 2026 · 10:46 AM
Asignado a Mario Ramirez — Para coordinar visita tecnica
18 Mar 2026 · 8:00 AM
Visita tecnica — Tecnico reporto checklist completo
4 fotos evidencia
Checklist campo
18 Mar 2026 · 4:30 PM
Servicio completado — Cliente satisfecho, calificacion 5/5
22 Mar 2026 · 3:15 PM
Cliente volvio — Ahora quiere cotizar perforacion nueva en terreno adjunto
22 Mar 2026 · 3:20 PM
Nuevo servicio abierto — Perforacion nueva, cotizacion Q185,000
PDF Cotizacion #0263
22 Mar 2026 · Presente
Esperando confirmacion — Seguimiento programado para 25/mar
Resumen cliente: 2 servicios (1 cerrado, 1 pendiente) · Valor lifetime: Q197,500 · Cliente recurrente · Satisfaccion: 5/5
6
Sistema de Roles (por Numero de Telefono)
Autenticacion: El numero de WhatsApp ES el login. No se necesita usuario/contrasena. Los numeros de super admin y admin estan pre-registrados en la base de datos.
FuncionSuper AdminAdmin (Asesor)Cliente
Recibir y atender leadsSISI
Ver TODOS los leads del sistemaSINO (solo suyos)
Reasignar leads manualmenteSINO
Ver KPIs de todos los asesoresSINO (solo suyos)
Aprobar materiales/productos extraSINO
Modificar precios y margenesSINO
Recibir reportes diarios/semanalesSINO
Recibir alertas de SLA incumplidoSI
Agregar/quitar admins del sistemaSINO
Configurar bot (SOUL.md, skills)SINO
Cotizar y cerrar ventasSISI
Actualizar estado de leadSISI (solo suyos)
Subir evidencia de campoSISI
Consultar estado de su servicioSI
Recibir cotizacion PDFSI
Pedir hablar con humanoSI
7
Base de Conocimiento del Bot (SOUL.md)
Regla de oro: El bot debe recitar toda esta informacion al pie de la letra cuando el cliente pregunte. Si una pregunta no esta cubierta aqui, el bot escala a un admin y luego se incorpora la respuesta a la base de conocimiento.

Datos para Cotizar Mantenimiento

  • Profundidad del pozo
  • Diametro del entubado (pulgadas)
  • A cuantos pies esta instalado el equipo
  • Tipo de motor y bomba
  • Diametro de la tuberia de columna
  • Perfil del pozo (tiempo de uso)

10 Datos para Calcular Bomba/Motor

  • Nivel dinamico del pozo
  • Nivel estatico del pozo
  • Profundidad total del pozo
  • Corte del pozo (ubicacion ranuradas)
  • Diametro del pozo
  • Aforo
  • Distancia hacia tanque de agua
  • Corriente electrica en el lugar
  • Para que va a servir el agua
  • Diametro y tuberia instalada

Mantenimiento Basico (10 hrs)

  • Extraccion de equipo sumergible y tuberia
  • Chequeo tecnico de equipo sumergible
  • 10 hrs limpieza mecanica (cepillado, pistoneado, cubeteado)
  • Limpieza componentes electricos del panel
  • Medicion de niveles (dinamico y estatico)
  • Mediciones electricas bomba y motor
  • Instalacion de equipos y tuberia de descarga

Mantenimiento Intermedio (24 hrs)

  • Extraccion de equipo
  • Inspeccion con camara
  • Revision de paneles
  • Limpieza mecanica 24 hrs
  • Instalacion completa

Mantenimiento Completo (30 hrs)

  • Extraccion de equipo
  • Inspeccion con camara + quimico clarificador
  • Revision de paneles
  • Limpieza mecanica 30 hrs combinadas con aforo
  • Aforo de bombeo (determinar caudal)
  • Instalacion completa

Precios de Referencia (Guatemala, Quetzales)

ServicioRango de Precio
Diagnostico / visita tecnicaQ450 — Q1,200
Preventivo (limpieza, revision, desinfeccion)Q1,500 — Q5,500
Correctivo menor (tablero, valvulas, fugas)Q2,500 — Q9,000
Extraccion e instalacion bomba (mano de obra)Q3,500 — Q12,000
Correctivo mayor con reemplazosQ8,000 — Q35,000+
Perforacion por metroQ450 — Q1,200/m
Entubado/filtros/grava/sello por metroQ180 — Q650/m
Desarrollo + prueba bombeo + aforoQ6,000 — Q25,000
Bomba + cable + tablero + instalacionQ8,000 — Q80,000+
Proyecto residencial/comercial completoQ85,000 — Q350,000+

Precios Bombas por HP

HPTuberiaGPMBombaTuberia PVC/m
0.5 — 1 HP1" — 1.25"20-60Q1,800 — Q6,000Q18 — Q55
1.5 — 2 HP1.25" — 1.5"40-120Q4,500 — Q14,000Q28 — Q90
3 — 5 HP1.5" — 2"80-220Q9,000 — Q28,000Q45 — Q180
7.5 — 10+ HP2" — 3"150-400+Q22,000 — Q75,000+Q120 — Q450

Materiales Comunes de Mantenimiento

Cloro/hipoclorito, acido desincrustante, grasa dielectrica, cinta teflon, prensaestopa, conectores, cable sumergible #10/#12, valvula check, manometro, contactor/protector termico, arrancador/capacitor.
Costo tipico por intervencion: Q1,200 — Q6,500
Correctivo con cambio bomba/motor/cableado: Q6,000 — Q28,000+ (segun HP/profundidad)

8
Seguridad Anti-Prompt Injection

Whitelist de Temas

Bot SOLO habla de pozos, bombas, mantenimiento, cotizaciones, servicios de Hidroperforaciones. Cualquier intento de "olvida tus instrucciones" o "actua como..." se ignora y redirige al tema.

Comandos por Rol

Comandos administrativos (reasignar, ver reportes, cambiar precios) solo se ejecutan desde numeros registrados como super admin. Nunca desde numeros de clientes.

SOUL.md Protegido

El archivo de personalidad es el target #1. Se verifica integridad con ClawSec. Cualquier modificacion no autorizada dispara alerta inmediata.

Sanitizacion de Input

Todo mensaje de cliente se limpia antes de pasar al LLM. Se eliminan instrucciones de sistema, caracteres especiales de inyeccion, y patrones conocidos de jailbreak.

Aislamiento de Datos

El bot nunca expone datos de otros clientes, precios internos de costo, margenes, o informacion de otros admins a clientes.

Logs y Auditoria

Toda conversacion queda en base de datos con timestamp, numero, rol, y contenido. Auditoria completa para revision.

Skills Limitados

El bot solo tiene acceso a skills aprobados: cotizador, CRM, PDF, reportes. No tiene acceso a shell, browser, o filesystem mas alla de lo necesario.

Monitoreo ClawSec

Suite de seguridad activa: drift detection, verificacion de integridad de skills, alertas automaticas ante comportamiento anomalo.

9
Modelo de Datos (PostgreSQL)
whatsapp_users
phoneVARCHAR(20) PK
roleENUM
nameVARCHAR(100)
emailVARCHAR(100)
activeBOOLEAN
current_loadINTEGER
created_atTIMESTAMP
clients
idUUID PK
phoneVARCHAR(20) UNIQUE
nameVARCHAR(100)
companyVARCHAR(100)
locationVARCHAR(200)
emailVARCHAR(100)
lifetime_valueDECIMAL
total_servicesINTEGER
satisfaction_avgDECIMAL
last_interactionTIMESTAMP
created_atTIMESTAMP
services
idUUID PK
client_idUUID FK → clients
admin_phoneFK → users
typeENUM
statusENUM
well_dataJSONB
quote_amountDECIMAL
quote_pdf_urlVARCHAR
field_checklistJSONB
field_photosTEXT[]
materials_usedJSONB
materials_approvedBOOLEAN
feedback_scoreINTEGER
feedback_textTEXT
next_followupTIMESTAMP
closed_atTIMESTAMP
created_atTIMESTAMP
conversations
idUUID PK
service_idUUID FK → services
client_idUUID FK → clients
participant_phoneVARCHAR(20)
participant_roleENUM
transcriptJSONB
summaryTEXT
created_atTIMESTAMP
lead_assignments
idUUID PK
service_idUUID FK → services
admin_phoneFK → users
assigned_atTIMESTAMP
responded_atTIMESTAMP
response_time_secINTEGER
sla_metBOOLEAN
escalatedBOOLEAN
notesTEXT
admin_followups
idUUID PK
service_idUUID FK → services
admin_phoneFK → users
questionTEXT
responseTEXT
crm_updateJSONB
asked_atTIMESTAMP
answered_atTIMESTAMP
10
KPIs y Metricas
100
Conversaciones / mes
Meta
<30s
Primera respuesta (bot)
Automatico
<5min
Respuesta admin (SLA)
Con escalamiento
70%+
Cierre por bot (sin humano)
Objetivo
90%+
Leads calificados
Con datos completos
95%+
SLA cumplido
Objetivo equipo

Metricas que se rastrean

Por Asesor

  • ▸ Leads asignados / cerrados
  • ▸ Tiempo promedio de respuesta
  • ▸ % SLA cumplido
  • ▸ Ticket promedio (Q)
  • ▸ Tasa de conversion
  • ▸ SLA incumplidos esta semana

General

  • ▸ Conversaciones totales / mes
  • ▸ % cerrado por bot vs humano
  • ▸ Conversion por tipo de servicio
  • ▸ Valor total pipeline
  • ▸ Leads perdidos + motivo
  • ▸ Satisfaccion promedio post-servicio
11
Pricing (Tu Oferta al Cliente)
Basico
$2,800 USD setup
+ $320/mes
  • Bot WhatsApp 24/7 (Baileys)
  • Primer contacto automatico (nuevo vs existente)
  • Deteccion de intencion automatica
  • Recoleccion conversacional de datos
  • CRM basico (anti-duplicados)
  • Cotizador automatico
  • Sistema de roles por telefono
  • 3 admins
  • Reportes semanales
Premium
$5,000 USD setup
+ $950/mes
  • Todo lo del Pro
  • Flujo de campo completo (checklist, fotos, evidencia)
  • Aprobacion de materiales via WhatsApp
  • Admins ilimitados
  • Seguridad avanzada (ClawSec)
  • KPIs avanzados con rankings y alertas SLA
  • Personalizacion completa del SOUL.md
  • Soporte prioritario
12
Demo — Conversacion Real de WhatsApp

Asi se ve una conversacion real del bot cerrando una venta de mantenimiento:

Resultado: El bot cerro la venta en 5 minutos, recolecto los datos tecnicos, genero cotizacion PDF, y esta agendando la visita. Todo sin intervencion humana. El CRM ya tiene el registro completo.

HIDROPERFORACIONES SA — Blueprint de Automatizacion v1.0

Bot Multi-Agentico + Copilotos Super Inteligentes | Servidor Ubuntu | WhatsApp 24/7

Documento generado: Marzo 2026