scriptdevelop/whatsapp-manager

Paquete para manejo de WhatsApp Business API en Laravel

1.0.392 2025-07-18 16:32 UTC

Requires

• php: ^8.2
• guzzlehttp/guzzle: ^7.0
• laravel/framework: ^12.0

Requires (Dev)

• mockery/mockery: ^1.6
• orchestra/testbench: ^10.2
• phpunit/phpunit: ^12.1

Suggests

• laravel/reverb: Permite recibir eventos websocket desde el paquete vía broadcasting

MIT

• api
• notifications
• messaging
• chat
• laravel
• whatsapp

README

WhatsApp Business API Manager for Laravel

LARAVEL WHatsapp Manager

🌐 Language / Idioma

🇺🇸 English | 🇪🇸 Español

🇪🇸 Español

scriptdevelop/whatsapp-api-manager

Introducción

@djdang3r/whatsapp-api-manager es un paquete diseñado para facilitar la integración y gestión de la API de WhatsApp en tus proyectos. Su objetivo es simplificar la comunicación, el envío y la recepción de mensajes, así como la administración de sesiones y contactos a través de una interfaz intuitiva y fácil de usar.

Descripción

Con este paquete podrás:

• Conectarte fácilmente a la API de WhatsApp.
• Enviar y recibir mensajes de texto, multimedia y archivos.
• Gestionar múltiples sesiones de WhatsApp simultáneamente.
• Administrar contactos, plantillas y mensajes.
• Integrar tu aplicación o servicio con flujos automatizados de mensajes.
• Recibir eventos en tiempo real para reaccionar ante mensajes, cambios de estado y notificaciones.

@djdang3r/whatsapp-api-manager está pensado para desarrolladores que buscan una solución robusta y flexible para interactuar con WhatsApp de manera eficiente, segura y escalable.

📢 Políticas de WhatsApp

🚫 Importante: 🚫

• Asegúrate de cumplir siempre con las Políticas de WhatsApp y sus términos de uso al utilizar este paquete.
• El uso indebido puede resultar en la suspensión de tu cuenta o acciones legales por parte de WhatsApp.
• Revisa periódicamente las actualizaciones de las políticas para evitar inconvenientes.

⚠️ Advertencia: ⚠️

• Este paquete se encuentra actualmente en versión alpha. Esto significa que está en desarrollo activo, puede contener errores y su API está sujeta a cambios importantes.
• Próximamente se lanzará la versión beta. Se recomienda no usarlo en entornos de producción por el momento.

Documentación

📚 Tabla de Contenidos

1. 🚀 Instalación

• Requisitos previos
• Configuración inicial
• Migraciones

2. 🧩 Configuración de API

• Credenciales de Meta
• Configuración de webhooks
• Gestión de números telefónicos

3. 💬 Gestión de Mensajes

• Envío de mensajes (texto, multimedia, ubicación)
• Mensajes interactivos (botones, listas)
• Plantillas de mensajes
• Recepción de mensajes

4. 📋 Gestión de Plantillas

• Creación de plantillas
• Envío de plantillas
• Administración de versiones

5. 📡 Eventos en Tiempo Real

• Configuración de Laravel Echo
• Webhooks integrados
• Tipos de eventos soportados

6. 🧪 Webhook

• Configuracion del Webhook
• Estructura de eventos
• Tipos de mensajes soportados

🚀 Características Principales

• Envía mensajes de texto, multimedia, interactivos y de plantilla.
• Gestion de Templates para Crear, Listar, Eliminar y Probar plantillas.
• Webhooks integrados para recibir mensajes y actualizaciones.
• Gestión de conversaciones con métricas de cobro.
• Sincronización automática de números telefónicos y perfiles.
• 100% compatible con Laravel Echo y Reverb para notificaciones en tiempo real.

❤️ Apoyo

Si este proyecto te resulta útil, considera apoyar su desarrollo:

🤝 ¡Contribuye con el Proyecto!

¿Te gustaría mejorar este paquete? ¡Tu colaboración es fundamental >para seguir creciendo!

🚀 ¿Cómo contribuir?

1. Haz un Fork

   • Haz clic en el botón Fork en la parte superior derecha de este repositorio para crear tu propia copia.

2. Crea una Rama para tu Funcionalidad

   git checkout -b feature/mi-nueva-funcionalidad

3. Realiza tus Cambios y Haz Commit

   git commit -m "Agrega mi nueva funcionalidad"

4. Haz Push a tu Rama

   git push origin feature/mi-nueva-funcionalidad

5. Abre un Pull Request

   • Ve a la pestaña Pull Requests y haz clic en New Pull Request.
   • Describe brevemente tu aporte y por qué es útil.

💡 Sugerencias para contribuir

• Sigue la guía de estilo de código de Laravel.
• Escribe comentarios claros y útiles.
• Incluye pruebas si es posible.
• Si encuentras un bug, abre un Issue antes de enviar el PR.

🙌 ¡Gracias por tu apoyo!

Cada contribución, por pequeña que sea, ayuda a mejorar el proyecto y a la comunidad.
¡No dudes en participar, proponer ideas o reportar problemas!

Descargo de responsabilidad

