WhatsApp Manager
🇪🇸 Español 🇬🇧 English

🚀 Primeros Pasos

⚙️ Configuración

💬 Gestión de Mensajes

📋 Plantillas

📡 Eventos en Tiempo Real

🔧 Avanzado

Documentación Messaging API

Mensajes Interactivos

Send text, media, location, and interactive messages.

Mensajes Interactivos

Para ver la documentación completa de mensajes interactivos, consulta la Documentación Completa de Mensajes.

Enviar Mensajes Interactivos.

  • Mensajes con Botones Interactivos
    Enviar mensajes con botones interactivos:

    use ScriptDevelop\WhatsappManager\Facades\Whatsapp;
use ScriptDevelop\WhatsappManager\Models\WhatsappBusinessAccount;
use ScriptDevelop\WhatsappManager\Models\WhatsappPhoneNumber;

$account = WhatsappBusinessAccount::first();
$phone = $account->phoneNumbers->first();

//EJEMPLO 1
$buttonResponse = Whatsapp::sendButtonMessage($phone->phone_number_id)
    ->to('57', '31371235638')
    ->withBody('¿Confirmas tu cita para mañana a las 3 PM?')
    ->addButton('confirmar', '✅ Confirmar')
    ->addButton('reagendar', '🔄 Reagendar')
    ->withFooter('Por favor selecciona una opción')
    ->send();

//EJEMPLO 2
$buttonResponse = Whatsapp::sendButtonMessage($phone->phone_number_id)
    ->to('57', '31371235638')
    ->withBody('¿Cómo calificarías nuestro servicio?')
    ->addButton('excelente', '⭐️⭐️⭐️⭐️⭐️ Excelente')
    ->addButton('bueno', '⭐️⭐️⭐️⭐️ Bueno')
    ->addButton('regular', '⭐️⭐️⭐️ Regular')
    ->withFooter('Tu opinión nos ayuda a mejorar')
    ->send();

//EJEMPLO 3
// Obtener ID de un mensaje anterior (debes tener uno real)
$contextMessage = \ScriptDevelop\WhatsappManager\Models\Message::first();
$contextId = $contextMessage->wa_id;

$buttonResponse = Whatsapp::sendButtonMessage($phone->phone_number_id)
    ->to('57', '31371235638')
    ->withBody('Selecciona el tipo de soporte que necesitas:')
    ->addButton('soporte-tecnico', '🛠️ Soporte Técnico')
    ->addButton('facturacion', '🧾 Facturación')
    ->addButton('quejas', '📣 Quejas y Reclamos')
    ->withFooter('Horario de atención: L-V 8am-6pm')
    ->inReplyTo($contextId)  // Aquí especificas el mensaje al que respondes
    ->send();

// EJEMPLOS CON HEADER texto
$buttonResponse = Whatsapp::sendButtonMessage($phone->phone_number_id)
    ->to('57', '313714R3534')
    ->withHeader('Catálogo Digital')
    ->withBody('¿Confirmas tu cita para mañana a las 3 PM?')
    ->addButton('confirmar', '✅ Confirmar')
    ->addButton('reagendar', '🔄 Reagendar')
    ->withFooter('Por favor selecciona una opción')
    ->send();

// EJEMPLOS CON HEADER imagen
$file = new \SplFileInfo(storage_path('app/public/laravel-whatsapp-manager.png'));

$buttonResponse = Whatsapp::sendButtonMessage($phone->phone_number_id)
    ->to('57', '313714R3534')
    ->withHeader($file)
    ->withBody('¿Confirmas tu cita para mañana a las 3 PM?')
    ->addButton('confirmar', '✅ Confirmar')
    ->addButton('reagendar', '🔄 Reagendar')
    ->withFooter('Por favor selecciona una opción')
    ->send();

  • Listas Desplegables Interactivas
    Enviar mensajes con Listas desplegables interactivas:

    use ScriptDevelop\WhatsappManager\Facades\Whatsapp;
