WENKET — PACOTE INICIAL DO CHATBOT
==================================

O pacote contém:
- chatbot-config.example.php : modelo de configuração separado (NÃO substitui config.php existente)
- chatbot-api.php            : API simples do chat do site, com respostas iniciais
- chatbot-widget.html        : exemplo de janela de chat para incorporar no sistema Wenket
- chatbot-widget.js          : código da janela do chat
- chatbot-widget.css         : visual da janela
- whatsapp-webhook.php       : webhook para WhatsApp Cloud API oficial da Meta
- .htaccess.example          : exemplo opcional de proteção para Apache
- LEIA-ME-SEGURANCA.txt      : cuidados antes de publicar

IMPORTANTE
----------
1. Estes arquivos são uma base funcional inicial, não estão instalados no seu servidor.
2. Não substitua nem apague o config.php, produtos.php, API de vendas ou outros arquivos existentes.
3. Copie os arquivos novos para uma pasta separada, por exemplo /public_html/chatbot/.
4. A integração de produtos/preços com o banco atual ainda precisa ser ajustada ao esquema real do banco Wenket.
   Não inventamos nomes de tabelas ou colunas para não afetar o estoque.
5. O WhatsApp exige configuração na Meta Developers, um número habilitado para a WhatsApp Cloud API,
   Phone Number ID, Access Token e Verify Token. Sem isso, o webhook não consegue enviar mensagens reais.
6. Nunca compartilhe Access Token em conversas, prints ou arquivos públicos. Configure-o diretamente no servidor.

PASSO 1 — BACKUP
----------------
Antes de instalar, faça download/backup da pasta atual do Wenket pela hospedagem.

PASSO 2 — PASTA SEPARADA
------------------------
Crie uma pasta chamada "chatbot" dentro da pasta pública do site (normalmente public_html).
Envie para ela os arquivos PHP, JS e CSS deste pacote.
Não envie chatbot-config.example.php com credenciais reais. Crie uma cópia chamada chatbot-config.php
e preencha os valores no servidor. O chatbot-config.php não está incluído de propósito.

PASSO 3 — CONFIGURAÇÃO DO SITE
------------------------------
Edite chatbot-widget.js e troque:
  const API_URL = "./chatbot-api.php";
pelo endereço real da API, por exemplo:
  const API_URL = "/chatbot/chatbot-api.php";

Abra chatbot-widget.html no navegador para uma demonstração local hospedada.
Para incorporar no Wenket, adicione o conteúdo do widget no template/página principal, ou use:
  <link rel="stylesheet" href="/chatbot/chatbot-widget.css">
  <script src="/chatbot/chatbot-widget.js" defer></script>
O JS cria o botão e a janela do chat automaticamente.
Se o site estiver em outra pasta, ajuste os caminhos absolutos.

PASSO 4 — CONFIGURAÇÃO DO WHATSAPP
----------------------------------
A) No Meta for Developers, selecione/crie o app e adicione o produto WhatsApp.
B) Na configuração da WhatsApp Cloud API, obtenha:
   - Phone Number ID
   - Access Token (preferencialmente token de sistema/permanente conforme a configuração da empresa)
   - número comercial habilitado
C) No servidor, crie chatbot-config.php copiando os campos do exemplo e preenchendo os valores.
D) Configure no painel da Meta o callback URL:
   https://SEU-DOMINIO/chatbot/whatsapp-webhook.php
   e o mesmo Verify Token definido em chatbot-config.php.
E) Inscreva o webhook no campo "messages".
F) Teste primeiro com o número de teste e destinatários autorizados mostrados no painel da Meta.

PASSO 5 — TESTES
----------------
1. Acesse https://SEU-DOMINIO/chatbot/chatbot-api.php no navegador. Deve retornar JSON com ok=true.
2. Teste o chat do site enviando "oi", "horário", "endereço", "produtos" e "atendente".
3. Na Meta, use a ferramenta de teste de webhook e depois envie uma mensagem real para o número conectado.
4. Consulte o log de erros do PHP da hospedagem se algo falhar.

LIMITAÇÕES DA PRIMEIRA VERSÃO
-----------------------------
- Respostas automáticas iniciais por palavras-chave.
- Ainda não consulta o banco de produtos/preços real nem registra pedidos.
- Não altera estoque nem interfere na API de vendas.
- O webhook responde mensagens de texto recebidas; mensagens interativas, mídia e pedidos exigem tratamento adicional.
- A Meta impõe regras de janela de atendimento e modelos aprovados para mensagens iniciadas pela empresa.
- O envio depende de credenciais válidas e permissões aprovadas na Meta.

Para conectar os produtos reais, será necessário conferir o arquivo de conexão e a estrutura das tabelas do Wenket,
sem publicar senhas ou tokens.
