WhatsApp - Configurações Gerais

O que é

A página de Configurar WhatsApp é onde você define como o canal de WhatsApp da empresa funciona: qual provedor envia as mensagens (Evolution ou API Oficial do Meta), quais notificações automáticas estão ligadas, em que horário sai a cobrança e qual o limite de mensagens por hora para evitar bloqueio do número.

O usuário normalmente chega aqui logo depois de conectar o WhatsApp pela primeira vez (via QR Code ou Meta), e volta sempre que quer ligar ou desligar uma automação, ajustar o horário de envio de lembretes de vencimento ou migrar do Evolution para a API Oficial do Meta.

Como usar

1. Vá em WhatsApp > Configurações no sidebar. A URL é /admin/whatsapp/config.
2. Defina o provedor no card verde do topo "API Oficial do Meta (WhatsApp Business)":
   • Se quiser ficar no Evolution (QR Code), basta ignorar o card. O selo mostra "Não configurada".
   • Para migrar para a API Oficial, clique em Configurar Meta e preencha os tokens (access token, phone number id, WABA id, verify token). Após salvar, o selo muda para "Ativa" em verde e o botão vira Gerenciar Meta.
3. Na aba Automações (padrão), ligue ou desligue cada interruptor verde de notificação:
   • Reservas - Confirmação de Reserva e Cancelamento de Reserva.
   • Pagamentos - Confirmação de Pagamento, Lembrete de Cobrança e Lembrete de Vencimento.
   • Lembretes de Viagem - 1 dia antes, 3 dias antes e 7 dias antes da viagem.
   • Outros - Aniversário e Pesquisa de Satisfação.
4. Ao ligar Lembrete de Vencimento, expanda o bloco e marque quais lembretes enviar (7 dias antes, 3 dias antes, 1 dia antes (véspera), No dia do vencimento, Após vencidos (até 7 dias)) e o Horário de envio (das 07:00 às 18:00, opções pré-definidas).
5. No bloco amarelo "Limite de mensagens por hora", ajuste o número entre 10 e 600. O sistema aceita o valor recomendado de 120 por padrão; mensagens acima do limite ficam na fila e saem assim que houver espaço.
6. Clique em Salvar Configurações (botão verde no final da aba). A página confirma com a mensagem "Configurações salvas com sucesso!".
7. (Opcional) Mude para a aba Templates para personalizar o texto de cada notificação. Detalhes em WhatsApp - Personalizar Templates.

Casos especiais

Migrar do Evolution para a API Oficial do Meta

A migração não apaga as credenciais antigas: o Evolution fica salvo e pode ser retomado depois. O fluxo é:

1. No card superior, clique em Configurar Meta - abre /admin/whatsapp/meta.
2. Preencha Access Token, Phone Number ID, WABA ID e Verify Token (mínimo 6 caracteres). O App Secret é opcional.
3. Ao salvar, o sistema marca provider = meta, zera o status de conexão e tenta validar os tokens chamando o Meta. Se os tokens estiverem corretos, o status volta para Conectado automaticamente.
4. O painel retorna a URL de webhook que precisa ser cadastrada no Meta Business Manager (formato /webhook/meta/{tenant_id}).
5. Para voltar para Evolution depois, use a opção Voltar para Evolution na página do Meta - mantém os tokens salvos e zera o status de conexão.

Aviso de templates ao usar Meta

Quando o provedor é Meta, a aba Templates mostra um banner âmbar avisando que editar um template exige reaprovação pelo Meta (leva de 1 a 48h). Enquanto não for reaprovado, o texto enviado continua sendo o da versão anteriormente aprovada. O link "Ir para gerenciamento Meta" leva direto para /admin/whatsapp/meta#templates.

Lembrete de Vencimento sem sub-opção marcada

Se você liga o interruptor principal Lembrete de Vencimento mas não marca nenhuma das sub-opções de quando enviar, nenhum lembrete sai. Marque ao menos um dos cinco gatilhos (7 dias antes, 3 dias antes, véspera, no dia, após vencidos) para o cron disparar.

Limite de mensagens fora da faixa

O campo de Limite por hora é normalizado no salvamento: valores menores que 10 viram 10, valores maiores que 600 viram 600. Recomendado 120 (equilibrado), conservador 60, agressivo 300.

Erros comuns e como resolver

• "WhatsApp não está conectado." - Aparece ao tentar enviar mensagem de teste sem o canal conectado. Solução: vá em WhatsApp > Conectar e escaneie o QR Code (Evolution) ou complete a configuração do Meta.
• "Tokens salvos mas não foi possível validar a conexão" - Os tokens foram gravados, mas o Meta não respondeu com CONNECTED. Confira Access Token (com permissão whatsapp_business_messaging), Phone Number ID e WABA ID no Meta Business Manager. O webhook precisa ser cadastrado lá com a URL retornada.
• "Falha ao criar instância no servidor. Contate o suporte." - Erro ao auto-provisionar instância Evolution Go. O log fica em [WhatsApp] no laravel.log. Acione o suporte com o instance_name da sua empresa.
• "Provider não é Meta." - Aparece ao tentar listar templates Meta ou submeter templates padrão sem ter o provedor Meta ativo. Solução: configure o Meta antes (passos do "Casos especiais").

Onde encontrar

• URL: /admin/whatsapp/config
• Caminho no menu: WhatsApp > Configurações
• Permissão necessária: ver o WhatsApp
• Módulo necessário: WhatsApp Mensagens (whatsapp-mensagens) - uma trava de acesso + whatsapp.terms (aceite de termos exigido no primeiro acesso)

Veja também

• Conectar seu WhatsApp - escanear QR Code e validar a conexão antes de configurar automações
• Personalizar Templates - editar o texto enviado em cada automação
• Configurar Automações - visão dedicada das automações por evento
• Histórico de Mensagens - auditar o que foi enviado, reenviar e filtrar por status