WHATSAPP CRM v17 - ASISTENTE IA CONTROLADO
==========================================

Objetivo
--------
Agregar una capa IA profesional para que el bot de WhatsApp responda de forma más natural y coherente consultas de:
- Pagos
- Estado de cuenta
- Instalaciones nuevas
- Soporte técnico básico
- Nuevos clientes
- Planes, costos y cobertura

Seguridad
---------
La IA NO puede:
- imputar pagos
- aprobar comprobantes
- cambiar números de teléfono
- mostrar IP/MAC/MikroTik/ONU/OLT/PON
- mostrar saldo/facturas a números no registrados
- inventar precios o cobertura

Arquitectura
------------
WhatsApp -> webhook.php -> IA segura -> reglas CRM -> respuesta
Si la IA está deshabilitada, falla o la respuesta no es segura, el sistema vuelve al flujo PHP actual.

Archivos incluidos
------------------
_inc/whatsapp/webhook.php
_inc/whatsapp/ai/InterlinkAiAssistant.php
_inc/whatsapp/admin/ai_settings.php
_inc/whatsapp/admin/ai_knowledge.php
_inc/whatsapp/admin/ai_test.php
_inc/whatsapp/sql/whatsapp_ai_v17.sql

Instalación
-----------
1) Backup:

cd /var/www/html
cp _inc/whatsapp/webhook.php _inc/whatsapp/webhook.php.bak_$(date +%F_%H%M)

2) Descomprimir:

cd /var/www/html
unzip -o /root/whatsapp_crm_panel_v17_asistente_ia_controlado.zip
chown -R www-data:www-data /var/www/html/_inc/whatsapp

3) Ejecutar SQL:

mysql -u root -p interlink_crm < /var/www/html/_inc/whatsapp/sql/whatsapp_ai_v17.sql

4) Validar PHP:

php -l /var/www/html/_inc/whatsapp/webhook.php
php -l /var/www/html/_inc/whatsapp/ai/InterlinkAiAssistant.php
php -l /var/www/html/_inc/whatsapp/admin/ai_settings.php
php -l /var/www/html/_inc/whatsapp/admin/ai_knowledge.php
php -l /var/www/html/_inc/whatsapp/admin/ai_test.php

5) Reiniciar Apache:

systemctl restart apache2

URLs
----
Configuración IA:
https://api.solucionesdc.com.ar/_inc/whatsapp/admin/ai_settings.php

Base de conocimiento:
https://api.solucionesdc.com.ar/_inc/whatsapp/admin/ai_knowledge.php

Prueba IA sin enviar WhatsApp:
https://api.solucionesdc.com.ar/_inc/whatsapp/admin/ai_test.php

Configuración recomendada inicial
---------------------------------
Modo: observe o assist
Habilitado: sí
Modelo: gpt-4.1-mini o el modelo que definas en tu cuenta OpenAI
Endpoint: https://api.openai.com/v1/responses

Para guardar API Key:
- Recomendado: exportar variable de entorno OPENAI_API_KEY en Apache/systemd.
- Alternativa: pegarla en ai_settings.php. Se guarda codificada en base64, no es cifrado fuerte.

Prueba
------
Antes de activar automático, usar ai_test.php con ejemplos:
- hola quiero internet para mi casa
- cuanto sale la instalacion
- quiero pagar la cuenta de mi mama
- no tengo internet
- quiero saber mi deuda

Notas
-----
Esta versión no modifica la configuración de CRMInbox ni whatsapp_settings.
No incluye cambios en api.php/settings.php de Meta.
Solo modifica webhook.php para intentar IA antes del flujo PHP clásico.