GithubHelp home page GithubHelp logo

mwsm's Introduction

MkAuth WhatsApp Send Message [16/07/2024 03:05]

Mikrotik

Mantenha sua aplicação sempre atualizada

Upgrade v1 => v2
ProxMox 
sudo apt-get install build-essential && cd ~ && cd /var/api/Mwsm && pm2 delete all && pm2 kill && npm remove pm2 -g && mkdir -p ~/.pm2/node_modules/ && cd ~ && rm -r /var/api/Mwsm && git clone https://github.com/MKCodec/Mwsm.git /var/api/Mwsm && cd /var/api/Mwsm && npm install --silent && npm i -g pm2 && pm2 update && pm2 flush && pm2 start mwsm.json && pm2 save && pm2 startup && pm2 log 0
MkAuth 
cd ~ && cd /var/api/Mwsm && pm2 kill && pm2 delete all && npm remove pm2 -g || apt-get remove nodejs -y && rm -vrf ~/.pm2/node_modules /var/api/Mwsm && apt-get install -y ca-certificates fonts-liberation libappindicator3-1 libasound2 libatk-bridge2.0-0 libatk1.0-0 libc6 libcairo2 libcups2 libdbus-1-3 libexpat1 libfontconfig1 libgbm1 libgcc1 libglib2.0-0 libgtk-3-0 libnspr4 libnss3 libpango-1.0-0 libpangocairo-1.0-0 libstdc++6 libx11-6 libx11-xcb1 libxcb1 libxcomposite1 libxcursor1 libxdamage1 libxext6 libxfixes3 libxi6 libxrandr2 libxrender1 libxss1 libxtst6 lsb-release wget xdg-utils git curl build-essential && curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash - && apt-get install -y nodejs && cd ~ && mkdir -p /var/api/Mwsm && git clone https://github.com/MKCodec/Mwsm.git /var/api/Mwsm  && cd /var/api/Mwsm && npm i git+https://github.com/MKCodec/WhatsApp-API && npm install github:MKCodec/WhatsApp-API && npm install --silent && npm i -g pm2 && pm2 update && pm2 flush && pm2 start mwsm.json && pm2 save && pm2 startup && pm2 log 0

Update v2 => v2 Beta++

Após rodar o comando reconfigure as opções no menu settings

cd ~ && cd /var/api/Mwsm && pm2 delete all && pm2 kill && git reset --hard HEAD~1 && git pull "https://github.com/MKCodec/Mwsm.git" --rebase --autostash && npm install --silent && npm run start:mwsm

ERROS

Em Caso de Erros Habilite o Debbuger e Siga as Dicas do Guia de Utilização Debugger no Final da Pagina

** Mwsm > Settings > Extras > Debugger

No Caso do Erro Persistir Contate-nos no Forum do mkauth

Novidades V2.0.33++

Release Recurso Update Patch
2.0.33 Alternativa de conexão com API do MkAuth 04/06/2024 12:42 ✅
2.0.33 Correção do Bug Tunel Dev do Mkauth 04/06/2024 17:00 ✅
2.0.33 Correção do sistema de log 06/06/2024 11:45 ✅
2.0.33 Disparos via Mikrotik ( /tool fetch ) 08/06/2024 07:03 ✅
2.0.33 Verificação RegEx no Numero Disparado 11/06/2024 13:29 ✅
2.0.33 Listagem de Usuarios MkAuth 20/06/2024 12:49 ✅
2.0.34 Upgrade da API do WhatsApp 02/07/2024 01:30 ✅
2.0.34 Correção da função Logout 07/07/2024 00:04 ✅
2.0.35 Inclusão de senha + Melhoria do Log 13/07/2024 04:42 ✅
2.0.35 Proteção por token no acesso Mikrotik 16/07/2024 03:05 ✅

OBS: Para Utilizar as Melhorias do Log é Necessario Substituir a API do MkAuth Pela Versão Adaptada Desse Link.

Habilite o Endpoint em Provedor > Controle de Usuarios > API > cliente.api GET

Update : Utilize quando a sua versão instalada for inferior ao do Release [ Requer Reconfiguração ]

