joemunapo / whatsapp-php
This package provides a seamless integration of the WhatsApp Cloud API for Laravel applications. It offers a flexible. Ideal for multi-tenant applications or businesses managing multiple WhatsApp accounts.
Fund package maintenance!
joemunapo
Requires
- php: ^8.2
- illuminate/contracts: ^10.0||^11.0
- spatie/laravel-package-tools: ^1.16
Requires (Dev)
- laravel/pint: ^1.14
- nunomaduro/collision: ^8.1.1||^7.10.0
- orchestra/testbench: ^9.0.0||^8.22.0
- pestphp/pest: ^2.34
- pestphp/pest-plugin-arch: ^2.7
- pestphp/pest-plugin-laravel: ^2.3
This package is auto-updated.
Last update: 2024-11-19 20:17:08 UTC
README
This package provides a simple and efficient way to integrate WhatsApp Cloud API functionality into your Laravel application.
Installation
You can install the package via composer:
composer require joemunapo/whatsapp-php
Configuration
After installation, publish the configuration file:
php artisan vendor:publish --provider="Joemunapo\Whatsapp\WhatsappServiceProvider"
Update the published config file in config/whatsapp.php
:
return [ 'account_model' => \App\Models\Business::class, 'fields' => [ 'number_id' => 'number_id', 'token' => 'whatsapp_token', 'catalog_id' => 'catalog_id', ], ];
Ensure your database model (e.g., Business
) has the necessary fields to store WhatsApp account details.
Usage
Initializing the WhatsApp instance
use Joemunapo\Whatsapp\Whatsapp; $whatsapp = Whatsapp::useNumberId('your_whatsapp_number_id');
Sending a Text Message
$to = '1234567890'; $content = (object) [ 'type' => 'text', 'text' => [ 'body' => 'Hello, World!' ] ]; $messageId = $whatsapp->sendMessage($to, $content);
Sending an Interactive Message (Buttons)
$content = (object) [ 'type' => 'interactive', 'text' => 'Please choose an option:', 'buttons' => ['Option 1', 'Option 2', 'Option 3'] ]; $whatsapp->sendMessage($to, $content);
Sending Media
$mediaType = 'image'; $mediaUrl = 'https://example.com/image.jpg'; $caption = 'Check out this image!'; $whatsapp->sendMedia($to, $mediaType, $mediaUrl, $caption);
Sending a Template Message
$templateName = 'hello_world'; $languageCode = 'en_US'; $components = [ [ 'type' => 'body', 'parameters' => [ ['type' => 'text', 'text' => 'John Doe'] ] ] ]; $whatsapp->sendTemplate($to, $templateName, $languageCode, $components);
Handling Webhooks
$payload = // ... webhook payload from WhatsApp $message = Whatsapp::handleWebhook($payload); if ($message) { // Process the message $message->reply('Thank you for your message!'); }
Getting Media
When you receive a message with media (like an image, video, or document), you can retrieve the media content using the getMedia
method:
$mediaId = 'media_id_from_webhook_payload'; $mediaInfo = $whatsapp->getMedia($mediaId); // The $mediaInfo will contain details about the media, including the URL to download it $mediaUrl = $mediaInfo['url']; // You can then download and process the media as needed
Features
- Send text messages
- Send interactive messages (buttons, lists, product lists)
- Send media (images, videos, documents)
- Send template messages
- Handle incoming messages via webhooks
- Mark messages as read
- Retrieve media content
Testing
composer test
Changelog
Please see CHANGELOG for more information on what has changed recently.
Contributing
Please see CONTRIBUTING for details.
Security Vulnerabilities
Please review our security policy on how to report security vulnerabilities.
Credits
License
The MIT License (MIT). Please see License File for more information.