Este paquete es un proyecto independiente y no está afiliado, respaldado ni soportado por Meta Platforms, Inc.
Todas las marcas registradas, marcas de servicio y logotipos utilizados en esta documentación, incluidos "WhatsApp" y "Facebook", son propiedad de Meta Platforms, Inc.

📄 Licencia

Este proyecto está bajo la licencia MIT. Consulta el archivo LICENSE para más detalles.

👨‍💻 Soporte y Contacto

¿Tienes dudas, problemas o sugerencias?
¡Estamos aquí para ayudarte!

• 📧 Email:
  [e-mail]
  [e-mail]

• 🐞 Reporta un Issue:
  Abrir un Issue en GitHub

• 💬 ¿Ideas o mejoras?
  ¡Tus comentarios y sugerencias son bienvenidos para seguir mejorando este proyecto!

🚀 Desarrollado con ❤️ por ScriptDevelop

✨ Potenciando tu conexión con WhatsApp Business API

🔥 Con el apoyo de:

@vientoquesurcalosmares

❤️Apóyanos con una donación en GitHub Sponsors

Me puedes apoyar como desarrollador open source en GitHub Sponsors:

• Si este proyecto te ha sido útil, puedes apoyarlo con una donación a través de

• O tambien por Mercadopago Colombia. Gracias por tu apoyo 💙

WhatsApp Business API Manager for Laravel

LARAVEL WhatsApp Manager

Introduction

@djdang3r/whatsapp-api-manager is a package designed to simplify the integration and management of the WhatsApp API in your projects. Its goal is to streamline communication, message sending and receiving, as well as session and contact management through an intuitive and easy-to-use interface.

Description

With this package you can:

• Easily connect to the WhatsApp API
• Send and receive text, media, and file messages
• Manage multiple WhatsApp sessions simultaneously
• Manage contacts, templates, and messages
• Integrate your application or service with automated messaging flows
• Receive real-time events to react to messages, status changes, and notifications

@djdang3r/whatsapp-api-manager is designed for developers looking for a robust and flexible solution to interact with WhatsApp efficiently, securely, and scalably.

📢 WhatsApp Policies

🚫 Important: 🚫

• Always ensure compliance with WhatsApp's Policies and terms of use when using this package.
• Misuse may result in account suspension or legal action by WhatsApp.
• Regularly review policy updates to avoid issues.

⚠️ Warning: ⚠️

• This package is currently in alpha version. This means it's under active development, may contain bugs, and its API is subject to significant changes.
• The beta version will be released soon. It's not recommended for production environments at this time.

Documentation

📚 Table of Contents

1. 🚀 Installation

• Prerequisites
• Initial setup
• Migrations

2. 🧩 API Configuration

• Meta credentials
• Webhook setup
• Phone number management

3. 💬 Message Management

• Sending messages (text, media, location)
• Interactive messages (buttons, lists)
• Message templates
• Receiving messages

4. 📋 Template Management

• Template creation
• Sending templates
• Version management

5. 📡 Real-time Events

• Laravel Echo setup
• Integrated webhooks
• Supported event types

6. 🧪 Webhook

• Webhook configuration
• Event structure
• Supported message types

🚀 Key Features

• Send messages - text, media, interactive, and templates
• Template Management - Create, List, Delete, and Test templates
• Integrated webhooks for receiving messages and updates
• Conversation management with billing metrics
• Automatic synchronization of phone numbers and profiles
• 100% compatible with Laravel Echo and Reverb for real-time notifications

❤️ Support

If you find this project useful, consider supporting its development:

🤝 Contribute to the Project!

Would you like to improve this package? Your collaboration is essential to keep growing!

🚀 How to contribute?

1. Fork the Repository

   • Click the Fork button in the top right of this repository to create your own copy.

2. Create a Feature Branch

   git checkout -b feature/my-new-feature

3. Make Changes and Commit

   git commit -m "Add my new feature"

4. Push to Your Branch

   git push origin feature/my-new-feature

5. Open a Pull Request

   • Go to the Pull Requests tab and click New Pull Request
   • Briefly describe your contribution and why it's useful

💡 Contribution Guidelines

• Follow Laravel's coding style guide
• Write clear and helpful comments
• Include tests where possible
• If you find a bug, open an Issue before submitting a PR

🙌 Thank you for your support!

Every contribution, no matter how small, helps improve the project and the community.
Don't hesitate to participate, propose ideas, or report issues!

Disclaimer

This package is an independent project and is not affiliated with, endorsed, or sponsored by Meta Platforms, Inc.
All trademarks, service marks, and logos used in this documentation, including "WhatsApp" and "Facebook", are property of Meta Platforms, Inc.

📄 License

This project is licensed under the MIT License. See the LICENSE file for details.

👨‍💻 Support and Contact

Do you have questions, problems, or suggestions?
We're here to help!

• 📧 Email:
  [e-mail]
  [e-mail]

• 🐞 Report an Issue:
  Open a GitHub Issue

• 💬 Ideas or Improvements?
  Your feedback and suggestions are welcome to keep improving this project!

🚀 Developed with ❤️ by ScriptDevelop

✨ Powering your connection with WhatsApp Business API

🔥 With support from:

@vientoquesurcalosmares

❤️ Support us with a GitHub Sponsors donation

You can support me as an open source developer on GitHub Sponsors:

• If this project has been useful to you, you can support it with a donation through

• Or via Mercadopago Colombia:

Thank you for your support 💙