Últimas Execuções

Funções JavaScript executadas em sandbox isolado (isolated-vm) durante a conversa do bot. A IA conduz uma entrevista e gera o código. Após aprovadas, podem ser habilitadas por bot.

1. URL pública da plataforma

A plataforma está disponível em:

DNS: bots-whatsapp.aya.tec.br54.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.