PHPackages                             marksamp/evolution-api - 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. marksamp/evolution-api

ActiveLibrary[API Development](/categories/api)

marksamp/evolution-api
======================

Cliente PHP para EvolutionAPI - WhatsApp Business API

1.1.1(6mo ago)015MITPHPPHP >=7.4

Since Aug 18Pushed 3mo agoCompare

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

READMEChangelog (2)Dependencies (2)Versions (3)Used By (0)

🚀 EvolutionAPI PHP Client
=========================

[](#-evolutionapi-php-client)

Uma biblioteca PHP completa e profissional para integração com a **EvolutionAPI**, permitindo o controle total de instâncias do WhatsApp Business através de uma API REST, com **proteção anti-bloqueio integrada**.

[![PHP Version](https://camo.githubusercontent.com/e930363e941f9822f19ceb5b72b94c338949a3d2133fb06aed143e816891eed8/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048502d253345253344253230372e342d626c75652e737667)](https://php.net)[![License](https://camo.githubusercontent.com/8bb50fd2278f18fc326bf71f6e88ca8f884f72f179d3e555e20ed30157190d0d/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d677265656e2e737667)](LICENSE)[![Evolution API](https://camo.githubusercontent.com/56b7a5bbcf7483724b35162022c88ebc9807da2790726b45db0a183ba25a1c96/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f45766f6c7574696f6e2532304150492d436f6d70617469626c652d737563636573732e737667)](https://evolution-api.com)

---

📋 Índice
--------

[](#-índice)

- [Características](#-caracter%C3%ADsticas)
- [Requisitos](#-requisitos)
- [Instalação](#-instala%C3%A7%C3%A3o)
- [Guia Rápido](#-guia-r%C3%A1pido)
- [Funcionalidades](#-funcionalidades)
- [SafeSender - Proteção Anti-Bloqueio](#%EF%B8%8F-safesender---prote%C3%A7%C3%A3o-anti-bloqueio)
- [Melhores Práticas](#-melhores-pr%C3%A1ticas)
- [Exemplos](#-exemplos)
- [FAQ](#-faq)
- [Tratamento de Exceções](#-tratamento-de-exce%C3%A7%C3%B5es)
- [Contribuindo](#-contribuindo)
- [Licença](#-licen%C3%A7a)

---

✨ Características
-----------------

[](#-características)

### Core Features

[](#core-features)

- ✅ **PHP 7.4+** compatível
- ✅ **PSR-4** autoloading via Composer
- ✅ **Guzzle HTTP** para requisições robustas
- ✅ **Arquitetura modular** com separação de responsabilidades
- ✅ **Tratamento completo** de exceções personalizadas
- ✅ **Documentação** completa e exemplos práticos

### Funcionalidades Principais

[](#funcionalidades-principais)

- 📱 Gerenciamento de instâncias (criar, conectar, status)
- 💬 Envio de mensagens (texto, mídia, áudio, localização, contatos)
- 🎯 Mensagens interativas (botões, listas)
- 👥 Gestão de contatos e grupos
- 🔔 Webhooks configuráveis
- ⚡ Presença ("digitando...", "gravando áudio...")
- 📊 QR Code automático para conexão

### 🛡️ Proteção Anti-Bloqueio (SafeSender)

[](#️-proteção-anti-bloqueio-safesender)

- 🚦 Rate limiting automático inteligente
- 🤖 Humanização de comportamento
- ⏱️ Delays aleatórios entre mensagens
- ✍️ Simulação de presença ("digitando...")
- 📝 Variação de mensagens automática
- 🎨 **TextHumanizer** - Humanização avançada de textos (NOVO!)
- 📈 Estatísticas e monitoramento em tempo real
- 🔍 Detecção de bloqueios e pausas automáticas
- 📊 Histórico de envios (24h)
- 💾 Exportação de relatórios CSV

---

📋 Requisitos
------------

[](#-requisitos)

- PHP 7.4 ou superior
- Composer
- ext-json
- guzzlehttp/guzzle ^7.0

---

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

[](#-instalação)

```
composer require evolution-api/php-client
```

Ou clone o repositório:

```
git clone https://github.com/seu-usuario/evolution-api-php.git
cd evolution-api-php
composer install
```

Configure o ambiente:

```
cp .env.example .env
nano .env
```

---

⚡ Guia Rápido
-------------

[](#-guia-rápido)

### Configuração Básica

[](#configuração-básica)

```