PHPackages                             kalezao/laravel-evolutionapi - 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. kalezao/laravel-evolutionapi

ActiveLibrary

kalezao/laravel-evolutionapi
============================

Laravel package for Evolution API integration with WhatsApp messaging

v0.0.2(6mo ago)04MITPHPPHP ^8.1

Since Nov 18Pushed 6mo ago1 watchersCompare

[ Source](https://github.com/kalezao/laravel-evolutionapi)[ Packagist](https://packagist.org/packages/kalezao/laravel-evolutionapi)[ RSS](/packages/kalezao-laravel-evolutionapi/feed)WikiDiscussions main Synced 1mo ago

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

Evolution API Laravel Package
=============================

[](#evolution-api-laravel-package)

Pacote Laravel para integração com Evolution API - WhatsApp Business API.

Instalação
----------

[](#instalação)

1. O pacote já está configurado no projeto
2. Publique o arquivo de configuração:

```
php artisan vendor:publish --provider="Kalezao\EvolutionApi\EvolutionApiServiceProvider"
```

3. Configure as variáveis de ambiente no `.env`:

```
EVOLUTION_API_BASE_URL=https://sua-evolution-api.com
EVOLUTION_API_KEY=sua-api-key-aqui
EVOLUTION_API_TIMEOUT=30
EVOLUTION_API_DEFAULT_INSTANCE=instancia-padrao
```

Uso
---

[](#uso)

### Usando a Facade

[](#usando-a-facade)

```
use Kalezao\EvolutionApi\Facades\EvolutionAPI;

// Enviar mensagem de texto
$response = EvolutionAPI::sendText('minha-instancia', '5511999999999', 'Olá! Esta é uma mensagem de teste.');

// Enviar mídia
$response = EvolutionAPI::sendMedia(
    'minha-instancia',
    '5511999999999',
    'image',
    'https://exemplo.com/imagem.jpg',
    ['caption' => 'Legenda da imagem']
);

// Enviar status
$response = EvolutionAPI::sendStatus('minha-instancia', [
    'type' => 'text',
    'content' => 'Meu status de teste',
    'allContacts' => true
]);

// Criar instância
$response = EvolutionAPI::createInstance([
    'instanceName' => 'nova-instancia',
    'token' => 'token-da-instancia',
    'qrcode' => true,
    'integration' => 'WHATSAPP-BAILEYS'
]);

// Listar instâncias
$instances = EvolutionAPI::getInstances();

// Listar grupos da instância
$groups = EvolutionAPI::getGroups('minha-instancia', true);
```

### Usando o Service Container

[](#usando-o-service-container)

```
use Kalezao\EvolutionApi\Services\EvolutionApiService;

class MeuController extends Controller
{
    public function __construct(
        private EvolutionApiService $evolutionApi
    ) {}

    public function enviarMensagem()
    {
        $response = $this->evolutionApi->sendText(
            'minha-instancia',
            '5511999999999',
            'Mensagem enviada via service!'
        );

        return response()->json($response);
    }
}
```

Métodos Disponíveis
-------------------

[](#métodos-disponíveis)

- `sendText($instance, $number, $text, $options = [])` - Enviar mensagem de texto
- `sendMedia($instance, $number, $mediaType, $media, $options = [])` - Enviar mídia
- `sendStatus($instance, $statusData)` - Enviar status
- `createInstance($instanceData)` - Criar nova instância
- `getInstance($instance)` - Obter informações da instância
- `getQrCode($instance)` - Obter QR code da instância
- `disconnectInstance($instance)` - Desconectar instância
- `deleteInstance($instance)` - Deletar instância
- `getInstances()` - Listar todas as instâncias
- `getGroups($instance, $withParticipants = false)` - Listar grupos da instância (opcionalmente com participantes)

Tratamento de Erros
-------------------

[](#tratamento-de-erros)

O pacote lança `EvolutionApiException` em caso de erro:

```
use Kalezao\EvolutionApi\Exceptions\EvolutionApiException;

try {
    $response = EvolutionAPI::sendText('instancia', 'numero', 'texto');
} catch (EvolutionApiException $e) {
    // Tratar erro
    Log::error('Erro ao enviar mensagem: ' . $e->getMessage());
}
```

Configuração
------------

[](#configuração)

O arquivo de configuração `config/evolution-api.php` contém:

```
return [
    'base_url' => env('EVOLUTION_API_BASE_URL', 'https://api.evolution.com'),
    'api_key' => env('EVOLUTION_API_KEY'),
    'timeout' => env('EVOLUTION_API_TIMEOUT', 30),
    'default_instance' => env('EVOLUTION_API_DEFAULT_INSTANCE'),
];
```

###  Health Score

30

—

LowBetter than 64% of packages

Maintenance69

Regular maintenance activity

Popularity3

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity35

Early-stage or recently created project

 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

181d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/35b18aeb991c8ae4209e70b633321120bbceb70765b071e57006b2b7c69552ef?d=identicon)[kalezao](/maintainers/kalezao)

---

Top Contributors

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

### Embed Badge

![Health badge](/badges/kalezao-laravel-evolutionapi/health.svg)

```
[![Health](https://phpackages.com/badges/kalezao-laravel-evolutionapi/health.svg)](https://phpackages.com/packages/kalezao-laravel-evolutionapi)
```

###  Alternatives

[s-ichikawa/laravel-sendgrid-driver

This library adds a 'sendgrid' mail driver to Laravel.

4139.3M1](/packages/s-ichikawa-laravel-sendgrid-driver)[stechstudio/laravel-zipstream

A fast and simple streaming zip file downloader for Laravel.

4633.7M3](/packages/stechstudio-laravel-zipstream)[laravel-notification-channels/microsoft-teams

A Laravel Notification Channel for Microsoft Teams

1603.0M7](/packages/laravel-notification-channels-microsoft-teams)[spatie/laravel-export

Create a static site bundle from a Laravel app

646127.9k5](/packages/spatie-laravel-export)[erag/laravel-disposable-email

A Laravel package to detect and block disposable email addresses.

226102.4k](/packages/erag-laravel-disposable-email)[aedart/athenaeum

Athenaeum is a mono repository; a collection of various PHP packages

245.2k](/packages/aedart-athenaeum)

PHPackages © 2026

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