Versão v1.1.

2
 SUMÁRIO

Entendendo o Conceito da API de Integração ........................................................................... 03

Integrando a API com o Totvs Protheus..................................................................................... 04
Aplicação de fontes.............................................................................................................. 04
Criação de parâmetros ........................................................................................................ 04
Conectando o Protheus à API.............................................................................................. 05
Integrando sua customização à função de mensagens ....................................................... 06
Integrando a API com demais sistemas ..................................................................................... 07
Informações disponibilizadas pela API ................................................................................ 07
Observações gerais ................................................................................................................... 12
Informações do Fabricante ......................................................................................................... 13

Connect Zap - Integração com WhatsApp Página 2

 Entendendo o Conceito da API de Integração

O Connect Zap é uma interface que possibilita que seu sistema envie mensagens, imagens e
documentos para usuários do whatsapp.

Com essa ferramenta, é possível realizar diversas automações no processo de cada empresa como
os exemplos abaixo:

• Envio de boleto bancário para clientes com notificações sobre vencimento.

• Envio de solicitação de aprovação para determinado processo como: Solicitação de
Compras, Pedido de Compras, Cotação, Contratos, etc.
• Envio de Nota Fiscal de Saída para clientes.
• Envio de contra-cheque para funcionários.
• Comunicação do RH com Funcionários.
• Notificações diversas, como saldo em estoque, não conformidades, procedimentos de
segurança, servidor com baixa memória, etc.

Abaixo uma ilustração sobre o que ocorre ao solicitar uma integração.

Connect Zap - Integração com WhatsApp Página 3

 Integrando a API com o Totvs Protheus

Aplicação de Fontes

1) Salve o aquivo Connectzap.zip em algum local do seu computador.

2) Extraia os arquivos para o seu projeto do Protheus.
3) Compile os fontes no ambiente em que desejar.

OBS.: É importante que o repositório não esteja sendo usado.

BAIXE OS FONTES AQUI

Copiando diretorio

Copie o diretorio “qrcode” deste pacote para dentro da pasta "protheus_data”.

Criação de parâmetro

No Protheus, abra o configurador e crie o seguinte parametro:

MV_SESSAO

Tipo: Caracter

Conteúdo: (SEU TOKEN, enviado pelo Fabricante)

Descrição: Código de acesso relacionado ao número do telefone – Connect Zap

Connect Zap - Integração com WhatsApp Página 4

Conectando o Protheus à API

Para enviar mensagens whatsapp através do Connect Zap é necessário antes de tudo, utilizar o painel
de conexão no Protheus para que o usuário conecte o WhatsApp Web de seu aparelho celular
à plataforma do Connect Zap, conforme ilustração da página 03. Outra solução para realizar a leitura
do qrcode é utilizar o portal http://painel.connectzap.com.br.

1. Acesse o programa de conexão do Connect Zap no Protheus.

2. No seu celular, abra o seu aplicativo do WhatsApp e no WhatsApp Web.

3. Posicione a camera do celular direcionado ao QRCODE e aguarde o sistema fazer a

integração e aparecer a logo do WhatsApp.

3. Ao aparecer a logo, o Protheus estará pronto para enviar mensagens WhatsApp.

Connect Zap - Integração com WhatsApp Página 5

Integrando sua customização à função de mensagens

Para realizar o envio de mensagens por WhatsApp, utilize a chamada da função MSGZAP.

MSGZAP

Parametro 1 – Telefone da pessoa que receberá a mensagem com DDI + DDD + Numero

Parametro 2 – Mensagem desejada

Parametro 3 (Não obrigatório) – Caminho do arquivo a ser enviado. (Máx.2Mb)

Connect Zap - Integração com WhatsApp Página 6

 Integrando a API com demais sistemas

Informações disponibilizadas pela API

### Start

Comando que inicia a sessão.

POST ➔

https://api.connectzap.com.br/sistema/Start

