PHPackages juszczyk/whatsapp-php-client - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [API Development](/categories/api) 4. / 5. juszczyk/whatsapp-php-client ActiveLibrary[API Development](/categories/api) juszczyk/whatsapp-php-client ============================ WhatsApp API PHP Client Library 0.1.1(7mo ago)01MITPHPPHP ^8.2CI passing Since Jan 6Pushed 7mo agoCompare [ Source](https://github.com/bartoszjuszczyk/whatsapp-php-client)[ Packagist](https://packagist.org/packages/juszczyk/whatsapp-php-client)[ RSS](/packages/juszczyk-whatsapp-php-client/feed)WikiDiscussions master Synced 1w ago READMEChangelog (1)Dependencies (8)Versions (4)Used By (0) WhatsApp Cloud API PHP SDK ========================== [](#whatsapp-cloud-api-php-sdk) [![License](https://camo.githubusercontent.com/7013272bd27ece47364536a221edb554cd69683b68a46fc0ee96881174c4214c/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d626c75652e737667)](LICENSE)[![PHP Version](https://camo.githubusercontent.com/d91d3d1139cf0d8faaa80eeeeac7d3c59c9319e56960ef81c948e4160be4c4c1/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f7068702d253545382e322d3737376262342e737667)](https://www.php.net/)[![Build Status](https://camo.githubusercontent.com/115578ff98ab837ff310d1827a0ec2882a06522d65d60ef94a9b0007fbdc6872/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f626172746f737a6a75737a637a796b2f77686174736170702d7068702d636c69656e742f74657374732e796d6c)](https://github.com/bartoszjuszczyk/whatsapp-php-client/actions) PHP library for the **WhatsApp API**. Designed for modern PHP (8.2+) with clean architecture in mind. This library is HTTP client-agnosticβ€”it works seamlessly with Guzzle, Symfony HTTP Client, or any other PSR-18 implementation. πŸš€ Features (MVP) ---------------- [](#-features-mvp) - βœ… **Send Text Messages** - βœ… **Full PSR-7, PSR-17, and PSR-18 compliance** - βœ… **Strict Types & Readonly Properties** (PHP 8.2) - βœ… **Zero-config instantiation** (via HTTP Discovery) - βœ… **Immutability** (Immutable DTOs) πŸ“¦ Requirements -------------- [](#-requirements) - PHP ^8.2 - Composer - An HTTP Client library (e.g., Guzzle, Symfony HttpClient) πŸ“₯ Installation -------------- [](#-installation) Install the library via Composer: ``` composer require juszczyk/whatsapp-php-client ``` ### Installing an HTTP Client [](#installing-an-http-client) This library relies on the `php-http/discovery` abstraction. If your project does not strictly require a specific HTTP client yet, we recommend installing Guzzle: ``` composer require guzzlehttp/guzzle ``` ⚑ Quick Start ------------- [](#-quick-start) The easiest way to instantiate the client is using the `ClientFactory`. It automatically discovers the installed HTTP client and factories. ``` use Juszczyk\WhatsApp\Factory\ClientFactory; use Juszczyk\WhatsApp\Message\TextMessage; require 'vendor/autoload.php'; // 1. Configuration (Token and Phone Number ID from Meta Developers panel) $token = 'EAAG...'; $phoneId = '105...'; $whatsapp = ClientFactory::create($token, $phoneId); // Recipient's phone number (with country code, no plus sign) $message = new TextMessage('48123456789', 'Hello! This is a test from PHP SDK.'); try { $response = $whatsapp->send($message); echo "Message sent! ID: " . $response['messages'][0]['id']; } catch (\Exception $e) { echo "Error: " . $e->getMessage(); } ``` πŸ—οΈ Architecture & Dependency Injection ------------------------------------------ [](#️-architecture--dependency-injection) If you are using a framework (like Laravel or Symfony) and want to inject your own configured HTTP client (e.g., with a Logger or Retry Middleware), you can bypass the Factory and use the Constructor directly. ``` use Juszczyk\WhatsApp\Client; use Juszczyk\WhatsApp\Config; $config = new Config($token, $phoneId); // You can inject any PSR-18 Client & PSR-17 Factory implementation here $client = new Client($config, $httpClient, $requestFactory, $streamFactory); ``` πŸ§ͺ Testing --------- [](#-testing) This library comes with a set of unit tests using PHPUnit. ``` composer test # or vendor/bin/phpunit ``` Static analysis (PHPStan): ``` vendor/bin/phpstan analyse ``` πŸ—ΊοΈ Roadmap ---------- [](#️-roadmap) Current version is an MVP. Planned features: - Media Messages (Images, Documents) - Template Messages - Interactive Messages (Buttons, Lists) - Webhooks support πŸ“„ License --------- [](#-license) This library is licensed under the **MIT License**. See the [LICENSE](LICENSE) file for details. ### Health Score 29 β€” LowBetter than 57% of packages Maintenance63 Regular maintenance activity Popularity1 Limited adoption so far Community6 Small or concentrated contributor base Maturity40 Maturing project, gaining track record Bus Factor1 Top contributor holds 100% of commits β€” single point of failure How is this calculated?**Maintenance (25%)** β€” Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** β€” Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** β€” Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** β€” Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~0 days Total 2 Last Release 224d ago ### Community Maintainers ![](https://avatars.githubusercontent.com/u/61694969?v=4)[bjuszczyk](/maintainers/bjuszczyk)[@bjuszczyk](https://github.com/bjuszczyk) --- Top Contributors [![bartoszjuszczyk](https://avatars.githubusercontent.com/u/128232518?v=4)](https://github.com/bartoszjuszczyk "bartoszjuszczyk (19 commits)") ### Code Quality TestsPHPUnit Static AnalysisPHPStan Code StylePHP CS Fixer Type Coverage Yes ### Embed Badge ![Health badge](/badges/juszczyk-whatsapp-php-client/health.svg) ``` [![Health](https://phpackages.com/badges/juszczyk-whatsapp-php-client/health.svg)](https://phpackages.com/packages/juszczyk-whatsapp-php-client) ``` ### Alternatives [telnyx/telnyx-php Official Telnyx PHP SDK β€” APIs for Voice, SMS, MMS, WhatsApp, Fax, SIP Trunking, Wireless IoT, Call Control, and more. Build global communications on Telnyx's private carrier-grade network. 36826.2k2](/packages/telnyx-telnyx-php)[flow-php/flow PHP ETL - Extract Transform Load - Data processing framework 86337.5k](/packages/flow-php-flow)[tempest/framework The PHP framework that gets out of your way. 2.3k37.6k21](/packages/tempest-framework)[getbrevo/brevo-php Official PHP SDK for the Brevo API. 1004.1M59](/packages/getbrevo-brevo-php)[sylius/sylius E-Commerce platform for PHP, based on Symfony framework. 8.5k6.0M777](/packages/sylius-sylius)[gotenberg/gotenberg-php A PHP client for interacting with Gotenberg, a developer-friendly API for converting numerous document formats into PDF files, and more! 3906.6M34](/packages/gotenberg-gotenberg-php) PHPackages Β© 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)