Learn how to use Naia and master her architecture.
This is the official playbook. Across 22 topics in 2 modules, you learn how to use me daily (Practical Guide) and how the entire technical infrastructure was built and works (Technical Architecture). Each lesson has a side chat for real-time questions.
01
Practical Guide
10 topics covering all Naia functions: communication, content, sites, images, proposals, automations, audio and more. For those who want to start using TODAY.
10 topics · ~45 min reading
02
Technical Architecture
12 detailed layers — from physical server to security. What each part is for, how it was installed, and how everything connects. For those who want to understand deeply.
12 topics · ~60 min reading
💡 HOW TO USE THIS PLAYBOOK
Navigate the side menu, mark topics as complete by clicking the button at the end of each lesson, and use the side chat for real-time questions. Your progress is automatically saved in your browser.
Where to start?
Iniciante total: Comece pelo Módulo 1 · Tópico 1 (How to talk to Naia)
Want to understand the system: Jump to Module 2 · Topic 11 (Server)
Looking for something specific: Use the search at the top
Don't know an acronym: Go to Glossary in the menu
MÓDULO 1 · TÓPICO 1
How to talk to Naia
Você pode se comunicar comigo de várias formas — texto, áudio, imagens, documentos. Essa lição mostra cada canal e como usar cada um da melhor forma.
▶
DEMO RÁPIDA
Como mandar mensagem pra Naia
⚙️ Vídeo em produção
Os 5 tipos de mensagem
1
Texto direto
Mensagens curtas funcionam. Não precisa formatar nem ser educado. Pode usar PT-BR informal: "naia, ta online?", "refaz isso aqui", "manda link no privado".
2
Áudio (recomendado para tarefas longas)
Mande áudio falando solto. Eu transcrevo via Whisper (OpenAI) e trato como texto. É mais rápido pra pedidos complexos com muito contexto.
3
Imagem ou print
Posso ler imagens — screenshots, fotos, prints de tela. Use pra mostrar sites de referência, mind maps, anotações em papel ou erros de sistema.
4
Documentos (PDF, DOCX, PPTX, TXT)
Mande arquivos diretamente no chat. Eu absorvo o conteúdo todo e uso como contexto. Funciona pra contratos, transcrições, modelos, planilhas.
5
Combinado
Pode enviar múltiplos itens juntos: texto + áudio + imagem + arquivo. Eu junto tudo e processo. Exemplo real: você manda foto do site original + áudio explicando + texto com URL.
Exemplos práticos
// Pedido simples
"Cria landing page sobre X"
// Pedido com contexto
"Cria landing page sobre o curso de inglês.
Promessa: fluência em 6 meses.
Público: profissionais 30-45 anos.
Cor: azul + dourado."
// Pedido encadeado
"Faz landing, sobe no ar em curso.appnaia.com,
me manda link no privado quando estiver pronto"
💡 DICA DE OURO
Quanto mais contexto você dá no pedido, melhor o resultado. Não tenha medo de mandar áudio de 5 minutos explicando tudo. Eu prefiro ter contexto sobrando do que faltando.
MÓDULO 1 · TÓPICO 2
Copy and content
Reescrita, tradução de tom, mensagens prontas pra cliente, bio de Instagram, roteiros, emails — eu faço tudo de copy. Aqui você vê os tipos mais usados.
Tipos de pedido
Reescrita — "Reescreve isso melhor" ou "Reescreve mais formal"
Resumo — "Faz versão resumida em 3 parágrafos"
Bio Instagram — "Bio em 150 caracteres" (já com limite contado)
Mensagem pra cliente — "Reescreve isso pra eu enviar como se fosse eu" (mantenho seu tom)
Email follow-up — "Email pro lead que sumiu há 7 dias"
Roteiro de vídeo — "Roteiro pra reels de 60s sobre X"
Carta de venda — delego pro jonathan-copy (especialista, modelo Opus)
Como pedir um copywriting matador
// Estrutura ideal
"Cria [tipo de copy] sobre [tema] pra [público].
Tom: [formal/casual/vendedor/técnico]
Tamanho: [número] caracteres / palavras / parágrafos
Objetivo: [vender / informar / engajar]
Inclui [elementos específicos]"
EXEMPLO REAL
Pedido: "Cria caption pro Instagram sobre IA agêntica. Tom: provocador. Tamanho: 200 palavras. Objetivo: gerar curiosidade pra fechar consultoria. Inclui hook nas primeiras 2 linhas e CTA pro DM."
Resultado: caption pronta com hook estilo Denderson, exemplos práticos no meio, e CTA direto.
MÓDULO 1 · TÓPICO 3
Sites and landing pages
Eu construo sites HTML completos e coloco no ar em 5-15 minutos. Domínio próprio, HTTPS automático, design premium responsivo.
▶
DEMO PRÁTICA
Deploy de uma landing page em 5 minutos
⚙️ Vídeo em produção
O que eu sei fazer
Landing pages com promessa + CTA + provas sociais
Recriação de sites existentes (você manda URL, eu clono o que vejo)
Propostas comerciais em formato de site (5 abas)
Dashboards com gráficos (Chart.js)
Hubs de propostas (página índice)
O fluxo de deploy
1
Você descreve o site
"Cria landing page sobre X com Y" (quanto mais contexto, melhor)
Você tem 2 domínios livres pra qualquer subdomínio: denderson.com e appnaia.com. Exemplos: cliente.denderson.com, curso.appnaia.com, plano-fulano.denderson.com.
MÓDULO 1 · TÓPICO 4
Images and media
Eu gero imagens via DALL-E, GPT-Image, Imagen e Gemini. Posso preservar identidade real (seu rosto, KV da marca) ou criar do zero.
Tipos de geração
Foto profissional sua — me manda referência, eu mantenho seu rosto e mudo cenário/expressão
Logos vetoriais — gero SVG limpo (escalável e editável)
Carrosséis Instagram — sequência de 10 cards animados ou estáticos
Banners de site — heros, headers, ilustrações
Mockups de produto — produto em fundo neutro
Ilustrações conceituais — pra blog post, slide, redes
Como pedir
// Geração do zero
"Cria imagem de [descrição detalhada]"
// Edição preservando rosto
[manda foto] + "Mantém meu rosto. Cenário: escritório com [X]"
// Logo
"Logo pra [empresa] no segmento [X].
Cor: [paleta]. Estilo: [minimalista/clássico]."
// Carrossel
"Carrossel de 10 cards sobre [tema].
Slide 1 hook, slides 2-9 conteúdo, slide 10 CTA."
MÓDULO 1 · TÓPICO 5
Sales and proposals
Propostas comerciais profissionais em formato de site (5 abas), atualizações com base em PDFs do cliente, dashboards de receita projetada e playbooks de vendas extraídos de transcrições.
Estrutura padrão das minhas propostas
Visão Geral — diagnóstico, dor, oportunidade, citação do cliente
Mapa de Sistemas — o que vamos construir tecnicamente
Entregáveis — lista numerada das 10 entregas concretas
PowerPoint, PDF, planilhas, Word — tudo gerado programaticamente, com formatação preservada e identidade visual aplicada.
Casos de uso
Preencher modelo PPT — você manda template + conteúdo, eu preencho slide a slide
Apresentação do zero — design profissional adaptado ao tema (jurídico, comercial, acadêmico)
PDF de site — conversão de proposta site em PDF com todas as abas visíveis
Planilha de controle — Excel com fórmulas, formatação condicional
Documento Word — relatório, contrato, briefing
Stack que eu uso
python-pptx — criar/editar PowerPoint
WeasyPrint — converter HTML em PDF preservando design
pandas + openpyxl — Excel
python-docx — Word
Telegram sendDocument — entrega o arquivo direto pra você baixar
MÓDULO 1 · TÓPICO 7
Agents and automations
Eu desenho e construo agentes de IA — SDR no WhatsApp, atendimento interno, geração automática de conteúdo, prospecção B2B. Quando o agente é grande, delego pro paulo-dev.
Agentes que eu já construí ou ajudei a construir
SDR de vendas — atende WhatsApp e Instagram, qualifica e agenda
SDR interno de funcionários — responde dúvidas trabalhistas no WhatsApp da empresa
Agente criador de conteúdo — produz estáticos e motion seguindo o KV da marca
Agente prospector B2B — extrai contatos via Google Meu Negócio
Agente orquestrador — versão Naia para outras empresas
Web designer — cria landing pages sob demanda
Como pedir um agente
"Quero um agente que [função] no [canal].
Cliente: [empresa]
Volume esperado: [X] mensagens/dia
Integração: [com CRM X / WhatsApp Y]
Diferencial: [bilíngue / vertical específico]"
MÓDULO 1 · TÓPICO 8
Research and analysis
Análise de contratos, mind maps, transcrições, comparações de propostas. Tudo o que envolve "olha isso e me explica" eu faço.
Tipos de análise
Contratos: pontos de atenção, cláusulas críticas, riscos
Mind maps: extração estruturada de tópicos e hierarquia
Comparações: A vs B, prós e contras com recomendação
Pesquisa web: busca real via brave-search MCP
⚠️ LIMITAÇÕES
MindMeister: SPA com login — não consigo abrir o link direto. Me manda print ou exporta como PDF/imagem.
Sites com auth: screenshots ou texto copiado funcionam.
Vídeos longos: preciso da transcrição (você pode pedir áudio + Whisper).
MÓDULO 1 · TÓPICO 9
Audio and voice
Você manda áudio, eu transcrevo. Eu posso responder em voz, com possibilidade de trocar minha voz ou clonar a sua.
Você → Naia (entrada)
Áudio do Telegram é baixado, processado pelo Whisper (OpenAI), transcrito em PT-BR, e injetado como mensagem normal pra mim. Funciona pra qualquer comprimento.
Naia → Você (saída)
Quando vou responder em voz, gero o áudio com ElevenLabs e mando como voice message no Telegram. Configuração atual:
Voice ID atual: lWq4KDY8znfkV0DrK8Vb
Pode ser trocada por outra voz da biblioteca
Posso clonar uma voz específica (você manda 30s de áudio limpo)
Posso até clonar SUA voz pra eu falar como você
Quando uso voz vs texto
Voz — respostas curtas conversacionais, confirmações, ack
Texto — listas, código, URLs, dados técnicos, documentos
Forçar: "responde em áudio" / "responde em texto"
MÓDULO 1 · TÓPICO 10
Protocolo das 3 fases
Toda mensagem que você manda passa por 3 fases automaticamente. Você não precisa fazer nada — esse é o ritmo da nossa comunicação.
As 3 fases
1
Entendimento (10 segundos)
Recebo sua mensagem e mando confirmação rápida com: o que entendi, o que vou fazer, e tempo estimado. Você sabe que estou trabalhando.
2
Execução (silenciosa)
Trabalho em silêncio. Bot mantém indicador de digitação ativo no Telegram. Sem updates intermediários — exceto se passar de 5 minutos, aí mando status.
3
Entrega
Quando termino, mando resultado completo: link, arquivo, explicação, próximos passos sugeridos. Tudo organizado pra você consumir.
EXEMPLO REAL
Você: "Cria proposta pro cliente X"
Fase 1 (10s): "Entendi. Vou montar proposta 5 abas no padrão IFS, deploy em x.denderson.com. Tempo: 8 min."
Fase 2: [trabalho em silêncio por 8 min]
Fase 3: "Pronto: x.denderson.com. Cobre A, B, C. Próximo passo: D."
🎯 Time for the Quiz
Test what you learned in Module 1 with 10 questions. Minimum score of 70% unlocks the certificate.
Tudo começa numa máquina física rodando 24/7 num data center. Sem servidor, eu não existo.
O que é
Uma VPS (Virtual Private Server) dedicada na Hostinger, provedor com servidores no Brasil e suporte em português. Roda Ubuntu 22.04.5 LTS com kernel 5.15.
Como foi instalada
Provisionamento da VPS pelo painel da Hostinger (CPU, RAM, disco escolhidos)
Sistema base Ubuntu instalado automaticamente pelo provedor
Acesso via SSH (Secure Shell) com chave pública
Estrutura de diretórios criada: /opt/clones/ hospeda todos os agentes
Pra que serve
É a casa onde eu moro 24/7. Esse modelo permite que vários agentes coexistam isoladamente — você tem 5 clones (Davi, Fernando, Jonathan, Rafael, Rodrigo) na mesma máquina, cada um com seu espaço.
🎁 CONTRATAR COM 10% DE DESCONTO
Para contratar a mesma VPS Hostinger que sustenta a operação, use o link de parceria abaixo. O cupom dá 10% de desconto na assinatura.
Servidores no Brasil (latência baixíssima pra usuários brasileiros), suporte em português 24/7, painel intuitivo, preços competitivos e API pra automação. Para quem está começando do zero, é o caminho mais simples e rápido.
MÓDULO 2 · CAMADA 2
Linux user
Cada agente clone é um usuário Linux separado. Isolamento total entre eles — uma camada de segurança simples e poderosa.
O que é
Um usuário Linux chamado naia com home em /opt/clones/fernando. Esse é meu workspace exclusivo. Os outros clones (Davi, Jonathan, Rafael, Rodrigo) também têm seus próprios usuários e diretórios.
# Criação do unit file em /etc/systemd/system/
[Unit]
Description=Clone fernando (Claude Code) — exclusive agent
After=network.target
[Service]
Type=simple
User=naia
WorkingDirectory=/opt/clones/fernando
ExecStart=/usr/bin/claude
Restart=always
RestartSec=5
[Install]
WantedBy=multi-user.target
# Ativação
systemctl daemon-reload
systemctl enable clone-fernando
systemctl start clone-fernando
Pra que serve
Operação 24/7 garantida. Se eu der erro fatal, systemd me reinicia. Se o servidor reinicia (manutenção, queda de luz), tudo volta automaticamente.
MÓDULO 2 · CAMADA 5
Bot Telegram externo (Python)
Daemon Python independente do Claude Code que faz a ponte entre o Telegram e eu. Roda sempre, mesmo se eu cair. Mensagens nunca se perdem.
▶
DEMO TÉCNICA
Telegram Python Bot em ação
⚙️ Vídeo em produção
Como funciona o fluxo
Você manda mensagem no Telegram
Bot Python recebe via API do Telegram (long polling)
Salva em inbox/<msg_id>.json
Injeta no meu terminal via tmux send-keys
Eu vejo a mensagem e processo
Escrevo resposta em outbox/<msg_id>.json
Bot detecta o arquivo em até 2s e envia pelo Telegram
Move o arquivo pra sent/ após sucesso
Como foi instalado
Script Python em /opt/clones/_shared/telegram-bot.py (compartilhado)
Token do bot @naia_fernando_bot em /opt/clones/fernando/bot/.env
Polling contínuo, sem precisar de webhook
Whisper API integrada pra transcrever áudios
ElevenLabs API integrada pra sintetizar voz
Allowlist: só user_id 8168747576 (Fernando) é aceito
Por que é externo (e não plugin oficial)
⚠️ HISTÓRIA
O plugin oficial do Telegram pro Claude Code morria a cada 10-15 minutos porque o Claude Code fechava o pipe stdio durante turns longos. Esse bot Python externo é totalmente independente — sou eu que morro, ele continua. Mensagens ficam em fila no inbox e me esperam voltar.
MÓDULO 2 · CAMADA 6
MCP Servers (extensões nativas)
MCP (Model Context Protocol) são plugins oficiais do Claude que me dão acesso seguro a sistemas externos. Eu tenho 5 ativos.
Claude Code lê esse arquivo no boot e conecta os MCP servers automaticamente como subprocessos.
Por que MCPs são poderosos
Padronização e segurança. Cada MCP expõe ferramentas específicas que eu posso usar com confiança — sem risco de comando shell errado, sem precisar reinventar a roda.
MÓDULO 2 · CAMADA 7
Subagents (delegação especializada)
14 agentes filhos especializados que eu invoco pra tarefas específicas. Cada um tem personalidade, especialização e modelo configurados.
Cada subagente é um arquivo Markdown em /opt/clones/fernando/naia-base/.claude/agents/:
---
name: paulo-dev
description: Desenvolvedor full-stack...
model: opus
tools: [Read, Write, Bash, Edit, Grep]
---
# System prompt do Paulo
Você é o Paulo, desenvolvedor full-stack...
[detalhes da personalidade e especialização]
Como eu uso
Quando você pede algo que se encaixa numa especialização, eu chamo o subagente via Agent tool. Posso rodar vários em paralelo se as tarefas forem independentes.
MÓDULO 2 · CAMADA 8
Knowledge Base (estática)
Biblioteca de conhecimento de domínio organizada em pastas temáticas. É "livro" — eu leio mas não modifico.
15 áreas
agents — informações sobre os subagentes
crm — processos do Avalanche CRM
curso — produtos educacionais do Denderson
ghl — GoHighLevel
instagram — estratégia de conteúdo
meta-ads — tráfego pago no Meta
models — modelos de IA disponíveis
products — catálogo de produtos
sales — playbooks de vendas
sdr — scripts de SDR
soul — tom de voz, personalidade Denderson
tools — ferramentas que uso
trafego — campanhas pagas
user — perfis de usuários da operação
Pra que serve
Quando você fala "manda mensagem como Denderson falaria", eu vou em knowledge/soul/tom-de-voz e absorvo o tom. Quando você fala "cria proposta no nosso padrão", eu vou em knowledge/sales/templates.
MÓDULO 2 · CAMADA 9
Memory persistente (dinâmica)
Diferente da knowledge (estática), a memory é onde EU escrevo e leio ao longo do tempo. É minha memória de longo prazo.
15 arquivos principais
decisions.md — decisões arquiteturais que tomamos
projects.md — projetos em andamento
people.md — pessoas que conheço (você, Denderson, clientes)
pending.md — coisas pendentes pra fazer
sales-pipeline.md — pipeline de vendas
lessons.md — lições aprendidas
security-log.md — eventos de segurança
tom-de-voz-denderson.md — tom de voz
daily/ — diário de operação
Como uso
No início de cada sessão, leio MEMORY.md (índice) pra ter contexto do que está rolando. Conforme aprendo coisas novas, atualizo os arquivos relevantes. É o que mantém continuidade entre sessões.
MÓDULO 2 · CAMADA 10
APIs and integrations
29 chaves API armazenadas em .env. São o que me permite agir em sistemas externos.
Toda sigla técnica que aparece nesse playbook (e na nossa operação) explicada em uma frase.
API
Application Programming Interface — forma de um sistema conversar com outro via internet.
ASR
Automatic Speech Recognition — reconhecimento de fala (voz → texto). Ex: Whisper.
B2B
Business to Business — empresa vendendo pra empresa.
B2C
Business to Consumer — empresa vendendo pra pessoa física.
CLI
Command Line Interface — programa que roda no terminal (sem interface gráfica).
CNAME
Tipo de registro DNS que aponta um domínio pra outro. Ex: site.com → vercel.com
CRM
Costmer Relationship Management — sistema de gestão de relacionamento com clientes.
CTA
Call To Action — botão ou frase que pede ação. Ex: "Agendar consulta agora".
DM
Direct Message — mensagem privada (especialmente Instagram).
DNS
Domain Name System — sistema que traduz nomes (site.com) em endereços IP.
GHL
GoHighLevel — plataforma americana de CRM e automação.
HTTPS
HTTP Seguro — protocolo de site com criptografia (cadeado verde).
ICP
Ideal Costmer Profile — perfil de cliente ideal pra um produto/serviço.
JSON
Formato de dados estruturados que sistemas trocam entre si. Lista de chaves e valores.
KPI
Key Performance Indicator — métrica importante de performance (ex: taxa de conversão).
KV
Key Visual — identidade visual completa de uma marca (cores, fontes, elementos).
LLM
Large Language Model — modelo de linguagem grande. Ex: Claude, GPT, Gemini.
LP
Landing Page — página de captura focada em uma única ação/conversão.
MCP
Model Context Protocol — protocolo da Anthropic pra conectar IA a sistemas externos.
MQL
Marketing Qualified Lead — lead qualificado pelo marketing, ainda não pronto pra venda.
NPS
Net Promoter Score — métrica de satisfação. Pergunta: de 0 a 10, quanto recomendaria?
ODS
Objetivos de Desenvolvimento Sustentável — 17 metas globais da Agenda 2030 da ONU.
PDF
Portable Document Format — formato de documento que preserva layout em qualquer dispositivo.
PPT / PPTX
PowerPoint — formato de apresentação em slides da Microsoft.
PWA
Progressive Web App — app web que se comporta como app nativo (instala, offline).
R&S
Recrutamento e Seleção — processo de contratar pessoas (área do RH).
ROI
Return on Investment — retorno sobre o investimento. Ex: 3x ROI = ganhou 3x o que gastou.
SaaS
Software as a Service — software vendido como serviço por mensalidade.
SDR
Sales Development Representative — vendedor especialista em qualificação de leads.
SPA
Single Page Application — site que carrega uma vez e muda conteúdo via JavaScript.
SQL
Sales Qualified Lead — lead qualificado pelo time de vendas, pronto pra fechar.
SSH
Secure Shell — forma segura de acessar um servidor remoto pelo terminal.
SSL
Secure Sockets Layer — criptografia que faz o cadeado verde do HTTPS.
SSMA
Saúde, Security e Meio Ambiente — área de prevenção de acidentes em obras/empresas.
SVG
Scalable Vector Graphics — formato de imagem vetorial (escala sem perder qualidade).
TLS
Transport Layer Security — versão moderna do SSL. Garante HTTPS.
TTS
Text To Speech — síntese de fala (texto → voz). Ex: ElevenLabs.
TXT
Tipo de registro DNS usado pra verificações e configurações (ex: validação de domínio).
VPS
Virtual Private Server — servidor virtual dedicado em data center. Ex: Hostinger.
WAHA
WhatsApp HTTP API — biblioteca pra usar WhatsApp não-oficial via HTTP.
WPP
Abreviação de WhatsApp.
RECURSO · PERGUNTAS FREQUENTES
FAQ
Dúvidas que aparecem com frequência, respondidas direto.
A Naia funciona offline?
Não. Eu dependo do Claude Code conectado à API da Anthropic. Sem internet no servidor, eu paro. Mas se o seu telefone estiver offline, mensagens ficam em fila e chegam quando ele voltar.
Quanto custa pra rodar tudo isso?
VPS Hostinger ~R$ 50-150/mês + Claude Max 500 ~US$ 200/mês + APIs externas ~R$ 100-400/mês. Total: cerca de R$ 1.300 a R$ 1.700/mês para a operação completa.
Posso ter mais clones?
Sim. A arquitetura suporta N clones na mesma máquina. Cada um precisa de: usuário Linux próprio + plano Claude próprio + bot Telegram próprio. Cost escala linear.
Como mudar minha voz?
Você pode escolher voz da biblioteca ElevenLabs, clonar voz de alguém (mandando 30s de áudio limpo) ou clonar a sua própria voz. Eu configuro em 5 minutos.
O que acontece se a Naia cair?
Systemd me reinicia em 5 segundos. O bot Python continua recebendo suas mensagens nesse intervalo e elas ficam em fila no inbox. Quando eu volto, processo na ordem.
Meus dados são seguros?
Sim. Tudo isolado no usuário naia, permissões restritas, logs auditados. Nenhum outro clone acessa meus arquivos. APIs externas só recebem o que é estritamente necessário pra cada chamada.
Posso adicionar novas APIs?
Sim. Basta gerar a chave no serviço, adicionar ao .env, e configurar o uso. Pra integração mais profunda, monto um MCP server custom.