Escolha por qual número o sistema manda códigos, cobranças e avisos: o do BQuadra ou o da sua academia. Com número próprio, configure o bot de atendimento.
- Menu: Configurações › Comunicação › WhatsApp (e Bot do WhatsApp)
- Plano: Profissional+
- Quem usa: Administrador
Nesta página (7)
Para que serve
Aqui você decide por qual número de WhatsApp o sistema fala com seus alunos e clientes. Por esse número saem:
- os códigos de login da área do aluno e da página de reserva;
- as cobranças e os avisos automáticos (veja Notificações automáticas).
Com número próprio, a academia também pode ter o bot de atendimento, que conversa com quem manda mensagem, tira dúvidas e capta leads para o CRM. O bot não liga sozinho: a ativação é combinada com o suporte BQuadra.
Quem usa
Só o administrador. A tela WhatsApp aparece a partir do plano Profissional (módulo WhatsApp). A tela Bot do WhatsApp depende do módulo CRM e da permissão CRM Config. Bot, e mesmo assim só abre para administrador.
Passo a passo
Usar o número do BQuadra
- Abra Configurações › Comunicação › WhatsApp.
- Clique em Número do BQuadra.
- Clique em Salvar. Aparece Configuração do WhatsApp salva.
- Clique em Verificar conexão. Se aparecer Ativo e, ao lado, Usando o número do BQuadra, está tudo certo.
- Confira se o Telefone de contato está preenchido em Dados da academia. Ele vai no rodapé das mensagens.
Usar o número próprio da academia
Antes, você precisa de uma instância da Z-API já conectada ao WhatsApp da academia. A conexão (leitura do QR code com o celular) é feita no painel da Z-API, não no BQuadra.
- Abra Configurações › Comunicação › WhatsApp.
- Clique em Número próprio.
- Preencha ID da instância e Token da instância, copiados do painel da Z-API.
- Se a sua conta Z-API tiver Token de Segurança ativado, preencha Client-Token. Se não tiver, deixe em branco.
- Em Número conectado (informativo), anote o número, só para referência.
- Ligue a chave Envios desta academia por esta instância (fica ON).
- Clique em Salvar.
- Clique em Verificar conexão. Se estiver certo, o botão mostra Ativo, o número conectado e Usando credenciais próprias da academia.
Enviar uma mensagem de teste
- Em Enviar mensagem de teste, digite um celular com DDI e DDD (ex.: +55 27 99999-9999).
- Clique em Enviar teste.
- Confira se a mensagem chegou no celular. Pelo número do BQuadra, ela chega com o nome da academia no topo e o aviso de “não responda” no fim.
Configurar o bot de atendimento
A tela Bot do WhatsApp aparece para academias com o módulo CRM. O prompt e os documentos só são usados depois que o suporte BQuadra ativa o bot no número próprio da academia.
Se a academia usa o Número do BQuadra, a tela abre com o aviso “O bot não atende nesta academia.” Você pode deixar o prompt e os documentos prontos, mas o bot só começa a responder depois de contratar e configurar o número próprio.
- Abra Configurações › Comunicação › Bot do WhatsApp.
- Em Prompt do Sistema, escreva as instruções do bot: como ele deve falar, o que a academia oferece, horários, regras.
- Clique em Salvar Prompt. A mudança vale em até 5 minutos.
- Para o bot mandar arquivos, vá em Documentos do Bot: preencha Nome do Documento, escolha o Tipo e selecione o Arquivo (PDF). O envio começa assim que você escolhe o arquivo.
- No prompt, use a tag
[enviar_tabela_precos]para dizer quando o bot deve mandar a tabela de preços.
No prompt, você pode usar estes campos. O sistema troca pelos dados da sua academia:
{{ACADEMIA_NOME}}— nome da academia;{{RESERVA_URL}}— endereço da página de reserva;{{CADASTRO_URL}}— endereço do cadastro online;{{ENDERECO}}— endereço da academia;{{WHATSAPP_CONTATO}}— telefone de contato.
Campos importantes
- Número do BQuadra — número compartilhado, incluso no plano. Só envia. Não recebe resposta e não tem bot de atendimento.
- Número próprio — o WhatsApp da academia, contratado à parte. Permite o bot.
- Envios desta academia por esta instância (ON/OFF) — com número próprio, precisa estar em ON. Em OFF, a academia fica sem envio de WhatsApp.
- ID da instância e Token da instância — dados de acesso da sua instância, do painel da Z-API.
- Client-Token (opcional) — só se a conta Z-API tiver Token de Segurança. Fica em Segurança, na conta, não na instância.
- Número conectado (informativo) — só para você lembrar qual número está ligado. Não muda nada no envio.
- Prompt do Sistema — o “roteiro” do bot: personalidade, informações e regras.
- Documentos do Bot — PDFs que o bot pode mandar. Tipos: Tabela de Preços, Regulamento, Horários, Outros.
Regras do sistema
- Mensagens pelo número do BQuadra saem com o nome da academia em destaque no topo e, no fim, o aviso: “Mensagem automática, não responda. Fale com a academia pelo WhatsApp (seu telefone de contato)”.
- Com número próprio, as mensagens saem do WhatsApp da academia, sem esse aviso.
- Quem escreve para o número do BQuadra recebe uma resposta automática: “Este número só envia mensagens automáticas das academias que usam o sistema BQuadra e não recebe respostas. Para falar com a sua academia, entre em contato pelo WhatsApp ou telefone dela.” Ela sai no máximo uma vez a cada 24 horas para o mesmo número. A mensagem não é repassada para a academia.
- O bot de atendimento só funciona com Número próprio. Com o número do BQuadra, as telas WhatsApp e Bot do WhatsApp mostram o aviso de bot indisponível.
- Tokens ficam guardados cifrados. Na tela, campos com **** mantêm o valor salvo. Para trocar, cole o valor novo.
- Se você clicar em Salvar com número próprio preenchido e a chave em OFF, o sistema pergunta se quer ligar a instância agora.
- Verificar conexão e Enviar teste funcionam mesmo com a chave em OFF, para você testar antes de ligar.
- O bot pergunta os dados da aula experimental (para quem é, nome, idade, nível, período e dias), pede confirmação e, com o “sim”, manda o lead para o CRM.
- Se a pessoa não confirmar os dados, o bot manda uma mensagem de lembrete depois de 2 horas (uma vez só).
- O bot entende áudio. Se não conseguir ouvir, pede para a pessoa escrever.
- Quando alguém da academia responde pelo WhatsApp, o bot fica em silêncio com aquele contato por 5 horas. A pausa vale mesmo que o sistema seja reiniciado, e a fala do atendente entra no histórico da conversa.
- Quando o bot não sabe responder, ele avisa “Vou encaminhar você para um atendente. Aguarde um momento.” e fica em silêncio com aquele contato por 24 horas. O aviso que vai aos administradores traz as últimas 15 falas da conversa (veja Avisos aos admins).
- Na coleta dos dados da aula experimental, se a pessoa ficar mais de 6 horas sem responder, ou voltar só com um cumprimento (“oi”, “boa tarde”), o bot deixa o cadastro de lado e volta à conversa normal. O que já foi informado fica guardado.
- Se o bot repetir a mesma pergunta pela terceira vez sem resposta útil, ele para de insistir e avisa os administradores com “BOT TRAVOU NO CADASTRO”. A conversa fica para a equipe.
- O número conectado nunca recebe mensagem dele mesmo. Se um administrador estiver cadastrado em Avisos aos admins com o celular do próprio WhatsApp da academia, esse aviso é descartado em vez de virar eco.
- Limite de envio por número: 150 mensagens por hora e 6 por hora para o mesmo destino. O que passar disso espera na fila de comunicação (Notificações automáticas).
- Com a instância desconectada, as mensagens esperam na fila e tentam de novo a cada 5 minutos, até o prazo de cada uma (cobranças e lembretes 3 dias; confirmação e pagamento de reserva até o início da reserva; senha do portão até o fim da folga; as demais 24 horas). Passado o prazo, a mensagem expira e não sai.
- O bot manda sozinho apenas o documento do tipo Tabela de Preços (o mais recente), quando o prompt usa a tag. Os outros tipos ficam guardados.
- Arquivos do bot: só PDF, até 10 MB.
Erros comuns e como resolver
- “O número do BQuadra ainda não está configurado neste servidor: nenhuma mensagem será enviada até isso ser feito.” — o número compartilhado ainda não foi ativado para o seu ambiente. Fale com o suporte do BQuadra.
- Botão mostra “Desconectado” — a instância está fora do ar. Com número próprio, abra o painel da Z-API e leia o QR code de novo com o celular da academia. Depois clique em Verificar conexão. As mensagens dentro do prazo saem sozinhas ao reconectar; as vencidas aparecem como Expirado no Histórico de Envios.
- Um administrador não recebe os avisos da academia — confira se o número dele em Avisos aos admins não é o próprio WhatsApp da academia. O número conectado não recebe mensagem dele mesmo.
- “Credenciais não configuradas” — faltam ID da instância ou Token da instância. Preencha e salve.
- “Instância não configurada” ao enviar teste — mesmo caso: preencha ID e token e salve antes de testar.
- “Informe o celular com DDI e DDD” — o campo de teste está vazio ou sem números. Digite o celular completo.
- “Falha ao enviar WhatsApp. Tente novamente.” no login do cliente — o código não saiu porque o WhatsApp está fora do ar. Verifique a conexão aqui. Enquanto isso, o cliente pode entrar por e-mail ou pelo Google.
- “Erro ao salvar prompt” ou “Erro ao enviar documento” — tente de novo. Para documento, preencha o nome antes de escolher o arquivo e use só PDF.
- “Acesso Restrito” na tela do bot — só administrador configura o bot.
Dúvidas comuns
Qual a diferença entre Número do BQuadra e Número próprio?
O Número do BQuadra vem incluso no plano e só envia: a mensagem sai com o nome da academia e avisa que não recebe resposta. O Número próprio é o WhatsApp da sua academia, contratado à parte, e permite o atendimento pelo bot.
Meu plano não mostra a tela WhatsApp. Os avisos saem mesmo assim?
Sim. Sem o módulo WhatsApp, os avisos saem pelo Número do BQuadra. A tela só aparece a partir do plano Profissional, para quem quer usar o número próprio.
O aluno pode responder a mensagem que chegou pelo número do BQuadra?
Não. O número do BQuadra só envia. No fim de cada mensagem vai o aviso para falar com a academia pelo telefone de contato cadastrado em Dados cadastrais. Se a pessoa responder mesmo assim, recebe uma resposta automática dizendo que o número só envia avisos e que deve falar com a própria academia (no máximo uma vez a cada 24 horas). A resposta não chega à academia.
Posso ter o bot de atendimento usando o número do BQuadra?
Não. O número do BQuadra é compartilhado entre várias academias e só envia avisos, então não conversa. O bot de atendimento só funciona com Número próprio. As telas WhatsApp e Bot do WhatsApp avisam isso quando a academia usa o número do BQuadra.
Mudei o texto do bot. Quando vale?
Em até 5 minutos depois de clicar em Salvar Prompt.
Se eu responder um cliente pelo celular da academia, o bot continua falando junto?
Não. Quando alguém da academia responde pelo próprio WhatsApp, o bot fica pausado para aquele contato por 5 horas, mesmo que o sistema seja reiniciado nesse meio-tempo.
O que acontece se o WhatsApp cair?
Nada sai por WhatsApp até reconectar: códigos de login, cobranças, avisos e o bot. As mensagens ficam na fila de comunicação esperando, cada uma com um prazo: cobranças e lembretes valem 3 dias; confirmação e pagamento de reserva valem até o início da reserva; senha do portão vale até o fim da folga da reserva; as demais, 24 horas. Ao reconectar saem só as que ainda estão no prazo; as vencidas ficam como Expirado no Histórico de Envios e não são enviadas. Os avisos com e-mail ligado continuam indo por e-mail. Use Verificar conexão para conferir.
Mandei muitas mensagens de uma vez e algumas demoraram.
Cada número tem um limite de envio: 150 mensagens por hora e 6 por hora para o mesmo destino. O que passa disso espera na fila de comunicação e sai em seguida. Você acompanha em Configurações › Comunicação › Notificações, no bloco Fila de comunicação.
Obrigado! Que bom que ajudou.
Obrigado por avisar. Conte pelo WhatsApp o que faltou.