Documentação Oficial
Bem-vindo à central de conhecimento do Blugue CRM. Aqui você aprenderá a configurar o seu atendimento automatizado e a integrar o seu software ao WhatsApp utilizando a nossa API.
Conectando o WhatsApp (Instância)
O primeiro passo para usar o Bluguezap é conectar o seu aparelho celular ao sistema através de um QR Code. O processo é idêntico ao do WhatsApp Web.
O seu vídeo tutorial de como ler o QR Code vai entrar aqui!
- Acesse o menu lateral Bluguezap > Instâncias.
- Clique no botão verde "Nova Instância" e dê um nome (Ex: Suporte).
- Clique no ícone de QR Code na tabela. O sistema irá gerar a imagem na tela.
- No seu celular, abra o WhatsApp, vá em "Aparelhos Conectados" e escaneie o código.
Dica Profissional: Após conectado, não desconecte o aparelho pelo celular, caso contrário você precisará gerar um novo QR Code no sistema.
Autenticação da API (Token)
Para enviar mensagens a partir do seu e-commerce, site ou sistema externo, você precisa de um Token de Acesso exclusivo. Este token identifica a sua empresa de forma segura.
Como gerar o seu Token:
- Acesse o Blugue CRM e vá em API Central.
- Clique em Gerar Meu Primeiro Token.
- Copie o código gerado (ex:
blg_live_a1b2c3...). Ele será usado no cabeçalho das suas requisições HTTP.
Endpoint: Enviar Mensagem (OTP / Notificações)
Este endpoint permite o envio de mensagens de texto simples para qualquer número de WhatsApp ativo.
Método: POST
URL: https://blugue.com/bluguezap/api/send_message
Exemplo de Requisição (PHP / cURL)
<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => 'https://blugue.com/bluguezap/api/send_message',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_POST => true,
CURLOPT_POSTFIELDS => json_encode([
'phone' => '5511999999999',
'message' => 'Seu código de acesso é 4829'
]),
CURLOPT_HTTPHEADER => [
'Content-Type: application/json',
'Authorization: Bearer blg_live_SEU_TOKEN_AQUI'
],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;
Respostas Esperadas
200 OK: Mensagem disparada com sucesso e salva no Kanban.401 Unauthorized: Token inválido ou não informado.429 Too Many Requests: Limite de 5 disparos por minuto por IP excedido.