Skip to content

Suporte e Integração

Jump to bottom
ArsNova edited this page Oct 16, 2025 · 3 revisions

🧩 Suporte e Integração

O Mwsm foi projetado para oferecer flexibilidade total de integração com outros sistemas, permitindo disparos de mensagens via PHP, Mikrotik, ou diretamente pelo MkAuth Simulator.
Nesta seção, você aprenderá como utilizar cada método, testar suas integrações e diagnosticar erros.

🔹 Integração com PHP

Desenvolvedores podem enviar mensagens diretamente para o Mwsm via requisições HTTP.

<?php
$Whatsapp = "819xxxxxxxx"; // Telefone com DDD
$Mensagem = "Mensagem de Teste";
$Token = "xxxxxxx"; // Token Mwsm de 7 dígitos
$IP = "192.168.3.250:8000"; // IP e Porta do Mwsm

$Data = http_build_query([
    'to' => '55'.$Whatsapp,
    'msg' => $Mensagem,
    'pass' => $Token,
    'auth' => 'true'
]);

$CURL = curl_init();
curl_setopt($CURL, CURLOPT_URL, "http://".$IP."/send-message");
curl_setopt($CURL, CURLOPT_POST, true);
curl_setopt($CURL, CURLOPT_POSTFIELDS, $Data);
curl_setopt($CURL, CURLOPT_FOLLOWLOCATION, true);
curl_setopt($CURL, CURLOPT_RETURNTRANSFER, true);
curl_setopt($CURL, CURLOPT_HEADER, false);
$Response = curl_exec($CURL);
curl_close($CURL);
print($Response);
?>

🔹 Envio via Mikrotik

Mensagens podem ser enviadas diretamente através de scripts no Mikrotik utilizando o comando abaixo:

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

Exemplo:

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

💡 Dica: Substitua espaços por %20 ao inserir uma mensagem no comando.

🔹 Testando com o MkAuth Simulator

Antes de colocar em produção, utilize o simulador do MkAuth para testar suas mensagens:

Acesse: Settings > Options > Run

Tela simulador do MkAuth

Exemplo de teste no webadmin:

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

Exemplo de utilização real via MkAuth:

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

Combinação com tag de quebra de linha (##):

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

Exemplo de mensagem configurada no MkAuth:

Olá %nomeresumido%, sua fatura %numerotitulo% vence no dia %vencimento%, para sua comodidade estamos enviando os dados para pagamento: ##{"uid":"%logincliente%","find":"%numerotitulo%"}##Desconsidere este aviso caso já tenha efetuado o pagamento.

🔹 Diagnóstico e Debug

Para depurar falhas e entender possíveis erros de integração:

Menu: Settings > Extras > Debugger → Ative a depuração (ON)

Todos os resultados retornam apenas dois valores:
✅ True = sucesso | ❌ False = falha

Tela debug

1️⃣ Teste de conexão com o MkAuth

Desative e reative o link da API (Settings > API > MkAuth Link)

Teste conexão MkAuth

2️⃣ Teste de comunicação

Use o simulador MkAuth e observe os retornos no log.

Retorno sucesso

Falha por UID incorreto:
Erro UID

Falha por número de título incorreto:
Erro Find

⚠️ Caso o teste com %logincliente% e %numerotitulo% funcione, mas um manual falhe, verifique o formato dos dados enviados.

🔹 Manutenção e Recuperação

Limpar Logs

Settings > Extras > Eraser → clique em Reset
Limpar Logs

Recuperar Token

Se esqueceu seu token, siga os passos abaixo:

1️⃣ No celular, acesse Dispositivos Conectados e remova a instância.
2️⃣ No Mwsm, acesse Settings > Options, clique em Stop e aguarde um novo QRCode.
3️⃣ Reconecte o WhatsApp e envie novamente a mensagem token:1234567.
Recuperar Token

Reenviar mensagens com falhas

Settings > API > Tela 3
Selecione mês e status, clique em Carregar e depois no título desejado.
Reenviar Mensagens

🔹 Contribuindo e Obtendo Suporte

O Mwsm é um projeto gratuito e de código aberto, mantido com base em doações.
Se você deseja apoiar o desenvolvimento contínuo e novas atualizações, considere contribuir:

💰 Doações via PIX

QRCode PIX

Chave aleatória:

e9b9d669-4412-4dec-994c-310005904088

Copia e Cola:

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

💬 Suporte Técnico

Em caso de dúvidas, erros ou sugestões, acesse o fórum oficial do MkAuth:
👉 https://mk-auth.com.br/forum/topics/envio-de-mensagem-via-whatsapp-100-gratuito

✅ Com isso concluímos o guia completo de uso e integração do Mwsm.

Clone this wiki locally