Patch : Utilize quando a sua versão instalada for igual ao do Release

Atualização:

Manual 1 - Insira um dos codigos no prompt de comando onde o mwsm esta instalado.

Lembre-se de sempre atualizar o navegador (F5) quando realizar uma atualização Manual.

Update

cd ~ && cd /var/api/Mwsm && pm2 delete all && pm2 kill && git reset --hard HEAD~1 && git pull "https://github.com/MKCodec/Mwsm.git" --rebase --autostash && npm install --silent && npm run start:mwsm

Patch

wget https://raw.githubusercontent.com/MKCodec/Mwsm/main/mwsm.js -O /var/api/Mwsm/mwsm.js
wget https://raw.githubusercontent.com/MKCodec/Mwsm/main/script.js -O /var/api/Mwsm/script.js
wget https://raw.githubusercontent.com/MKCodec/Mwsm/main/style.css -O /var/api/Mwsm/style.css
wget https://raw.githubusercontent.com/MKCodec/Mwsm/main/index.html -O /var/api/Mwsm/index.html
cd ~ && cd /var/api/Mwsm && pm2 log 0
Automática

1 - Habilite a função no webadmin do mwsm.

as atualizações serão instaladas entre 00:00 e 05:00 am e conterão somente correções de bugs que não interferem no funcionamento da API, atualizações criticas que requerem reconfiguração serão feitas somente de forma manual

** Extras > Update

Compatibilidade [ MkAuth API ]

BAR PIX QR QRL PDF
Gerencianet ✅ ✅ ✅ ✅ ✅
Iugu ✅ ✅ ✅ ✅ ✅
Galaxpay ✅ ✅ ✅ ✅ ✅
Santander ✅ ❌ ❌ ❌ ✅

OBS: Compatibilidade Relatada por Usuarios Podendo Funcionar em Bancos/Gateways Ausentes Dessa Lista

Funcionalidade:

  • Enviar mensagens de texto e/ou anexos via whatsapp para clientes cadastrados no mkauth

Requisitos :

  • Servidor Linux ( Container ubuntu ) Proxmox ou Mkauth

Instalação :

Proxmox OBS: é necessario instalar uma distribuição linux no proxmox antes de inserir os codigos abaixo

1 - Atualize seu sistema

apt update
apt upgrade -y

2 - Instale as dependencias necessarias

apt-get install git curl libnss3-dev libgdk-pixbuf2.0-dev libgtk-3-dev libxss-dev libasound2 build-essential -y

3 - Instale o node

curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash - && apt-get install -y nodejs

4 - Instale o Mwsm

git clone https://github.com/MKCodec/Mwsm.git /var/api/Mwsm && cd /var/api/Mwsm

5 - Instale as dependencias do Mwsn

npm install --silent && npm run start:mwsm
Mkauth

1 - Atualize seu sistema

sudo apt update

2 - Instale as dependencias necessarias

sudo apt install git curl build-essential
sudo apt-get install ca-certificates fonts-liberation libappindicator3-1 libasound2 libatk-bridge2.0-0 libatk1.0-0 libc6 libcairo2 libcups2 libdbus-1-3 libexpat1 libfontconfig1 libgbm1 libgcc1 libglib2.0-0 libgtk-3-0 libnspr4 libnss3 libpango-1.0-0 libpangocairo-1.0-0 libstdc++6 libx11-6 libx11-xcb1 libxcb1 libxcomposite1 libxcursor1 libxdamage1 libxext6 libxfixes3 libxi6 libxrandr2 libxrender1 libxss1 libxtst6 lsb-release wget xdg-utils

3 - Instale o node

sudo curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash - && apt-get install -y nodejs

4 - Crie o diretório de instalação do Mwsm

sudo mkdir -p /var/api/Mwsm

5 - Instale o Mwsm

sudo git clone https://github.com/MKCodec/Mwsm.git /var/api/Mwsm && cd /var/api/Mwsm

6 - Instale as dependencias do Mwsn

sudo npm install --silent

7 - Inicialize o Mwsn

sudo npm run start:mwsm

Configuração :

Tutorial
1 - Habilite o Tunel Dev API do MKauth

