🐝 Bots

Um Bot é um assistente de IA com identidade própria — nome, personalidade e base de conhecimento dedicada. Cada bot vive dentro de um Workspace e pode ser conectado a diferentes canais (WhatsApp, Instagram, widget do site).

A grande vantagem de múltiplos bots é a especialização: cada bot pode ter um tom, conjunto de informações e comportamento completamente diferentes.

Via Dashboard

1. No menu lateral, vá em 🐝 Bots
2. Clique em + Novo Bot
3. Defina um nome descritivo (ex.: "Suporte Técnico")
4. Escreva o system prompt — a personalidade do bot
5. Adicione fontes de conhecimento em 📚 Fontes
6. Teste no 💬 Chat

Via API

curl -X POST https://api.upbeez.com/bots \
  -H "Authorization: Bearer SEU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Suporte Técnico",
    "system_prompt": "Você é um especialista técnico. Responda de forma clara e objetiva."
  }'

Consulte a API Reference completa →

O system prompt é a instrução base que define como o bot se comporta. Pense nele como o "briefing" do seu assistente.

Exemplo de system prompt eficaz

Você é o assistente virtual do Restaurante Sabor & Arte.

Seu nome é "Saborinha". Seja sempre simpático e use emojis com moderação 🍽️.

Você deve:
- Responder perguntas sobre o cardápio, horários e reservas
- Informar que pedidos são feitos pelo iFood ou presencialmente
- Escalar para atendimento humano quando o cliente reclamar

Você NÃO deve:
- Fazer promessas sobre descontos sem consultar a equipe
- Discutir concorrentes
- Responder perguntas não relacionadas ao restaurante

Cada bot tem sua própria Bot API Key (formato bk_live_...). Ela é usada para:

• Autenticar o widget no seu site
• Integrar canais ao bot específico
• Chamar o endpoint /chat/widget diretamente

Como usar no widget

<script
  src="https://app.api.upbeez.com/widget.js"
  data-bot-key="bk_live_xxxxxxxxxxxx"
  async
></script>