Parametro JSON
{

"SessionName": "SEUTOKEN"

### Status

Comando para retorno do status atual.

POST ➔

https://api.connectzap.com.br/sistema/Status

Parametro JSON
{

"SessionName": "SEUTOKEN"

### Close

Comando que fecha a sessão.

POST ➔

https://api.connectzap.com.br/sistema/Close

Parametro JSON
{

"SessionName": "SEUTOKEN"

Connect Zap - Integração com WhatsApp Página 7

### QRCode

Comando usado para leitura do QR-Code.

POST ➔

https://api.connectzap.com.br/sistema/QRCode

Parametro JSON
{

"SessionName": "SEUTOKEN"

### sendText

Comando que efetua envio de menssagens de textos.

POST ➔

https://api.connectzap.com.br/sistema/sendText

Parametro JSON
{

"SessionName": "SEUTOKEN",

"phonefull":"5521999999999",

"msg":"Teste.."

### sendFileBase64

Comando que efetua envio de documento no formato base64.

POST ➔

https://api.connectzap.com.br/sistema/sendFileBase64

Parametro JSON
{

"SessionName": "SEUTOKEN",

"phonefull":"5521999999999",

"base64":”iVBORw0KGgoAAAANSUhEUgAA…….”, //Arquivo transformado em base64

"msg":"Teste.."

}
Connect Zap - Integração com WhatsApp Página 8
### isConnected

Comando usado para retornar se conectado ou não.

POST ➔

https://api.connectzap.com.br/sistema/isConnected

Parametro JSON
{

"SessionName": "SEUTOKEN"

### getWAVersion

Comando usado para retornar a versão do app do whatsapp conectado.

POST ➔ https://api.connectzap.com.br/sistema/getWAVersion

Parametro JSON
{

"SessionName": "SEUTOKEN"

### getHostDevice

Comando usado para retornar dados do dispositivo conectado.

POST ➔ https://api.connectzap.com.br/sistema/getHostDevice

Parametro JSON
{

"SessionName": "SEUTOKEN"

Connect Zap - Integração com WhatsApp Página 9

### getConnectionState

Comando usado para retornar estado atual do dispositivo.

POST ➔

https://api.connectzap.com.br/sistema/getConnectionState

Parametro JSON
{

"SessionName": "SEUTOKEN"

### getBlockList

Comando usado para retornar lista de contatos bloqueados.

POST ➔

https://api.connectzap.com.br/sistema/getBlockList

Parametro JSON
{

"SessionName": "SEUTOKEN"

### getBatteryLevel

Comando usado para retornar nivel da bateria do dispositivo conectado.

POST ➔ https://api.connectzap.com.br/sistema/getBatteryLevel

Parametro JSON
{

"SessionName": "SEUTOKEN"

Connect Zap - Integração com WhatsApp Página 10

### getAllGroups

Comando usado para retornar lista de grupos que participa.

POST ➔

https://api.connectzap.com.br/sistema/getAllGroups

Parametro JSON
{

"SessionName": "SEUTOKEN"

### getAllContacts

Comando usado para retornar lista de contatos listados no app do whatsapp.

POST ➔ https://api.connectzap.com.br/sistema/getAllContacts

Parametro JSON
{

"SessionName": "SEUTOKEN"

### checkNumberStatus

Comando usado para verificar se o numero informado tem whatsapp ativo/valido.

POST ➔ https://api.connectzap.com.br/sistema/checkNumberStatus

Parametro JSON
{

"SessionName": "SEUTOKEN"

Connect Zap - Integração com WhatsApp Página 11

 Observações Gerais

Para a utilização do Connect Zap é necessário que o WhatsApp Web do celular esteja única e
exclusivamente conectado ao Connect Zap.

Caso seja conectado em outra plataforma, será necessário reconectar o celular ao Connect Zap.

É importante que o celular conectado sempre esteja com acesso à internet, seja wifi ou dados.

Connect Zap - Integração com WhatsApp Página 12

 Informações do Fabricante

Connect Zap

www.connectzap.com.br

WhatsApp: (21) 99258-4067

Email: contato@connectzap.com.br

Connect Zap - Integração com WhatsApp Página 13