PHPackages                             leandronunes07/evolution-php-sdk - 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. leandronunes07/evolution-php-sdk

ActiveLibrary[API Development](/categories/api)

leandronunes07/evolution-php-sdk
================================

Unofficial PHP SDK for Evolution API

v1.0.0(3mo ago)015—0%MITPHPPHP >=8.1

Since Feb 8Pushed 3mo agoCompare

[ Source](https://github.com/leandronunes07/evolution-php-sdk)[ Packagist](https://packagist.org/packages/leandronunes07/evolution-php-sdk)[ RSS](/packages/leandronunes07-evolution-php-sdk/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependencies (5)Versions (2)Used By (0)

Evolution API PHP SDK
=====================

[](#evolution-api-php-sdk)

[![PHP Version](https://camo.githubusercontent.com/6518db1335bf20fdff07253dc6d6d0cec955b5fb6a8ef1382ac6d73687ecc07f/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f7068702d253345253344382e312d626c7565)](https://camo.githubusercontent.com/6518db1335bf20fdff07253dc6d6d0cec955b5fb6a8ef1382ac6d73687ecc07f/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f7068702d253345253344382e312d626c7565)[![License](https://camo.githubusercontent.com/f8df3091bbe1149f398a5369b2c39e896766f9f6efba3477c63e9b4aa940ef14/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d677265656e)](https://camo.githubusercontent.com/f8df3091bbe1149f398a5369b2c39e896766f9f6efba3477c63e9b4aa940ef14/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d677265656e)[![Version](https://camo.githubusercontent.com/8799d8eff2c6d6038b1674f5971bc903f93acc1cd1174db033675f834fcc7ea7/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f76657273696f6e2d312e302e302d6f72616e6765)](https://camo.githubusercontent.com/8799d8eff2c6d6038b1674f5971bc903f93acc1cd1174db033675f834fcc7ea7/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f76657273696f6e2d312e302e302d6f72616e6765)[![Style](https://camo.githubusercontent.com/daa7000e27de672defd676d02e29c60e412248aac48d614d1398d8f7764bf49b/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f636f64652532307374796c652d5053522d2d31322d626c61636b)](https://camo.githubusercontent.com/daa7000e27de672defd676d02e29c60e412248aac48d614d1398d8f7764bf49b/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f636f64652532307374796c652d5053522d2d31322d626c61636b)

Unofficial PHP SDK for [Evolution API](https://github.com/EvolutionAPI/evolution-api). Simplify your WhatsApp automations with a robust, object-oriented PHP wrapper.

This SDK provides a fluent and expressive interface to interact with Evolution API v2, supporting multi-instance management, message sending (Text, Media, Templates), group administration, and seamless integrations with AI platforms like OpenAI and Typebot.

🌟 About
-------

[](#-about)

The **Evolution PHP SDK** was built to standardize integrations with Evolution API in PHP projects. It abstracts the complexity of raw HTTP requests, providing a typed, documented, and easy-to-use codebase.

Whether you are building a simple chatbot or a complex multi-tenant automation system, this SDK ensures your code remains clean, maintainable, and scalable.

👨‍💻 Authors
-----------

[](#‍-authors)

Developed with ❤️ by **[Agência Taruga](https://www.agenciataruga.com)** and **Leandro Oliveira Nunes**.

- **Leandro Nunes** - *Lead Developer* - [GitHub](https://github.com/leandronunes07)
- **Agência Taruga** - [Website](https://www.agenciataruga.com)

🚀 Features
----------

[](#-features)

- **Object-Oriented**: Fluid API design (`$client->instances()->create(...)`).
- **Type Safety**: Use of DTOs (Data Transfer Objects) for safer payloads.
- **Full Coverage**: Support for Messages, Groups, Profiles, Chatbots (Typebot, OpenAI, Dify, etc.), and Events.
- **Webhook Handling**: Utility class to parse and process incoming webhook events.
- **Logging**: PSR-3 compatible logging support for debugging requests.
- **Standards**: PSR-12 Compliant code quality.
- **Authentication**: Easy management of Global and Instance API Keys.

📦 Installation
--------------

[](#-installation)

Install via Composer:

```
composer require leandronunes07/evolution-php-sdk
```

⚡ Quick Start
-------------

[](#-quick-start)

```
use LeandroNunes\Evolution\EvolutionClient;
use LeandroNunes\Evolution\Config;
use LeandroNunes\Evolution\DTO\Message\TextMessageDTO;

// 1. Setup Configuration
$config = new Config(
    baseUrl: 'https://api.your-evolution-instance.com',
    globalApiKey: 'YOUR-GLOBAL-API-KEY'
);

// 2. Initialize Client
$client = new EvolutionClient($config);

// 3. Send a Message
$message = new TextMessageDTO(
    number: '5511999999999',
    text: 'Hello from PHP SDK! 🐘'
);

$response = $client->messages()->sendText('instanceName', $message);
print_r($response);
```

📖 Documentation
---------------

[](#-documentation)

- [**Exemplos de Uso (EXAMPLES.md)**](./EXAMPLES.md): Lista completa de exemplos para todos os recursos (Mídia, Grupos, Bots, etc).
- [**Contribuição (CONTRIBUTING.md)**](./CONTRIBUTING.md): Como rodar testes e contribuir.

🛠️ Supported Resources
----------------------

[](#️-supported-resources)

- **Instances**: Create, Connect, Restart, Logout, Delete.
- **Messages**: Text, Media, Audio, Template, Location, Contact.
- **Groups**: Create, Update, Participants, Settings.
- **Integrations**:
    - **Events**: Webhook, RabbitMQ, SQS, Websocket.
    - **Events**: Webhook, RabbitMQ, SQS, Websocket.
    - **Chatbots**: Typebot, OpenAI, Dify, Flowise, N8N, EvolutionBot.
- **Utilities**: Webhook Handler (Parse incoming events).

🧪 Testing
---------

[](#-testing)

```
composer install
./vendor/bin/phpunit
```

📄 License
---------

[](#-license)

MIT License - Copyright (c) 2024 Agência Taruga - Leandro Oliveira Nunes

###  Health Score

36

—

LowBetter than 82% of packages

Maintenance82

Actively maintained with recent releases

Popularity8

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity42

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

Unknown

Total

1

Last Release

91d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/9a80ac093a360730a124dcd1459f25efd37ea6d110ed5d7a99e322c5622e080e?d=identicon)[leandronunes07](/maintainers/leandronunes07)

---

Top Contributors

[![leandronunes07](https://avatars.githubusercontent.com/u/5659627?v=4)](https://github.com/leandronunes07 "leandronunes07 (4 commits)")

---

Tags

phpsdkintegrationwhatsappchatbotevolution-apitypebot

###  Code Quality

TestsPHPUnit

Code StylePHP CS Fixer

### Embed Badge

![Health badge](/badges/leandronunes07-evolution-php-sdk/health.svg)

```
[![Health](https://phpackages.com/badges/leandronunes07-evolution-php-sdk/health.svg)](https://phpackages.com/packages/leandronunes07-evolution-php-sdk)
```

###  Alternatives

[theodo-group/llphant

LLPhant is a library to help you build Generative AI applications.

1.5k311.5k5](/packages/theodo-group-llphant)[mailchimp/transactional

458.9M16](/packages/mailchimp-transactional)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)