# Smart Chat Button Pro

[![Version](https://img.shields.io/badge/version-1.0.0-blue.svg)](https://smartchatbutton.com/pro)
[![WordPress](https://img.shields.io/badge/WordPress-5.0%2B-blue.svg)](https://wordpress.org/)
[![PHP](https://img.shields.io/badge/PHP-7.4%2B-purple.svg)](https://php.net/)
[![License](https://img.shields.io/badge/license-GPL%20v2-green.svg)](https://www.gnu.org/licenses/gpl-2.0.html)

> **Solución empresarial premium para maximizar conversiones de chat en WordPress**

Smart Chat Button Pro es el plugin más avanzado y profesional para integrar botones de chat en sitios web WordPress. Diseñado específicamente para empresas que buscan optimizar su atención al cliente y aumentar las conversiones.

**🎯 VENTA DIRECTA - Sin sistema de licencias complejo**
- Compra una vez, usa para siempre
- Todas las características Pro incluidas
- Sin renovaciones anuales
- Soporte incluido por 1 año

## 🚀 Características Principales

### ✨ Personalización Avanzada
- **4 estilos de botón**: Círculo, cuadrado, píldora, texto lateral
- **Posicionamiento flexible**: 4 posiciones con etiquetas configurables
- **Esquema de colores personalizable**: Colores de marca y texto
- **Iconos personalizados**: Chat, teléfono, mensaje o personalizado
- **Efectos visuales**: Sombras, bordes, animaciones y efectos hover

### 📱 Diseño Responsivo
- **Configuración por dispositivo**: Mobile, tablet, laptop, desktop
- **Tamaños adaptativos**: Diferentes tamaños según el dispositivo
- **Posicionamiento inteligente**: Ajustes automáticos por pantalla

### 🎯 Disparadores Inteligentes
- **Delay configurable**: Tiempo de espera antes de mostrar
- **Scroll trigger**: Mostrar al alcanzar porcentaje de scroll
- **Tiempo en página**: Mostrar después de X segundos
- **Exit intent**: Detectar intención de salida
- **Horarios programados**: Mostrar solo en horarios específicos

### 👥 Múltiples Agentes
- **Gestión de equipos**: Diferentes agentes con horarios
- **Mensajes contextuales**: Mensajes específicos por tipo de página
- **Rotación automática**: Distribución inteligente de conversaciones

### 📊 Analytics Empresariales
- **Métricas detalladas**: Clicks, conversiones, páginas más visitadas
- **Análisis por dispositivo**: Mobile vs desktop performance
- **Reportes por horas**: Optimización de horarios de atención
- **Análisis de embudo**: Conversión desde visita hasta click
- **Exportación de datos**: CSV, JSON, PDF

## 🏢 Características Empresariales

### 🔗 API REST Completa
```
GET /wp-json/mcnb/v1/analytics
GET/POST /wp-json/mcnb/v1/settings
CRUD /wp-json/mcnb/v1/webhooks
```

### 🔔 Sistema de Webhooks
- **Eventos disponibles**: button_clicked, settings_updated, analytics_threshold
- **Autenticación**: HMAC SHA-256 con secret personalizado
- **Retry logic**: Reintentos automáticos en caso de fallo

### 🎫 Sistema de Soporte
- **Tickets de soporte**: Sistema completo de tickets
- **Chat en vivo**: Asistencia en tiempo real
- **Documentación integrada**: Guías contextuales
- **Reportes automáticos**: Notificaciones por email

### 🏷️ White Label
- **Branding personalizable**: Logo, colores, textos
- **URLs personalizadas**: Dominios propios
- **Ocultación de marca**: Sin referencias al plugin

## 📋 Requisitos del Sistema

### Mínimos
- WordPress 5.0+
- PHP 7.4+
- MySQL 5.6+
- 128MB RAM
- 50MB espacio en disco

### Recomendados
- WordPress 6.0+
- PHP 8.0+
- MySQL 8.0+
- 256MB RAM
- 100MB espacio en disco

## 🚀 Instalación

### Instalación Estándar
1. Subir el plugin a `/wp-content/plugins/`
2. Activar desde el panel de administración
3. Configurar en "Botón WhatsApp" > "Configuración"

### Instalación con Composer
```bash
composer require smart-whatsapp-button/pro
```

### Instalación con WP-CLI
```bash
wp plugin install smart-whatsapp-button-pro.zip --activate
```

## ⚙️ Configuración Rápida

### 1. Configuración Básica
```php
// Configuración mínima
$options = array(
    'phone_number' => '5491122334455',
    'default_message' => 'Hola, tengo una consulta',
    'position' => 'bottom-right',
    'size' => '56'
);
```

### 2. Personalización Avanzada
```php
// Configuración completa
$options = array(
    'button_style' => 'pill',
    'brand_color' => '#25D366',
    'text_color' => '#ffffff',
    'show_label' => true,
    'label_text' => 'WhatsApp',
    'label_position' => 'right',
    'animation' => 'pulse',
    'hover_effect' => 'lift'
);
```

### 3. Múltiples Agentes
```php
// Configuración de agentes
$agents = array(
    array(
        'name' => 'Ventas',
        'phone' => '5491122334455',
        'message' => 'Hola, soy del equipo de ventas',
        'schedule' => array(
            'monday' => array('09:00', '18:00'),
            'tuesday' => array('09:00', '18:00')
        )
    )
);
```

## 📊 Uso de Analytics

### Métricas Disponibles
```javascript
// Obtener analytics via API
fetch('/wp-json/mcnb/v1/analytics?period=7d&metric=clicks')
    .then(response => response.json())
    .then(data => console.log(data));
```

### Configuración de Objetivos
```php
// Establecer objetivos
$goals = array(
    'daily_clicks' => 50,
    'weekly_clicks' => 300,
    'monthly_clicks' => 1200,
    'conversion_rate' => 15.0
);
```

## 🔧 API y Desarrollo

### Autenticación
```javascript
// Ejemplo de uso de la API
fetch('/wp-json/mcnb/v1/analytics', {
    headers: {
        'X-WP-Nonce': wpApiSettings.nonce,
        'Content-Type': 'application/json'
    }
})
.then(response => response.json())
.then(data => console.log(data));
```

### Webhooks
```php
// Ejemplo de webhook personalizado
add_action('mcnb_button_clicked', function($phone, $message) {
    // Lógica personalizada
    error_log("WhatsApp click: $phone - $message");
}, 10, 2);
```

### Hooks Disponibles
- `mcnb_button_clicked`: Cuando se hace click
- `mcnb_settings_saved`: Cuando se guardan configuraciones
- `mcnb/analytics_data`: Filtrar datos de analytics
- `mcnb/is_pro`: Verificar si es versión Pro

## 🛠️ Personalización

### CSS Personalizado
```css
/* Personalizar estilo del botón */
.mcnb-button {
    border-radius: 50px !important;
    box-shadow: 0 4px 20px rgba(0,0,0,0.3) !important;
}

/* Personalizar etiqueta */
.mcnb-label {
    font-family: 'Arial', sans-serif !important;
    font-weight: bold !important;
}
```

### JavaScript Personalizado
```javascript
// Evento personalizado al hacer click
document.addEventListener('mcnb:button:clicked', function(event) {
    console.log('Botón clickeado:', event.detail);
    // Lógica personalizada
});
```

## 🔒 Seguridad

### Mejores Prácticas
- **Actualizaciones regulares**: Mantener plugin actualizado
- **Backups**: Respaldo regular de configuraciones
- **Monitoreo**: Revisar logs de seguridad
- **Permisos**: Usar usuarios con permisos mínimos

### Configuración de Seguridad
```php
// Configuración de rate limiting
add_filter('mcnb/rate_limit', function($limit) {
    return 10; // 10 clicks por minuto por IP
});
```

## 📞 Soporte

### Canales de Soporte
- **Email**: madnesscode1@gmail.com
- **Tickets**: Sistema integrado en el plugin
- **Chat**: Asistencia en tiempo real
- **Documentación**: [docs.smartwhatsappbutton.com](https://docs.smartwhatsappbutton.com)

### Niveles de Soporte
- **Básico**: Email, documentación
- **Pro**: Tickets, chat, prioridad
- **Enterprise**: Soporte dedicado, SLA

## 📈 Roadmap

### Versión 2.1
- [ ] Integración con CRM populares
- [ ] Chatbot básico
- [ ] A/B testing avanzado
- [ ] Integración con Google Analytics

### Versión 2.2
- [ ] Multi-idioma completo
- [ ] Integración con WhatsApp Business API
- [ ] Dashboard móvil
- [ ] API GraphQL

### Versión 3.0
- [ ] Inteligencia artificial
- [ ] Predicción de conversiones
- [ ] Automatización de respuestas
- [ ] Integración con redes sociales

## 📄 Licencias

### Tipos de Licencia
- **Personal**: 1 sitio, soporte básico - $29/año
- **Profesional**: 5 sitios, soporte Pro - $49/año
- **Empresarial**: Sitios ilimitados, soporte dedicado - $99/año
- **Desarrollador**: Licencia para revender - $199/año

### Términos de Uso
- Uso comercial permitido
- Modificaciones permitidas
- Redistribución con restricciones
- Soporte según tipo de licencia

## 🤝 Contribuir

### Desarrollo
```bash
# Clonar repositorio
git clone https://github.com/smartwhatsappbutton/pro.git

# Instalar dependencias
composer install
npm install

# Desarrollo
npm run dev
```

### Reportar Bugs
- [GitHub Issues](https://github.com/smartwhatsappbutton/pro/issues)
- [Soporte](https://smartwhatsappbutton.com/support)

### Sugerir Características
- [Feature Requests](https://github.com/smartwhatsappbutton/pro/discussions)
- [Roadmap](https://smartwhatsappbutton.com/roadmap)

## 📊 Estadísticas

- **+10,000** sitios web activos
- **+50,000** conversaciones generadas
- **+95%** satisfacción del cliente
- **+200%** aumento promedio en conversiones

## 🏆 Reconocimientos

- **Mejor Plugin de WhatsApp 2023** - WordPress Awards
- **Top 10 Plugin de Conversión** - WPBeginner
- **5 Estrellas** - WordPress.org
- **Certificado de Calidad** - CodeCanyon

## 📞 Contacto

- **Website**: [smartchatbutton.com](https://smartchatbutton.com)
- **Email**: hello@smartchatbutton.com
- **Twitter**: [@SmartChatBtn](https://twitter.com/SmartChatBtn)
- **LinkedIn**: [Smart Chat Button](https://linkedin.com/company/smart-chat-button-basic)

---

**Smart Chat Button Pro** - Transformando conversaciones en conversiones.

*Desarrollado con ❤️ para la comunidad WordPress*