Skip to content
Júlio Wittwer edited this page Feb 1, 2020 · 4 revisions

Bem-vindo a documentação da API NETIZAP AdvPL

Introdução

O envio de mensagens para telefones celulares através do aplicativo WhatsApp(r) pode ser feito pelo próprio aplicativo ou pela interface WEB ( https://web.whatsapp.com/ ). Para uso de qualquer uma destas alternativas, você tem que ter o App do WhatsAPP instalado no seu SmartPhone.

A WhatsApp oferece uma forma de integração de aplicações externas, para ter acesso aos serviços de envio e recebimento de mensagens através de parcerias com empresas, que oferecem como serviço uma plataforma de integração com o WhatsApp. Dessa forma, você pode contratar uma empresa provedora deste serviço, e consumir os serviços de envio e recebimento de mensagens, entre outros que podem ser oferecidos.

NETIZAP

O provedor de serviços de mensagem NETIZAP oferece este serviço, acessado através de uma API WEB / HTTP. A utilização comercial da API requer a contratação do serviço, para você obter uma chave de autenticação para uso do serviço, e inclusive obter uma chave de autenticação personalizada para testes. Para tal, entre em contato com o Thiago, desenvolvedor/provedor dessa API, no telefone/WhatsApp +55(27)99802-2075, ou pelo e-mail thiagopedro.br@gmail.com

Integração com a NETIZAP em AdvPL

Como o provedor de serviços disponibiliza uma URL para acesso via requisições HTTP GET/POST, para envio de mensagens e uso do serviço, as chamadas e tratamentos de retorno podem ser escritos diretamente em qualquer linguagem que permita abrir uma conexão TCP com um servidor na Internet. O objetivo da classe NETIZAP é justamente encapsular as funcionalidades básicas do serviço e a montagem dos parâmetros de cada tipo de requisição em uma Classe escrita em AdvPL -- linguagem usada no ERP Microsiga/Protheus, com o objetivo de facilitar o uso/consumo desse serviço.

Fonte NETiZAP.prw

A utilização da classe AdvPL NETIZAP requer apenas a compilação do fonte NETiZAP.prw no repositório de objetos (RPO) do ambiente Microsiga/Protheus em questão. Não há nenhuma dependência de LIB / FRAMEWORK AdvPL / plataforma. O fonte é compatível com o TOTVS Application Server com build igual ou superior a 7.00.131227, independentemente da plataforma em uso (Windows ou Linux, 32 ou 64 bits).

Fonte IzapClient.prw

O fonte acima possui uma implementação em AdvPL de um programa de exemplo com interface gráfica em AdvPL -- para ser executado a partir do TOTVS SmartClient -- que monta uma interface de demonstração e teste de uso da classe NETIZAP. Dentro do fonte, é disponibilizada uma chave de autenticação para demonstração do uso do serviço, onde não é possível alterar o numero de telefone de origem. Ela serve para você, por exemplo, enviar uma mensagem para o seu WhatsApp e ver a "mágica" acontecendo :D

Outras referências técnicas

A documentação do mecanismo de mensagens da API NETIZAP está disponível no link POSTMAN - Doc API - NETiZap

No Blog do DBA Dirceu Resende, existe um outro exemplo de consumo da API NETIZAP, com exemplos de uso e montagem de requisições para o Banco de Dados MSSQL Server -- vide link SQL Server – Como enviar mensagens para contatos, grupos e listas de transmissão do Whatsapp via API

Protheus, TOTVS e Microsiga são marcas registradas pertencentes a TOTVS S/A. As opiniões expressas no blog pelo autor não representam as opiniões da TOTVS, de suas afiliadas ou de qualquer outra entidade.