Download the PHP package innovation-studios/evolution-api-plugin without Composer
On this page you can find all versions of the php package innovation-studios/evolution-api-plugin. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download innovation-studios/evolution-api-plugin
More information about innovation-studios/evolution-api-plugin
Files in innovation-studios/evolution-api-plugin
Package evolution-api-plugin
Short Description Plugin PHP para integração com a Evolution API - Suporte completo para versões 1.x e 2.x
License MIT
Informations about the package evolution-api-plugin
Evolution API Plugin
Este plugin facilita a integração com a API Evolution, permitindo criar instâncias, enviar mensagens e muito mais.
Instalação
Instale o plugin via Composer:
Configuração
Laravel
Se estiver usando Laravel, publique o arquivo de configuração:
Isso criará o arquivo config/evolution.php, onde você pode configurar a URL e a chave da API.
No arquivo .env, adicione as seguintes variáveis:
Uso Direto (PHP Puro)
Se não estiver usando Laravel, configure a API diretamente ao instanciar a classe:
Métodos Disponíveis
Criar Instância
Enviar Mensagem de Texto
Envia Mensagem de Imagem
Enviar Lista
Listar Instância
Excluir Instância
Exemplos
Laravel
PHP Puro
bash composer require innovation-studios/evolution-api-plugin bash php artisan vendor:publish --tag=config env EVOLUTION_API_URL=https://seu-evolution.example.com EVOLUTION_API_KEY=chave_api_aqui bash curl -X POST "https://seu-evolution.example.com/message/sendText/meuInstance" \ -H "accept: application/json" \ -H "apikey: SUA_API_KEY" \ -H "Content-Type: application/json" \ -d '{"number":"5511999999999","text":"Olá via curl"}'
## Tratamento de erros e troubleshooting
- Erros HTTP: a biblioteca propaga exceções do Guzzle. Trate com try/catch em pontos onde falhas de rede são esperadas.
- Respostas inválidas: verifique `json_decode` retornando `null` — possivelmente a API retornou HTML ou erro.
- Timeouts: use opções do Guzzle se precisar ajustar timeout (p.ex. ao instanciar `Client`).
Dicas rápidas:
- Verifique se `EVOLUTION_API_URL` inclui protocolo (https://) quando necessário.
- Confirme se a `api_key` está correta e possui permissão para os endpoints usados.
- Para desenvolvimento local, exponha a API via ngrok ou ajuste CORS conforme necessário.
## Boas práticas
- Não logue chaves de API em logs públicos.
- Use filas (jobs) para envios em massa.
- Reutilize instâncias do `EvolutionApi` em vez de criar novas por requisição.
## FAQ
Q: A biblioteca suporta webhooks?
A: A biblioteca atual é um cliente HTTP. Para receber webhooks, implemente endpoints no seu servidor e configure a API Evolution conforme documentação do servidor Evolution.
Q: Como enviar mídia via base64?
A: Em `media` envie o conteúdo em base64 se a API Evolution aceitar esse formato (ex.: `data:image/jpeg;base64,...`) ou informe a URL pública.
## Contribuição
Contribuições são bem-vindas. Abra issues ou PRs com testes e descrição clara do problema.
## Licença
MIT — veja o arquivo LICENSE.
---