README

Introdução

evolution-sdk é uma SDK em PHP para integração com a Evolution API, possibilitando o envio de mensagens, gerenciamento de dispositivos (instâncias) e configuração de webhooks no WhatsApp de forma simples e eficiente.

Requisitos

• PHP >= 8.2
• Composer
• Servidor Evolution API >= v2.0 configurado e acessível

Instalação

composer require luannsr12/apiwpp

Configuração Inicial

use Apiwpp\Config\Api;

Api::setConfigs('SEU_TOKEN_ADMIN', 'URL_DA_SUA_API');
Api::debug(true); // Ativa o modo debug (opcional)

Gerenciamento de Devices (Instâncias)

Criar nova instância

use Apiwpp\Api\Evolution2\Device;

$response = Device::create('TOKEN_DA_INSTANCIA', 'NOME_DA_INSTANCIA');
print_r($response);

Definir instância ativa para envio

Device::setInstance('TOKEN_INSTANCIA', 'NOME_INSTANCIA');

Envio de Mensagens

Mensagem de texto simples

use Apiwpp\Api\Evolution2\Message;

Message::type('text');
Message::phone('551199999999');
Message::text('Olá, esta é uma mensagem de teste.');

if (Message::send()) {
    echo 'Mensagem enviada com sucesso!';
} else {
    echo 'Falha ao enviar mensagem.';
}

Enviar mídia (imagem, áudio, vídeo, documento)

Message::type('image'); // audio, document, video
Message::phone('551199999999');
Message::file('https://link-da-imagem-ou-caminho-local.jpg');
Message::caption('Legenda da imagem'); // opcional

Message::send();

Verificação de Número no WhatsApp

use Apiwpp\Api\Evolution2\Account;

if (Account::checkPhone('551199999999')) {
    echo 'Número existe no WhatsApp.';
} else {
    echo 'Número não encontrado.';
}

Webhooks

Configurar URL para recebimento de mensagens

use Apiwpp\Api\Evolution2\Device;

Device::setWebhook('https://seusite.com.br/webhook');

Tratamento de Erros

use Apiwpp\Error\ExceptionError;

try {
    // Código da SDK
} catch (Exception $e) {
    echo ExceptionError::getMessage();
}

Exemplos

No diretório /examples você encontra scripts prontos para:

• Criar e conectar instância
• Enviar mensagens simples e mídia
• Verificar número WhatsApp
• Configurar webhooks

Contribuições

Bug reports, sugestões e pull requests são bem-vindos!
Por favor, abra issues no GitHub para discussão.

Licença

MIT License © Luan Alves

Contato

Para dúvidas ou suporte: luanalvesnsr@gmail.com