Download - 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
Connect Zap - Integração com WhatsApp Página 3
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 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
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 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 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.
Connect Zap - Integração com WhatsApp Página 13
Informações do Fabricante
Connect Zap
www.connectzap.com.br
WhatsApp: (21) 99258-4067
Email: [email protected]