PHP download

Download the PHP package scriptdevelop/whatsapp-manager without Composer

On this page you can find all versions of the php package scriptdevelop/whatsapp-manager. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

Table of contents
Download scriptdevelop/whatsapp-manager
More information about scriptdevelop/whatsapp-manager
Files in scriptdevelop/whatsapp-manager

Vendor scriptdevelop
Package whatsapp-manager
Short Description Paquete para manejo de WhatsApp Business API en Laravel
License MIT

Keywords api notifications messaging chat laravel whatsapp

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:

If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.

Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
To use Composer is sometimes complicated. Especially for beginners.
Composer needs much resources. Sometimes they are not available on a simple webspace.
If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.

Please rate this library. Is it a good library?

Example code of scriptdevelop/whatsapp-manager

Informations about the package whatsapp-manager

WhatsApp Business API Manager for Laravel

LARAVEL WHatsapp Manager

🌐 Language / Idioma

🇪🇸 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

Introducción
- Qué es el paquete
- Objetivos principales
Descripción
- Funcionalidades clave
Instalación
- Prerequisitos (cuenta WhatsApp API Cloud)
Pasos básicos
- Configuración inicial
- Migraciones y seeders
- Directorios multimedia
- Configuración de webhooks en Meta
Estructura del Paquete
- Diagrama de directorios
- Componentes principales
Guía de Usuario
- Gestión de cuentas
- Registro de cuentas de negocio
- Obtener detalles de números
- Obtener cuentas de negocio
- Envío de mensajes
- Texto simple
- Texto con enlaces
- Respuestas a mensajes
- Reacciones
- Multimedia (imágenes, stickers, audio, documentos)
- Ubicación
- Botones interactivos
- Listas desplegables
- Plantillas
- Obtener plantillas
- Eliminar plantillas
- Editar plantillas
- Crear plantillas (utilidad, marketing, con imágenes, con botones)
- Enviar mensajes con plantillas
Eventos
- Configuración
- Eventos disponibles
- Pruebas
Bots (próximamente en paquete separado)
Laravel Reverb
- Instalación
- Configuración
- Uso con eventos
Contribución
- Cómo colaborar
- Guía de estilo
Soporte y Contacto
- Canales de soporte
- Información de desarrollo
Licencia

❤️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 💙

🚀 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.

Bots conversacionales con flujos dinámicos.

Sincronización automática de números telefónicos y perfiles.

Soporte para campañas masivas programadas.

100% compatible con Laravel Echo y Reverb para notificaciones en tiempo real.

🚀 Instalación

Necesitaras una cuenta de Whatsapp API CLoud

Si quieres saber como obtener una completamente GRATIS mira estos dos videos:

Instala el paquete vía Composer:
Publica la configuración (opcional):
Configuración
- Configuración principal (config/whatsapp.php):
- Configuración de logs (config/logging.php):
- Configuración principal del paquete:
  
  Añadir el canal whatsapp.
Publica las migraciones (opcional): Este comando publicará las migraciones del paquete en tu directorio database/migrations. Puedes personalizarlas según tus necesidades antes de ejecutarlas.
Publica las rutas (OBLIGATORIO):
- Se necesita para el webhook.
- Excluir rutas del webhook de CSRF:
  
  Al publicar las rutas es importante anexar las rutas del webhook a las excepciones del CSRF. En bootstrap/app.php:
Configura tus credenciales en .env: Variables de configuracion necesarias en el archivo .env
Migraciones
- Ejecuta las migraciones para crear las tablas necesarias:
- Esto ejecutará las migraciones necesarias para crear las tablas requeridas por el paquete en tu base de datos.
Seeder de idiomas para plantillas Puedes publicar el seeder que incluye todos los idiomas compatibles con plantillas de WhatsApp con el siguiente comando:

⚠️ ¡Advertencia! ⚠️ Los seeders son necesarios para trabajar con plantillas. Debes tomarlo en cuenta. Luego de publicarlo, puedes ejecutarlo con:
Publicar directorios multimedia para WhatsApp. Para almacenar mensajes multimedia entrantes (audios, imágenes, documentos, etc.) necesitas crear los siguientes directorios en storage/app/public/whatsapp:
- Puedes crearlos automáticamente ejecutando:
- O, si no se crean automáticamente, puedes hacerlo manualmente:
Crear enlace simbólico del storage. Para que los archivos sean accesibles públicamente, ejecuta:

