{"id":35,"date":"2026-11-02T14:36:50","date_gmt":"2026-11-02T14:36:50","guid":{"rendered":"https:\/\/asx.dev.br\/?p=35"},"modified":"2026-11-02T14:58:16","modified_gmt":"2026-11-02T14:58:16","slug":"guia-pratico-de-utilizacao-do-wadll","status":"publish","type":"post","link":"https:\/\/asx.dev.br\/?p=35","title":{"rendered":"Guia pr\u00e1tico de utiliza\u00e7\u00e3o do WaDLL"},"content":{"rendered":"\n

1 Apresenta\u00e7\u00e3o da DLL<\/strong><\/em>

O que \u00e9 a WaDLL?<\/p>\n\n\n\n

A WaDLL<\/strong> \u00e9 uma biblioteca de classes desenvolvida em C# (.NET) que permite que o seu sistema ERP ou aplica\u00e7\u00e3o envie mensagens de WhatsApp (textos, imagens e documentos) de forma simples, automatizada e segura.<\/p>\n\n\n\n

Qual problema ela resolve?<\/h2>\n\n\n\n

Integrar diretamente com o WhatsApp Web ou com a API oficial da Meta exige lidar com protocolos complexos, tokens, configura\u00e7\u00f5es de servidores e filas de mensagens. A WaDLL resolve isso abstraindo toda essa complexidade em apenas um m\u00e9todo de envio<\/strong>. Voc\u00ea passa o n\u00famero e o texto, e a DLL cuida do resto.<\/p>\n\n\n\n

Como funciona a Arquitetura<\/h2>\n\n\n\n

A comunica\u00e7\u00e3o n\u00e3o \u00e9 feita “computador do cliente para o WhatsApp” diretamente. Ela passa por uma infraestrutura segura:<\/p>\n\n\n\n

1. O seu ERP<\/strong> chama um m\u00e9todo da WaDLL (ex: EnviarTextoAsync).<\/p>\n\n\n\n

2. A WaDLL<\/strong> monta uma requisi\u00e7\u00e3o HTTP e envia para um Gateway Central<\/strong> (na VPS da ASX).<\/p>\n\n\n\n

3. O Gateway da ASX<\/strong> valida as credenciais (Token\/API Key) e entrega a mensagem ao destinat\u00e1rio.

Responsabilidades<\/strong>
\u2022 Sua responsabilidade: Desenvolver o c\u00f3digo no ERP que chama a DLL e configurar as credenciais fornecidas.
\u2022 Responsabilidade da DLL: Empacotar os dados, validar se o WhatsApp est\u00e1 online e fazer a ponte de rede de forma segura.
\u2022 Responsab<\/mark>ilidade da Infraestrutura (VPS): Manter a conex\u00e3o com o WhatsApp ativa, gerenciar os limites de envio e garantir a seguran\u00e7a do Gateway.
<\/p>\n\n\n\n

2 Arquivos fornecidos ao cliente<\/strong><\/em><\/p>\n\n\n\n

Ao adquirir a solu\u00e7\u00e3o, o cliente recebe um pacote (um arquivo .zip) contendo:<\/p>\n\n\n\n

Arquivo \/ Pasta<\/strong><\/td>Finalidade<\/strong><\/td><\/tr><\/thead>
bin\/Wa.dll<\/td>O arquivo principal da biblioteca que deve ser referenciado no projeto.<\/td><\/tr>
bin\/asx.dll<\/td>Biblioteca de licenciamento da ASX. Obrigat\u00f3ria.<\/strong><\/td><\/tr>
bin\/wadll.test.exe<\/td>Aplicativo visual de testes para validar a conex\u00e3o antes de programar.<\/td><\/tr>
source-exemplo\/<\/td>C\u00f3digo-fonte do app de testes (exemplo pr\u00e1tico de uso da DLL).<\/td><\/tr>
docs\/<\/td>Documenta\u00e7\u00e3o t\u00e9cnica adicional.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

3 Requisitos para utiliza\u00e7\u00e3o<\/strong><\/em><\/p>\n\n\n\n

Para que a DLL funcione, os seguintes requisitos devem ser atendidos:<\/p>\n\n\n\n

No sistema onde a DLL ser\u00e1 instalada:<\/strong><\/p>\n\n\n\n