** Opções > Rede do Servidor > MkTunel > ( Ativar e Gravar )

MkAuth

2 - Habilite o EndPoint (Titulos GET) e (Cliente GET) do MkAuth

** Provedor > Controle de Usuarios > API > ( Habilitar Endpoints titulo.api GET, cliente.api GET e Gravar )

MkAuth

3 - Acesse seu servidor web através do IP:PORTA em uma nova aba do novegador

Node

4 - Aguarde a geração do QRCode

5 - Faça a leitura do QRCode com o WhatsApp

** Whatsapp > Menu > Aparelhos Conectados > Conectar um Aparelho

6 - Entre no whatsapp que acabou de conectar e pegue o token temporario para acessar as configurações

OBS: para criar um token fixo envie o comando como mensagem de outro celular para o numero conectado a API

Token:SENHA

TOKEN = Comando | : = Divisor | SENHA { altere para sua senha de 7 digitos }

7- Altere o valor conforme suas necessidades.

Node

Nome Default Função
Break 1 segundo Tempo de disparo entre mensagens condicionadas com a TAG ##.
Sleep 30 segundos Tempo de disparo entre mensagens com numeros diferentes.
Access 8000 Porta de acesso do sistema/interface.
Call Resposta após Receber uma Chamada.
Wait 1 segundo Tempo para Rejeitar uma Chamada.
Message Resposta após Receber uma Mensagem.
Auto-Response on Habilitar Resposta Automatica.
Replies on Marcar conversas em resposta automaticas.
Auto-Reject on Habilitar Rejeição de Chamadas Automatica.
Alert on Habilitar Mensagem de Resposta ao Rejeitar Chamadas.
Counter 1 Quantidade de Auto-Respostas por usuario (renovado todo dia)

8 - Configure a API do MkAuth no Mwsm. ** Mwsm > Settings > API

Campo Dado
TUNEL Insira o URL encontrada em Tunel no passo 2 desse tutorial
CLIENT Insira o Codigo encontrado em Client no passo 2 desse tutorial
SECRET Insira o Codigo encontrado em Secret no passo 2 desse tutorial
DOMAIN Insira o Dominio ou IP do seu mkauth

MkAuth

Nome Função
Delay Tempo de espera para disparo de mensagens ordenadas.
MkAuth Link Habilita a sincronia com a API do MkAuth.
BAR Envia codigo de barras.
PIX Envia codigo pix copia e cola
QR Envia imagem do Qrcode pix.
QRL Envia link pix Para acessar QRCode e Copia e cola.
PDF Envia Boleto em PDF

OBS: Por padrão o delay ideal é 2s porem se sua API disparar de forma desordenada considere elevar esse valor.

9 - Configure seu servidor no MKAuth seguindo as instruções do servidor Web

Senha : Insira o Token Fixo de Acesso ao Aplicativo no Campo Senha no MkAuth

MkAuth até Versão 24.02 ** `Opções > Servidor de SMS > Servidor`

MkAuth

MkAuth Versão 24.03 ou Superior ** `Opções > Servidor de WhatsApp > Servidor`

MkAuth

Utilização :

Tutorial

Utilize o simulador do mkauth antes de colocar em produção : settings > Options > Run.

Node

Exemplo para teste no webadmin ( mkauth simulator )

{"uid":"E5:BE:ED:DE:2E:EF","find":"415"}

Exemplo de utilização no mkauth ( Insira exatamente assim, não edite )

{"uid":"%logincliente%","find":"%numerotitulo%"}

É possivel combinar a Utilização com a tag ## seguindo o exemplo abaixo:

Mensagem1##https://via.placeholder.com/350x150.png##Mensagem3##{"uid":"%logincliente%","find":"%numerotitulo%"}##Mensagem5

Exemplo De Mensagem Para Utilização no MkAuth

** Opções > Servidor de SMS > Mensagens

Olá %nomeresumido%, sua fatura %numerotitulo% vence no dia %vencimento%, para sua comodidade estamos enviado os dados para pagamento: ##{"uid":"%logincliente%","find":"%numerotitulo%"}##desconsidere esse aviso caso tenha feito o pagamento.