Esto crea el enlace public/storage apuntando a storage/app/public, requerido por Laravel para servir archivos correctamente.

Configuración de Webhooks en Meta

Para que tu aplicación reciba notificaciones en tiempo real de WhatsApp (mensajes entrantes, cambios de estado, etc.), debes configurar correctamente el webhook en la plataforma de Meta Developers. Sigue estos pasos:

a) Accede a Meta Developers

Ingresa a Meta for Developers.
Selecciona tu aplicación o crea una nueva si aún no la tienes.

b) Configura el Webhook

Ve al menú Productos y selecciona WhatsApp > Configuración.
Busca la sección Webhooks y haz clic en Configurar o Editar.

c) Define la URL del Webhook

La URL debe apuntar a la ruta publicada por el paquete, por ejemplo:
Asegúrate de que esta ruta sea accesible públicamente (puedes usar ngrok para pruebas locales).

d) Establece el Token de Verificación

El Token debe coincidir exactamente con el valor de la variable WHATSAPP_VERIFY_TOKEN que definiste en tu archivo .env.
Ejemplo:

e) Selecciona los Eventos a Suscribir

Marca los siguientes eventos para recibir notificaciones relevantes:
- messages
- message_statuses
Puedes agregar otros eventos según tus necesidades (por ejemplo, message_template_status_update).

f) Guarda y Verifica

Al guardar, Meta enviará una solicitud de verificación a tu endpoint. El paquete responderá automáticamente si la configuración es correcta.
Si usas HTTPS, asegúrate de que tu certificado SSL sea válido.

Resumen de configuración:

Parámetro	Valor recomendado
URL del Webhook	`https://tudominio.com/whatsapp-webhook`
Token	El valor de `WHATSAPP_VERIFY_TOKEN` en tu `.env`
Eventos	`messages`, `message_statuses`

Tip: Si desarrollas localmente, puedes exponer tu servidor con ngrok:

Usa la URL pública generada por ngrok como URL del webhook en Meta.

NROCK

ngrok es una utilidad que te permite exponer tu servidor local a Internet de forma segura mediante túneles. Es ideal para pruebas, desarrollo y para compartir tu aplicación local con servicios externos (por ejemplo, para recibir webhooks de WhatsApp o Meta).

Cómo usar ngrok:

Descarga ngrok desde https://ngrok.com/.
Instálalo siguiendo las instrucciones de la página oficial.
Ejecuta el siguiente comando para exponer tu servidor local (por ejemplo, en el puerto 8000):

Esto generará una URL pública que podrás compartir para acceder a tu aplicación local desde cualquier lugar, útil para pruebas de webhooks y desarrollo remoto.

🧩 Estructura del Paquete

❤️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 💙

Guía de Usuario

1. Registro de Cuentas de Negocios.

Registra una cuenta de negocios en WhatsApp Business API.

Se hace la peticion a la API de whatsapp, se obtienen los datos de la cuenta y se almacenan en la base de datos. Este metodo obtiene los datos de la cuenta, los telefonos de whatsapp asociados a la cuenta y el perfil de cada numero de telefono.
Se usa para Obtener los datos desde la API y alojarlos en la base de datos.

2. Obtener Detalles de Números de Teléfono

Obtén información detallada sobre un número de teléfono registrado.

Se hace la peticion a la API de whatsapp para obtener detalles del numero de whatsapp y se almacenan en la base de datos, si el numero ya existe actualiza la informacion.

3. Obtener Cuentas de Negocios

Obtén información sobre una cuenta de negocios específica. Se hace la peticion a la API de whatsapp para obtener informacion sobre una cuenta en especifico, se almacenan los datos en la base de datos.

4. Enviar Mensajes.

Envía mensajes de texto simples.
Enviar Mensajes de Texto con Enlaces Envía mensajes de texto simples con link o enlace.
Enviar Respuestas a Mensajes Responde a un mensaje existente.
Enviar Reacciones a Mensajes Envía una reacción a un mensaje existente.

Sintaxis Unicode requerida
- Usa la codificación \u{código_hex} para emojis:
Enviar Mensajes Multimedia Enviar mensajes con Imágenes
⚠️ Advertencia: Asegúrate de que la imagen que envíes cumpla con los requisitos de WhatsApp:
- Formato soportado: JPEG, PNG
- Tamaño máximo recomendado: 5 MB
- Dimensiones recomendadas: al menos 640x640 px
  Si la imagen no cumple con estos requisitos, el envío puede fallar.
