Versão v1.1

Versão v1.1.2

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

SUMÁRIO

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

Integrando a API com o Totvs Protheus ..................................................................................... 04

Aplicação de patch ............................................................................................................... 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


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.


Integrando a API com o Totvs Protheus

Aplicação de patch

Salve o arquivo patch, Connect Zap.ptm em algum local do seu computador e utilizando a

ferramenta de aplicação de patchs do Protheus, VSCODE, abra este arquivo para que o programa

seja incluído no repositório do Protheus.

OBS.: É importante que o repositório não esteja sendo usado. BAIXE O PATCH 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

arquivos.connectzap.com.br/connectzap.zip


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.


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)


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

{


}

### Close

Comando que fecha a sessão.

POST ➔

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

Parametro JSON

{


}


### QRCode

Comando usado para leitura do QR-Code.

POST ➔

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

Parametro JSON

{


}

### 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.."

}


### isConnected

Comando usado para retornar se conectado ou não.

POST ➔

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

Parametro JSON

{


}

### getWAVersion

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

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

Parametro JSON

{


}

### getHostDevice

Comando usado para retornar dados do dispositivo conectado.

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

Parametro JSON

{


}


### getConnectionState

Comando usado para retornar estado atual do dispositivo.

POST ➔

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

Parametro JSON

{


}

### getBlockList

Comando usado para retornar lista de contatos bloqueados.

POST ➔

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

Parametro JSON

{


}

### getBatteryLevel

Comando usado para retornar nivel da bateria do dispositivo conectado.

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

Parametro JSON

{


}


### getAllGroups

Comando usado para retornar lista de grupos que participa.

POST ➔

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

Parametro JSON

{


}

### getAllContacts

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

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

Parametro JSON

{


}

### checkNumberStatus

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

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

Parametro JSON

{


}


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.


Informações do Fabricante

Connect Zap

www.connectzap.com.br

WhatsApp: (21) 99258-4067

Email: [email protected]

mailto:[email protected]

Versão v1.1

Documents

Transcript of Versão v1.1