luannsr12/apiwpp

SDK PHP Evolution Api Whatsapp

2.0.8 2025-05-17 14:36 UTC

Requires

• php: >=8.2

MIT

• Luan Alves

README

Introdução

apiwpp é 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 ou superior
• Composer
• Servidor Evolution API 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');
Message::phone('551199999999');
Message::file('https://link-da-imagem-ou-caminho-local.jpg');
Message::caption('Legenda da imagem');

Message::send();

Verificação de Número no WhatsApp

use Apiwpp\Api\Evolution2\Number;

Number::phone('551199999999');

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

Webhooks

Configurar URL para recebimento de mensagens

use Apiwpp\Api\Evolution2\Webhook;

Webhook::setUrl('https://seusite.com.br/webhook');
Webhook::enable(true);

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: [e-mail]