{"id":29602019,"url":"https://github.com/wolfslender/wp-whatsapp-business","last_synced_at":"2025-07-20T13:37:34.007Z","repository":{"id":305444891,"uuid":"1022904357","full_name":"wolfslender/wp-whatsapp-business","owner":"wolfslender","description":"Business plugin for WordPress that allows full integration with WhatsApp Business API.","archived":false,"fork":false,"pushed_at":"2025-07-20T06:18:12.000Z","size":107,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-07-20T07:21:49.411Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/wolfslender.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-07-20T05:14:43.000Z","updated_at":"2025-07-20T06:18:15.000Z","dependencies_parsed_at":"2025-07-20T07:21:50.742Z","dependency_job_id":"020353af-7018-4f98-a285-22cb561e5cf8","html_url":"https://github.com/wolfslender/wp-whatsapp-business","commit_stats":null,"previous_names":["wolfslender/wp-whatsapp-business"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/wolfslender/wp-whatsapp-business","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wolfslender%2Fwp-whatsapp-business","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wolfslender%2Fwp-whatsapp-business/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wolfslender%2Fwp-whatsapp-business/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wolfslender%2Fwp-whatsapp-business/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/wolfslender","download_url":"https://codeload.github.com/wolfslender/wp-whatsapp-business/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wolfslender%2Fwp-whatsapp-business/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":266135070,"owners_count":23881776,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-07-20T13:37:29.363Z","updated_at":"2025-07-20T13:37:34.002Z","avatar_url":"https://github.com/wolfslender.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"# WP WhatsApp Business\n\nPlugin empresarial para WordPress que permite la integración completa con WhatsApp Business API.\n\n## Características\n\n- **Widget flotante personalizable** - Botón de WhatsApp que aparece en todas las páginas\n- **Shortcodes flexibles** - Múltiples shortcodes para diferentes necesidades\n- **Configuración avanzada** - Panel de administración completo con validaciones\n- **Horarios de negocio** - Control automático de disponibilidad según horarios\n- **Mensajes personalizados** - Diferentes mensajes por página/post\n- **Integración con API** - Envío de mensajes a través de WhatsApp Business API\n- **Responsive design** - Funciona perfectamente en móviles y tablets\n- **Multilingüe** - Soporte completo para internacionalización\n\n## Requisitos\n\n- WordPress 5.0 o superior\n- PHP 7.4 o superior\n- Composer (para instalación de dependencias)\n- Cuenta de WhatsApp Business API\n\n## Instalación\n\n### 1. Instalación manual\n\n1. Descarga el plugin y extráelo en la carpeta `/wp-content/plugins/`\n2. Navega a la carpeta del plugin y ejecuta:\n   ```bash\n   composer install\n   ```\n3. Activa el plugin desde el panel de administración de WordPress\n4. Configura tu API Key de WhatsApp Business en la página de configuración\n\n### 2. Instalación con Composer\n\n```bash\ncomposer require wp-whatsapp-business/wp-whatsapp-business\n```\n\n## Configuración\n\n### Configuración básica\n\n1. Ve a **WhatsApp Business \u003e Configuración** en el panel de administración\n2. Ingresa tu **API Key** de WhatsApp Business\n3. Configura tu **Phone Number ID**\n4. Ingresa tu **número de teléfono** en formato internacional (+1234567890)\n5. Establece el **nombre de tu negocio**\n6. Habilita el plugin\n\n### Configuración de horarios\n\nConfigura los horarios de tu negocio para que el widget solo aparezca cuando estés disponible:\n\n- **Lunes a Viernes**: 09:00 - 18:00\n- **Sábado**: 10:00 - 14:00\n- **Domingo**: Cerrado\n\n### Configuración de apariencia\n\nPersonaliza la apariencia del widget:\n\n- **Color del widget**: Personaliza el color principal\n- **Posición**: bottom-right, bottom-left, top-right, top-left\n- **Tamaño**: small, medium, large\n- **Texto personalizado**: Mensaje que aparece en el widget\n\n## Uso\n\n### Widget automático\n\nUna vez configurado, el widget aparecerá automáticamente en todas las páginas del frontend.\n\n### Shortcodes disponibles\n\n#### Shortcode básico\n```\n[whatsapp]\n```\n\n#### Shortcode con parámetros\n```\n[whatsapp phone=\"+1234567890\" message=\"¡Hola! ¿Necesitas ayuda?\" text=\"Chatear ahora\"]\n```\n\n#### Botón de WhatsApp\n```\n[whatsapp_button phone=\"+1234567890\" text=\"Contactar por WhatsApp\" size=\"large\" color=\"#25D366\"]\n```\n\n#### Número de teléfono\n```\n[whatsapp_phone format=\"link\"]\n```\n\n#### Horarios de negocio\n```\n[whatsapp_hours format=\"table\"]\n```\n\n#### Estado del negocio\n```\n[whatsapp_status]\n```\n\n### Meta boxes\n\nEn cada post y página encontrarás un meta box de WhatsApp Business que te permite:\n\n- Habilitar/deshabilitar el widget para esa página específica\n- Configurar un mensaje personalizado\n- Establecer un número de teléfono específico\n\n## API de WhatsApp Business\n\n### Envío de mensajes\n\n```php\n// Obtener el servicio de WhatsApp\n$whatsapp_service = WPWhatsAppBusiness\\Core\\Plugin::getInstance()-\u003egetContainer()-\u003eget('WPWhatsAppBusiness\\Services\\WhatsAppService');\n\n// Enviar mensaje de texto\n$result = $whatsapp_service-\u003esendTextMessage('+1234567890', 'Hola, ¿cómo estás?');\n\n// Enviar mensaje con imagen\n$result = $whatsapp_service-\u003esendImageMessage('+1234567890', 'https://example.com/image.jpg', 'Mira esta imagen');\n\n// Enviar mensaje con botones\n$buttons = [\n    [\n        'type' =\u003e 'reply',\n        'reply' =\u003e [\n            'id' =\u003e 'btn_1',\n            'title' =\u003e 'Sí, me interesa'\n        ]\n    ],\n    [\n        'type' =\u003e 'reply',\n        'reply' =\u003e [\n            'id' =\u003e 'btn_2',\n            'title' =\u003e 'No, gracias'\n        ]\n    ]\n];\n\n$result = $whatsapp_service-\u003esendButtonMessage('+1234567890', '¿Te interesa nuestro producto?', 'Responde con uno de los botones', $buttons);\n```\n\n### Hooks y filtros\n\n#### Filtros disponibles\n\n```php\n// Modificar si se debe mostrar el widget\nadd_filter('wp_whatsapp_business_should_show_widget', function($should_show) {\n    // Tu lógica personalizada\n    return $should_show;\n});\n\n// Modificar la configuración del widget\nadd_filter('wp_whatsapp_business_widget_config', function($config) {\n    // Modificar configuración\n    return $config;\n});\n```\n\n#### Acciones disponibles\n\n```php\n// Cuando se envía un mensaje\nadd_action('wp_whatsapp_business_message_sent', function($result, $phone_number, $message) {\n    // Tu código personalizado\n}, 10, 3);\n\n// Cuando hay un error al enviar mensaje\nadd_action('wp_whatsapp_business_message_error', function($error, $phone_number, $message) {\n    // Tu código personalizado\n}, 10, 3);\n```\n\n## Estructura del plugin\n\n```\nwp-whatsapp-business/\n├── wp-whatsapp-business.php          # Archivo principal del plugin\n├── composer.json                     # Configuración de Composer\n├── README.md                         # Este archivo\n├── src/\n│   ├── Core/                         # Núcleo del plugin\n│   │   ├── Plugin.php               # Clase principal (Singleton)\n│   │   ├── Container.php            # Container de inyección de dependencias\n│   │   └── Loader.php               # Cargador de hooks\n│   ├── Admin/                       # Interfaz de administración\n│   │   ├── AdminInterface.php       # Interfaz principal del admin\n│   │   ├── Settings.php             # Configuración avanzada\n│   │   ├── MetaBoxes.php            # Meta boxes\n│   │   └── views/                   # Vistas del admin\n│   ├── Frontend/                    # Frontend\n│   │   ├── Widget.php               # Widget flotante\n│   │   ├── Shortcodes.php           # Shortcodes\n│   │   └── Assets.php               # Gestión de assets\n│   └── Services/                    # Servicios\n│       ├── WhatsAppService.php      # Servicio de WhatsApp API\n│       ├── ConfigService.php        # Servicio de configuración\n│       └── ValidationService.php    # Servicio de validación\n├── assets/                          # Assets del frontend\n│   ├── css/                         # Hojas de estilo\n│   └── js/                          # Scripts JavaScript\n├── languages/                       # Archivos de idioma\n└── tests/                          # Tests unitarios\n```\n\n## Desarrollo\n\n### Instalación para desarrollo\n\n```bash\ngit clone https://github.com/tu-usuario/wp-whatsapp-business.git\ncd wp-whatsapp-business\ncomposer install\ncomposer install --dev\n```\n\n### Ejecutar tests\n\n```bash\ncomposer test\n```\n\n### Verificar código\n\n```bash\ncomposer phpcs\ncomposer phpcbf\n```\n\n### Generar documentación\n\n```bash\ncomposer docs\n```\n\n## Contribuir\n\n1. Fork el proyecto\n2. Crea una rama para tu feature (`git checkout -b feature/AmazingFeature`)\n3. Commit tus cambios (`git commit -m 'Add some AmazingFeature'`)\n4. Push a la rama (`git push origin feature/AmazingFeature`)\n5. Abre un Pull Request\n\n## Licencia\n\nEste proyecto está licenciado bajo la Licencia GPL v2 o posterior - ver el archivo [LICENSE](LICENSE) para más detalles.\n\n## Soporte\n\nPara soporte técnico, por favor contacta a través de:\n\n- **Email**: oliverodevs@hotmail.com\n- **WhatsApp**: +1 (829) 983-2502\n- **Documentación**: Cooming Soon \n\n## Changelog\n\n### 1.0.0\n- Lanzamiento inicial\n- Widget flotante personalizable\n- Shortcodes básicos\n- Integración con WhatsApp Business API\n- Panel de administración completo\n- Soporte para horarios de negocio\n- Meta boxes para posts y páginas\n\n## Créditos\n\nDesarrollado con ❤️ para la comunidad de WordPress.\n\n---\n\n**Nota**: Este plugin requiere una cuenta de WhatsApp Business API activa para funcionar correctamente.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwolfslender%2Fwp-whatsapp-business","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwolfslender%2Fwp-whatsapp-business","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwolfslender%2Fwp-whatsapp-business/lists"}