Enviar Imágenes por URL Enviar mensaaje con url de imagen.
Enviar Sticker Enviar mensajes con sticker.
⚠️ Advertencia: Asegúrate de que el sticker que envíes cumpla con los requisitos de WhatsApp:
- Formato soportado: WEBP
- Tamaño máximo recomendado: 100 KB
  Si el sticker no cumple con estos requisitos, el envío puede fallar.
Enviar Audio Enviar mensajes con archivo de audio.
⚠️ Advertencia: Asegúrate de que el archivo de audio que envíes cumpla con los requisitos de WhatsApp:
- Formato soportado: AAC, MP4, MPEG, AMR, OGG.
- Tamaño máximo recomendado: 16 MB
  Si el archivo de audio no cumple con estos requisitos, el envío puede fallar.
Enviar Audio por URL Enviar mensaje con Enlace de audio
Enviar Documentos Enviar mensaje con Documento
⚠️ Advertencia: Asegúrate de que el archivo de documento que envíes cumpla con los requisitos de WhatsApp:
- Formatos soportados: PDF, DOC, DOCX, XLS, XLSX, PPT, PPTX, TXT, CSV, ZIP, RAR, entre otros.
- Tamaño máximo recomendado: 100 MB
  Si el archivo no cumple con estos requisitos, el envío puede fallar.
Enviar Documentos por URL Enviar mensaje de enlace de documento.
Enviar Mensajes de Ubicación Envía un mensaje con coordenadas de ubicación.
Mensajes con Botones Interactivos Enviar mensajes con botones interactivos:
Listas Desplegables Interactivas Enveria mensajes con Listas desplegables interactivas:
Mensaje de Producto Individual Enviar mensaje de Producto Simple.
Mensaje con Múltiples Productos Enviar mensaje de Multiples Productos.
Mensaje de Catálogo Completo Enviar mensaje de Catalogo completo.
Mensaje de Producto como Respuesta o Replica Enviar mensaje de Producto simple con replica o contecto.
Mensaje Interactivo con Productos (Avanzado) Enviar mensaje de Productos Interactivos Avanzados y con Replica o contexto.

5. Marcar mensaje como leido

Se encarga de marcar el mensaje recibido como leido, con los dos checks azules.

❤️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 💙

6. Administracion de Plantillas

Obtener todas las plantillas de una cuenta de whatsapp Se obtienen todas las plantillas de una cuenta de whatsapp y se almacenan en la base de datos. Se hace la peticion a la API de whatsapp para obtener todas las plantillas que estan asociadas a la cuenta de whatsapp.
Obtener una plantilla por el nombre. Se hace la peticion a la API de whatsapp para obtener una plantilla por el nombre y se almacena en la base de datos.
Obtener una plantilla por el ID. Se hace la peticion a la API de whatsapp para obtener una plantilla por el ID y se almacena en la base de datos.
Eliminar plantilla de la API y de la base de datos al mismo tiempo. Se hace la peticion a la API de whatsapp para obtener una plantilla por el ID y se elimina la plantilla seleccionada, Existen dos maneras de eliminar Soft Delete y Hard Delete.
Editar plantilla de la API y de la base de datos al mismo tiempo. Se hace la peticion a la API de whatsapp para editar la plantilla seleccionada.

Agregar componentes a plantillas que no lo tenian:

Eliminar componentes existentes:

Trabajar con componentes específicos:

Características Clave del Edit Template

1.- Gestión completa de componentes:
    - Métodos add, change, remove para cada tipo de componente
    - Métodos has para verificar existencia
    - Métodos get para obtener datos

2.- Validaciones robustas:
    - Unicidad de componentes (solo un HEADER, BODY, etc.)
    - Componentes obligatorios (BODY siempre requerido)
    - Límites de botones (máximo 10)
    - Restricciones de modificación (no cambiar categoría, no modificar aprobadas)

3.- Operaciones atómicas:
    - removeButtonAt: Elimina un botón específico
    - removeAllButtons: Elimina todos los botones
    - getButtons: Obtiene todos los botones actuales

4.- Manejo de errores:
    - Excepciones específicas para problemas de componentes
    - Excepciones para fallos en la actualización
    - Mensajes de error claros y descriptivos

5.- Flujo intuitivo:
    - $template->edit() inicia la edición
    - Encadenamiento de métodos para modificaciones
    - update() aplica los cambios

