Pular para o conteúdo
BQuadra·Ajuda

WhatsApp

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

  1. Abra Configurações › Comunicação › WhatsApp.
  2. Clique em Número do BQuadra.
  3. Clique em Salvar. Aparece Configuração do WhatsApp salva.
  4. Clique em Verificar conexão. Se aparecer Ativo e, ao lado, Usando o número do BQuadra, está tudo certo.
  5. 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.

  1. Abra Configurações › Comunicação › WhatsApp.
  2. Clique em Número próprio.
  3. Preencha ID da instância e Token da instância, copiados do painel da Z-API.
  4. Se a sua conta Z-API tiver Token de Segurança ativado, preencha Client-Token. Se não tiver, deixe em branco.
  5. Em Número conectado (informativo), anote o número, só para referência.
  6. Ligue a chave Envios desta academia por esta instância (fica ON).
  7. Clique em Salvar.
  8. 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

  1. Em Enviar mensagem de teste, digite um celular com DDI e DDD (ex.: +55 27 99999-9999).
  2. Clique em Enviar teste.
  3. 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.

  1. Abra Configurações › Comunicação › Bot do WhatsApp.
  2. Em Prompt do Sistema, escreva as instruções do bot: como ele deve falar, o que a academia oferece, horários, regras.
  3. Clique em Salvar Prompt. A mudança vale em até 5 minutos.
  4. 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.
  5. 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.

Esta página ajudou?