use ScriptDevelop\WhatsappManager\Models\WhatsappBusinessAccount;
use ScriptDevelop\WhatsappManager\Models\WhatsappPhoneNumber;

$account = WhatsappBusinessAccount::first();
$phone = $account->phoneNumbers->first();

// EJEMLPO 1 - SIN ENCADENAR
$listBuilder = Whatsapp::sendListMessage($phone->phone_number_id)
    ->to('57', '31371235638')
    ->withButtonText('Ver Productos')
    ->withBody('Nuestros productos destacados:')
    ->withHeader('Catálogo Digital')
    ->withFooter('Desliza para ver más opciones');

$listBuilder->startSection('Laptops')
    ->addRow('laptop-pro', 'MacBook Pro', '16" - 32GB RAM - 1TB SSD')
    ->addRow('laptop-air', 'MacBook Air', '13" - M2 Chip - 8GB RAM')
    ->endSection();

$listBuilder->startSection('Smartphones')
    ->addRow('iphone-15', 'iPhone 15 Pro', 'Cámara 48MP - 5G')
    ->addRow('samsung-s23', 'Samsung S23', 'Pantalla AMOLED 120Hz')
    ->endSection();

$response = $listBuilder->send();

// EJEMLPO 2 - ENCADENADO
$listBuilder = Whatsapp::sendListMessage($phone->phone_number_id)
    ->to('57', '31371235638')
    ->withButtonText('Ver Servicios')
    ->withBody('Selecciona el servicio que deseas agendar:')
    ->withFooter('Desliza para ver todas las opciones')
    ->startSection('Cortes de Cabello')
        ->addRow('corte-mujer', 'Corte Mujer', 'Estilo profesional')
        ->addRow('corte-hombre', 'Corte Hombre', 'Técnicas modernas')
        ->addRow('corte-niños', 'Corte Niños', 'Diseños infantiles')
    ->endSection()
    ->startSection('Tratamientos')
        ->addRow('keratina', 'Keratina', 'Tratamiento reparador')
        ->addRow('coloracion', 'Coloración', 'Tintes profesionales')
        ->addRow('mascarilla', 'Mascarilla', 'Hidratación profunda')
    ->endSection();

$response = $listBuilder->send();

// EJEMLPO 3 - respuesta a mensajes o reply
// Obtener ID de un mensaje anterior (debes tener uno real)
$contextMessage = \ScriptDevelop\WhatsappManager\Models\Message::first();
$contextId = $contextMessage->wa_id;

$listBuilder = Whatsapp::sendListMessage($phone->phone_number_id)
    ->to('57', '31371235638')
    ->withButtonText('Seleccionar Servicio')
    ->withBody('Para el tipo de cita que mencionaste, tenemos estas opciones:')
    ->inReplyTo($contextId); // Aquí especificas el mensaje al que respondes

$listBuilder->startSection('Consultas')
    ->addRow('consulta-general', 'Consulta General', '30 min - $50.000')
    ->addRow('consulta-especial', 'Consulta Especializada', '60 min - $90.000')
    ->endSection();

$listBuilder->startSection('Tratamientos')
    ->addRow('tratamiento-basico', 'Tratamiento Básico', 'Sesión individual')
    ->addRow('tratamiento-premium', 'Tratamiento Premium', 'Incluye seguimiento')
    ->endSection();

$response = $listBuilder->send();

// EJEMPLO CON HEADER texto
$listBuilder = Whatsapp::sendListMessage($phone->phone_number_id)
    ->to('57', '313714R3534')
    ->withButtonText('Ver Productos')
    ->withHeader('Catálogo Digital') // HEADER DE TECTO
    ->withBody('Nuestros productos destacados:')
    ->withFooter('Desliza para ver más opciones')
    ->startSection('Laptops')
        ->addRow('laptop-pro', 'MacBook Pro', '16" - 32GB RAM - 1TB SSD')
        ->addRow('laptop-air', 'MacBook Air', '13" - M2 Chip - 8GB RAM')
    ->endSection()
    ->startSection('Smartphones')
        ->addRow('iphone-15', 'iPhone 15 Pro', 'Cámara 48MP - 5G')
        ->addRow('samsung-s23', 'Samsung S23', 'Pantalla AMOLED 120Hz')
    ->endSection()
    ->send();

  • Mensajes de botones URL de llamada a la acción interactivos
    Enviar Mensajes de botones URL de llamada a la acción interactivos:

    use ScriptDevelop\WhatsappManager\Facades\Whatsapp;
