Manual de Operações

ConnectZap

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 4

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 5
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 aparelhocelular
à 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.
  4. Ao aparecer a logo, o Protheus estará pronto para enviar mensagens WhatsApp.

Connect Zap – Integração com WhatsApp Página 6
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 7

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 8

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 9

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 10

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 11

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 12

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.

Veja Também