❤️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 💙

Crear las plantillas en una cuenta de whatsapp

Crear Plantillas de Utilidad

Las plantillas transaccionales son ideales para notificaciones como confirmaciones de pedidos, actualizaciones de envío, etc.

Crear Plantillas de Marketing

Las plantillas de marketing son útiles para promociones, descuentos y campañas masivas.

Crear Plantillas de Marketing con Imágenes

Las plantillas de marketing también pueden incluir imágenes en el encabezado para hacerlas más atractivas.

Crear Plantillas de Marketing con Botones de URL

Puedes agregar botones de URL personalizados para redirigir a los usuarios a páginas específicas.

Crear Variaciones de Plantillas de Marketing

Puedes crear múltiples variaciones de plantillas para diferentes propósitos.

Notas
- Verifica que las imágenes usadas en las plantillas cumplan con los requisitos de la API de WhatsApp: formato (JPEG, PNG), tamaño máximo permitido y dimensiones recomendadas.
- Los botones de tipo URL pueden aceptar parámetros dinámicos mediante variables de plantilla ({{1}}, {{2}}, etc.), lo que permite personalizar los enlaces para cada destinatario.
- Si experimentas problemas al crear plantillas, consulta los archivos de log para obtener información detallada sobre posibles errores y su solución.

❤️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 💙

Enviar Mensajes a partir de Plantilla creada.

Enviar mensajes de plantillas

Puedes enviar diferentes mensajes de plantillas segun la estructura de la plantilla.

❤️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 💙

📦 Instalación de Laravel Reverb

1. Instala Laravel Reverb vía Composer

En una nueva terminal, ejecuta el siguiente comando:

2. Publica los archivos de configuración de Reverb

Esto generará el archivo config/reverb.php y ajustará tu broadcasting.php para incluir el driver reverb.

3. Configura tu archivo .env

Agrega o ajusta las siguientes variables:

⚠️ Estos valores deben coincidir con los definidos en config/reverb.php.

4. Configura config/broadcasting.php

Asegúrate de que el driver predeterminado sea reverb:

Y dentro del array connections, asegúrate de tener esto:

🚀 Levantar el servidor Reverb

En una nueva terminal, ejecuta el siguiente comando:

Deberías ver algo como:

El servidor WebSocket quedará activo en 127.0.0.1:8080.

🌐 Configurar Laravel Echo (Frontend)

1. Instala las dependencias de frontend:

Instalar Laravel Echo y PusherJS

2. Configura Echo en resources/js/bootstrap.js o donde inicialices tu JS:

3. Asegúrate de tener las variables necesarias en tu .env frontend (Vite):

📡 Escuchar eventos (ejemplo en JS)

📁 Configuración en el paquete

En tu archivo config/whatsapp.php asegúrate de tener:

Y en tu .env:

Recuerde que si decide utilizar canales privados debe utilizar los caneles en routes-channel.php

🧪 Prueba de Eventos

Puedes emitir manualmente un evento de prueba con:

🖥️ Escuchar desde el frontend

Canal Privado

Canal publico

📡 Eventos del Paquete

El paquete incluye una serie de eventos que se disparan automáticamente en diferentes situaciones. Estos eventos son compatibles con Laravel Echo y Laravel Reverb, lo que permite escuchar y reaccionar a ellos en tiempo real desde el frontend.

Configuración de Eventos

Configurar el tipo de canal de transmisión: En el archivo whatsapp.php, asegúrate de definir el tipo de canal (public o private):

En tu archivo .env:
Configurar Laravel Echo o Laravel Reverb:
- Instala Laravel Echo y PusherJS:
- Configura Echo en resources/js/bootstrap.js:
- Asegúrate de tener las variables necesarias en tu .env frontend:

Eventos Disponibles

A continuación, se describen los eventos disponibles en el paquete, cómo se configuran y cómo escucharlos desde el frontend.

Evento	Canal	Alias
BusinessSettingsUpdated	whatsapp.business	business.settings.updated
MessageReceived	whatsapp.messages	message.received
MessageDelivered	whatsapp.status	message.delivered
MessageRead	whatsapp.status	message.read
TemplateCreated	whatsapp.templates	template.created
TemplateApproved	whatsapp.templates	template.approved
TemplateRejected	whatsapp.templates	template.rejected
InteractiveMessageReceived	whatsapp.messages	interactive.received
MediaMessageReceived	whatsapp.messages	media.received