use ScriptDevelop\WhatsappManager\Models\WhatsappPhoneNumber;
$phone = WhatsappPhoneNumber::first();

// Ejemplo básico
Whatsapp::sendCtaUrlMessage($phone->phone_number_id)
    ->to('57', '31371235638')
    ->withBody('¡Visita nuestra nueva tienda online!')
    ->withButton('Ver Tienda', 'https://tienda.example.com')
    ->send();

// Ejemplo con header y footer
Whatsapp::sendCtaUrlMessage($phone->phone_number_id)
    ->to('57', '31371235638')
    ->withHeader('Oferta Especial')
    ->withBody('Descuento del 20% en todos los productos')
    ->withButton('Ver Oferta', 'https://tienda.example.com/ofertas')
    ->withFooter('Válido hasta fin de mes')
    ->send();

// Ejemplo con header multimedia "Se debe usar un link de imagen publica para Image, Video, Documento"
$imageUrl = 'https://play-lh.googleusercontent.com/1-hPxafOxdYpYZEOKzNIkSP43HXCNftVJVttoo4ucl7rsMASXW3Xr6GlXURCubE1tA=w3840-h2160-rw';

Whatsapp::sendCtaUrlMessage($phone->phone_number_id)
    ->to('57', '31371235638')
    ->withHeader($imageUrl)
    ->withBody('¡Nueva colección disponible!')
    ->withButton('Ver Colección', 'https://tienda.example.com/nueva-coleccion')
    ->send();

// Ejemplo como respuesta a otro mensaje
$contextMessage = \ScriptDevelop\WhatsappManager\Models\Message::first();
$contextId = $contextMessage->wa_id;

Whatsapp::sendCtaUrlMessage($phone->phone_number_id)
    ->to('57', '31371235638')
    ->withBody('Aquí tienes el enlace que solicitaste:')
    ->withButton('Descargar Documento', 'https://example.com/documento.pdf')
    ->inReplyTo($contextId)
    ->send();

  • Mensajes de botones Interactivo de solicitud de ubicacion
    Enviar Mensajes con boton de solicitud de ubicacion:

    Whatsapp::sendLocationRequestMessage($phone->phone_number_id)
    ->to('57', '31371235638')
    ->withBody('Por favor comparte tu ubicación para ayudarte mejor')
    ->send();

Enviar Mensajes de Producto.

  • Mensaje de Producto Individual
    Enviar mensaje de Producto Simple.

    use ScriptDevelop\WhatsappManager\Facades\Whatsapp;
use ScriptDevelop\WhatsappManager\Models\WhatsappBusinessAccount;
use ScriptDevelop\WhatsappManager\Models\WhatsappPhoneNumber;

$account = WhatsappBusinessAccount::first();
$phone = $account->phoneNumbers->first();

$productId = 'PROD-12345'; // ID del producto en tu catálogo

// Enviar un solo producto con texto descriptivo
WhatsappManager::message()->sendSingleProductMessage(
    $phone->phone_number_id,
    '52',         // Código de país (México)
    '5512345678', // Número de destino
    $productId,
    '¡Mira este increíble producto que tenemos para ti!'
);

  • Mensaje con Múltiples Productos
    Enviar mensaje de Multiples Productos.

    use ScriptDevelop\WhatsappManager\Facades\Whatsapp;
use ScriptDevelop\WhatsappManager\Models\WhatsappBusinessAccount;
use ScriptDevelop\WhatsappManager\Models\WhatsappPhoneNumber;
use ScriptDevelop\WhatsappManager\Services\CatalogProductBuilder;