Como Enviar Mensagens Via Mikrotik

As mensagens via Mikrotik podem ser enviadas via Script com o comando Abaixo:

/tool fetch "http://IP-API/mikrotik/TOKEN/DDI+DDD+NUMERO/MENSAGEM"

OBS: Subistitua os Espaços por %20 ao Inserir uma Mensage no Toll Fetch

Ex: Para /tool fetch "http://192.168.3.250:8000/mikrotik/1234567/5511988888888/Mensagem de Teste" :

/tool fetch "http://192.168.3.250:8000/mikrotik/1234567/5511988888888/Mensagem%20de%20Teste"

Testando

1 - Envie uma mensagem pelo Sumulador settings > Options > Run ou MkAuth Opções > Servidor de SMS > Mensagens

2 - Verifique o Status do envio no Log Mwsm > Log.

Node

Opção Função
ID Idenificador de Registro
TITLE Balão Flutuante com numero do titulo (Boleto) ao selecionar um Registro
START Inicio do Processamento
FINISH Conclusão do Processamento
TARGET Whatsapp Alvo do Disparo
STATUS Status do Envio
Debugger

Para um melhor entendimento utilize esse guia como base na solução de possiveis erros.

** Settings > Extras > Debug ON

Todos os Resultados tem somente 2 retornos possiveis:
True = Positivo
False = Negativo

1 - Teste a Conexão com API MkAuth

** Settings > API > MkAuth Link ( Desabilite e Habilite )

Node

Opção Retorno
Authentication Autenticação com API do MkAuth via Token JWT
Communication Comunicação Entre APP e API do MkAuth

2 - Teste a Comunicação da API MkAuth

Utilize o Simulador MkAuth para analisar esses dados

** Settings > Run > MkAuth Simulator ON

Em um cenario em que a comunicação foi feita de forma correta receberemos o seguinte resultado

Node

Na Primeira linha temos o comando de entrada de acesso a API do MkAuth.

Nas Demais Linhas Temos o Retorno Da API e por Fim o Resultado da Requisição.

Opção Retorno
Payment Status do Pagamento da Mensalidade Pesquisada
MkAuth Modulos Disponiveis no Aplicativo
Module Função Integrada pela API
Available Disponibilidade pelo Gateway de Pagamento
Allowed Permissão de Utilização Configurada em Settings > API

Em um Cenario em que Ocorreu uma Falha na Requisição, o Debug ira Apontar a Falha e Onde Ocorreu

O Dado inserido no campo uid esta incorreto ( não existe no MkAUth )

Node

O Dado inserido no campo find esta incorreto ( não faz parte do uid inserido )

Node

É importante Levar em Consideração que os Dados Enviados Pelo MkAuth utilizando suas variaveis são enviados ao Aplicativo Seguindo o Mesmo Caminho que o MkAUth Simulator, se o Comando {"uid":"%logincliente%","find":"%numerotitulo%"} vindo do MkAuth Funcionar más o {"uid":"Paulo.Santos","find":"144"} inserido no Simulador não Funcionar é Possivel que vc Esteja Inserindo de Forma Errada, desse modo sugerimos que Dispare uma Mensagem via MkAuth e Copie a Primeira Linha do Debug para Disparar via Simulador.

OBS: %numerotitulo% é uma variavel exclusiva de SMS Opções > Servidor de SMS > Mensagens e não é possivel incluir como mensagem ( cartinha na lista de clientes ).

Extras :

Tags
Tag Efeito Exemplo
## quebra balão Mensagem1##Mensagem2##Mensagem3
\n quebra linha Linha1\nLinha2\nLinha3
* negrito *Mensagem*

DOAÇÕES PIX :

Contribua com a sobrevivência desse projeto estimulando melhorias e atualizações.

Pix

e9b9d669-4412-4dec-994c-310005904088
00020126580014BR.GOV.BCB.PIX0136e9b9d669-4412-4dec-994c-3100059040885204000053039865802BR5924CLEBER FERREIRA DE SOUZA6007CARUARU62070503***63045854

mwsm's People

Contributors

mkcodec avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.