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.
- Acesse o programa de conexão do Connect Zap no Protheus.
- No seu celular, abra o seu aplicativo do WhatsApp e no WhatsApp Web.
- Posicione a camera do celular direcionado ao QRCODE e aguarde o sistema fazer a
integração e aparecer a logo do WhatsApp. - 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.
