1. URL pública da plataforma

A plataforma está disponível em:

DNS: bots-whatsapp.aya.tec.br → 54.94.231.52

2. Criando um bot

1. Clique em Bots → + Novo Bot.
2. Preencha Nome, Descrição e o System Prompt (instruções que o bot seguirá).
3. Em Z-API, cole o Instance ID, Token e Client Token da sua conta Z-API.
4. Em OpenRouter, informe o modelo (ex: anthropic/claude-sonnet-4-5). Deixe a chave vazia para usar a chave global do servidor.
5. Salve e ative o bot.

3. Configurando o webhook na Z-API

Para que o bot responda automaticamente, configure o webhook na Z-API apontando para:

Ou, se quiser um webhook único por bot, use a URL individual mostrada em Detalhes do bot.

1. Acesse o painel Z-API → Webhooks.
2. Em "Ao receber", cole a URL acima.
3. Salve. Pronto: mensagens recebidas serão processadas pelo bot.

4. Cadastrando usuários e retenção de conversas

Cada bot tem seu próprio conjunto de usuários. Ao cadastrar um número:

• Use formato internacional: 5527999999999 (DDI + DDD + número).
• No campo Retenção (dias) defina por quantos dias o histórico será mantido. Deixe vazio para guardar para sempre.
• O sistema limpa conversas antigas automaticamente todo dia às 03:00 BRT.
• Execuções são apagadas após 30 dias.

5. Cron (execução agendada)

Use sintaxe cron padrão no campo Schedule. Exemplos:

• 0 9 * * * — todo dia às 09:00
• 0 9 */3 * * — às 09:00 a cada 3 dias
• */30 * * * * — a cada 30 minutos
• 0 9 * * 1-5 — 09:00 de segunda a sexta

Timezone: America/Sao_Paulo. Ative a opção "Cron habilitado" para rodar.

6. Timeout / tempo limite

O campo Timeout (segundos) define quanto tempo o bot pode demorar respondendo antes de o sistema considerar erro. Padrão: 120s.

7. Base de Conhecimento (contexto extra)

Cada bot tem uma base de conhecimento própria que é injetada no system prompt a cada resposta. Use para FAQs, políticas, catálogos, etc.

1. Abra os detalhes do bot → botão "Base de Conhecimento".
2. Adicione entradas manualmente (título + conteúdo + tags) ou importe um arquivo.
3. Formatos aceitos no import:
   • .json no formato {"entries":[{"title":"...","content":"...","tags":"..."}]}
   • .txt ou .md — vira uma única entrada com o nome do arquivo como título.
4. Desative uma entrada para mantê-la salva sem injetar no prompt.
5. No formulário do bot, o campo "Uso da base" permite escolher all (padrão) ou none (desliga).

8. Regras obrigatórias

O campo Regras no formulário do bot é um bloco adicional anexado ao system prompt. Útil para instruções que NUNCA podem ser esquecidas:

• Nunca compartilhe dados de outros clientes.
• Sempre responda em português do Brasil.
• Se não souber, diga "não sei" em vez de inventar.

9. Import / Export completo de bot

Na aba Bots, use "Importar JSON" e, no detalhe do bot, "Exportar JSON".

• O export inclui configuração + base de conhecimento + lista de usuários.
• Ao exportar, escolha se quer incluir credenciais (tokens Z-API, OpenRouter).
• Bots importados entram inativos por segurança — revise e ative manualmente.
• Use isso para clonar bots, fazer backup ou mover entre instalações.

10. Memória da conversa

O campo "Memória (últimas N mensagens)" controla quantas mensagens anteriores o bot vê ao responder. Padrão: 20. Aumentar melhora contexto mas consome mais tokens.

11. Detalhes do bot

Clique em qualquer bot na aba Bots para ver:

• Status, modelo usado, última execução.
• URLs de webhook individuais (copiar/colar).
• Configurações completas e credenciais mascaradas.
• Histórico recente de execuções.
• Contadores de usuários e mensagens.