Download the PHP package marksamp/evolution-api without Composer

🚀 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.

📋 Índice

• Características
• Requisitos
• Instalação
• Guia Rápido
• Funcionalidades
• SafeSender - Proteção Anti-Bloqueio
• Melhores Práticas
• Exemplos
• FAQ
• Tratamento de Exceções
• Contribuindo
• Licença

✨ Características

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

• 📱 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)

• 🚦 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

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

📦 Instalação

Ou clone o repositório:

Configure o ambiente:

⚡ Guia Rápido

Configuração Básica

Envio Seguro (Recomendado)

📚 Veja o QUICKSTART.md para começar em 5 minutos!

🎯 Funcionalidades

1. Gerenciamento de Instâncias

2. Envio de Mensagens

Texto

Mídia

Áudio

Localização

Contato

Botões Interativos

Lista Interativa

3. Presença ("digitando...")

4. Gerenciamento de Contatos

5. Gerenciamento de Grupos

6. Webhooks

🎨 TextHumanizer - Humanização Avançada de Textos

O TextHumanizer é um utilitário único que humaniza textos para evitar detecção de spam pela Meta, sem usar IA.

Por que usar?

• ✅ Evita padrões detectáveis de mensagens em massa
• ✅ Textos únicos para cada envio
• ✅ Erros naturais de digitação
• ✅ Variação orgânica de saudações e pontuação
• ✅ Emojis contextuais
• ✅ Quebras de linha inteligentes
• ✅ Tempo de digitação realista

Uso Básico

Gerar Variações

Integração com SafeSender

Configurações Personalizadas

Recursos do TextHumanizer

Exemplo Antes/Depois

Digitação Progressiva (Textos Longos) ⭐ NOVO!

Envio Progressivo Automático (SafeSender) ⭐ NOVO!

Como funciona:

1. Texto é dividido em frases naturais
2. Cada frase simula "digitando..." com tempo realista
3. Pausas naturais entre envios (como humano pensando)
4. Resultado: 100% indistinguível de humano real

📚 Veja example/envio_progressivo_examples.php para mais exemplos!

📚 Veja example/text_humanizer_examples.php para mais exemplos!

🛡️ SafeSender - Proteção Anti-Bloqueio

O SafeSender é um sistema completo de proteção contra bloqueios do WhatsApp.

Por que usar?

• ✅ Evita bloqueios automáticos do WhatsApp
• ✅ Rate limiting inteligente
• ✅ Comportamento humanizado
• ✅ Estatísticas em tempo real
• ✅ Detecção de problemas
• ✅ Pausas automáticas

Configurações Pré-Definidas

Uso Básico

Mensagens Variadas (Anti-Spam)

Estatísticas e Monitoramento

Configuração Personalizada

📊 Melhores Práticas

Limites Seguros

✅ SEMPRE FAÇA

• ✅ Use SafeSender para envios em massa
• ✅ Simule presença ("digitando...")
• ✅ Varie mensagens (templates)
• ✅ Valide números antes
• ✅ Respeite horários (9h-22h)
• ✅ Obtenha consentimento (opt-in)
• ✅ Monitore estatísticas
• ✅ Adicione opção de cancelamento

❌ NUNCA FAÇA

• ❌ Enviar para números aleatórios
• ❌ Usar mensagens idênticas
• ❌ Responder instantaneamente sempre
• ❌ Enviar à noite/madrugada
• ❌ Ignorar denúncias/bloqueios
• ❌ Usar links encurtadores suspeitos
• ❌ Exceder limites recomendados

Exemplo de Uso Seguro

💡 Exemplos

Bot de Atendimento

Campanha em Lote

Sistema de Retry

❓ FAQ

Como evitar bloqueios?

Use o SafeSender com configurações apropriadas. Para número novo: SafeSender::configNumeroNovo(). Para estabelecido: SafeSender::configNumeroEstabelecido().

Qual o limite seguro?

Depende: Novo (20-50/dia), Estabelecido (100-300/dia), Business (500+/dia).

Como processar webhooks?

Como salvar QR Code?

Posso usar múltiplas instâncias?

Sim! Crie um cliente para cada:

🚨 Tratamento de Exceções

📁 Estrutura do Projeto

🤝 Contribuindo

Contribuições são bem-vindas! Veja CONTRIBUTING.md.

1. Fork o projeto
2. Crie uma branch (git checkout -b feature/NovaFuncionalidade)
3. Commit (git commit -am 'Adiciona nova funcionalidade')
4. Push (git push origin feature/NovaFuncionalidade)
5. Abra um Pull Request

📄 Licença

Este projeto está licenciado sob a Licença MIT. Veja LICENSE.

⚠️ Aviso Legal

Esta biblioteca é um cliente não oficial para a EvolutionAPI. Use por sua própria conta e risco.

• ⚠️ Respeite os Termos de Serviço do WhatsApp
• ⚠️ Obtenha consentimento dos usuários
• ⚠️ Use a API oficial do WhatsApp Business para uso comercial em larga escala
• ⚠️ Esta biblioteca é para fins educacionais e de desenvolvimento

O uso inadequado pode resultar em bloqueio permanente da sua conta WhatsApp.

📚 Recursos

• 📖 Documentação Completa
• ⚡ Guia Rápido
• 🤝 Contribuindo
• 📋 Changelog
• 🐛 Issues
• 💬 Discussions

🙏 Agradecimentos

• EvolutionAPI
• Guzzle
• Comunidade PHP

📞 Suporte

• 📧 Email: [email protected]
• 💬 Telegram: @seu_canal
• 🐛 Issues: GitHub