$account = WhatsappBusinessAccount::first();
$phone = $account->phoneNumbers->first();

$builder = new CatalogProductBuilder(
    WhatsappManager::getDispatcher(), 
    $phone->phone_number_id,
);

$builder->to('52', '5512345678')
    ->withBody('Productos recomendados para ti:')
    ->withHeader('Ofertas Especiales')
    ->withFooter('Válido hasta el 30 de Junio')

    // Sección 1
    ->startSection('Productos Destacados')
        ->addProduct('PROD-12345')
        ->addProduct('PROD-67890')
    ->endSection()

    // Sección 2
    ->startSection('Nuevos Lanzamientos')
        ->addProduct('PROD-54321')
        ->addProduct('PROD-09876')
    ->endSection()

    ->send();

  • Mensaje de Catálogo Completo
    Enviar mensaje de Catalogo completo.

    use ScriptDevelop\WhatsappManager\Facades\Whatsapp;
use ScriptDevelop\WhatsappManager\Models\WhatsappBusinessAccount;
use ScriptDevelop\WhatsappManager\Models\WhatsappPhoneNumber;
use ScriptDevelop\WhatsappManager\Services\CatalogProductBuilder;

$account = WhatsappBusinessAccount::first();
$phone = $account->phoneNumbers->first();

WhatsappManager::message()->sendFullCatalogMessage(
    $phone->phone_number_id,
    '52',
    '5512345678',
    'Ver Catálogo',      // Texto del botón
    'Explora nuestro catálogo completo de productos',
    '¡Envíanos un mensaje para más información!' // Footer
);

  • Mensaje de Producto como Respuesta o Replica
    Enviar mensaje de Producto simple con replica o contecto.

    use ScriptDevelop\WhatsappManager\Facades\Whatsapp;
use ScriptDevelop\WhatsappManager\Models\WhatsappBusinessAccount;
use ScriptDevelop\WhatsappManager\Models\WhatsappPhoneNumber;
use ScriptDevelop\WhatsappManager\Services\CatalogProductBuilder;

$account = WhatsappBusinessAccount::first();
$phone = $account->phoneNumbers->first();

// Responder a un mensaje específico con un producto
$contextMessageId = 'wamid.XXXXXX'; // ID del mensaje original

WhatsappManager::message()->sendSingleProductMessage(
    $phone->phone_number_id,
    '52',
    '5512345678',
    'PROD-12345',
    'Este es el producto que mencionaste:',
    $contextMessageId
);

  • Mensaje Interactivo con Productos (Avanzado)
    Enviar mensaje de Productos Interactivos Avanzados y con Replica o contexto.

    use ScriptDevelop\WhatsappManager\Facades\Whatsapp;
use ScriptDevelop\WhatsappManager\Models\WhatsappBusinessAccount;
use ScriptDevelop\WhatsappManager\Models\WhatsappPhoneNumber;
use ScriptDevelop\WhatsappManager\Services\CatalogProductBuilder;

$account = WhatsappBusinessAccount::first();
$phone = $account->phoneNumbers->first();

WhatsappManager::message()->sendMultiProductMessage(
    $phone->phone_number_id,
    '52',
    '5512345678',
    [
        [
            'title' => 'Ofertas',
            'product_items' => [
                ['product_retailer_id' => 'PROD-123'],
                ['product_retailer_id' => 'PROD-456']
            ]
        ],
        [
            'title' => 'Nuevos',
            'product_items' => [
                ['product_retailer_id' => 'PROD-789']
            ]
        ]
    ],
    '¡Estos productos podrían interesarte!',
    'Descuentos Especiales', // Header
    null, // Footer
    $contextMessageId // Respuesta a mensaje
);

💡 Ver Más<br />
Consulta la documentación completa de mensajes para más detalles sobre mensajes interactivos.

Compartir esta página

Editar esta página en GitHub