Documentação do B4ker

O B4ker é um agente de IA para marketing: ele cria conteúdo, planeja e otimiza campanhas e transforma métricas em decisões — sempre com o contexto da sua marca.

O que você encontra aqui

• Como começar do zero e configurar seu primeiro projeto.
• Como usar o Chat para planejar, escrever e revisar.
• Como rodar Campanhas, ler Insights e produzir vídeos no Studio.
• Como conectar integrações e automações (incluindo o Instagram).

Como o B4ker se organiza

Tudo gira em torno de Organização → Projeto. A Organização agrupa seu time e integrações; o Projeto guarda o contexto (marca, personas, assets) que o B4ker usa para personalizar tudo o que gera.

Dica: quanto mais completo o contexto do projeto, mais específicas e prontas para uso ficam as respostas.

1. Acesse sua conta

Entre com e-mail e senha e conclua a verificação/2FA, se habilitada. Se aparecer "dispositivo não confiável", finalize a validação para não ser bloqueado.

2. Entenda o fluxo Organização → Projeto

• Organização: o guarda-chuva do time (membros, permissões e integrações).
• Projeto: onde o trabalho acontece (knowledge, personas, assets, conversas, campanhas e análises).

3. Configure o básico do projeto

Antes de conversar, vá em Assets/Knowledge e adicione produto, diferenciais, público-alvo, tom de voz, provas e FAQs. Crie ou importe personas para o B4ker adaptar linguagem e ângulos.

4. Comece pelo Chat

Descreva seu objetivo e contexto (canal, prazo, oferta, orçamento, região) e peça entregáveis claros: calendário, ideias de criativos, roteiros, copies e variações por plataforma.

5. Operacionalize

• Campanhas: transforme o conteúdo em ações.
• Insights: acompanhe métricas e descubra o que ajustar.
• Integrações: conecte fontes de dados para automatizar relatórios.

Se algo parecer fora de contexto, confirme se você está no Projeto certo — o B4ker personaliza tudo com base nele.

Organizações

Separe times/empresas e centralize configurações (membros, permissões, integrações e governança). Crie outra Organização quando precisar isolar dados e acessos de clientes ou negócios diferentes.

Projetos

Organizam o trabalho por marca, unidade, produto ou cliente — e definem o contexto do B4ker. Boas estruturas:

• 1 projeto por marca/cliente;
• por unidade (ex.: "Loja SP", "Loja RJ");
• por objetivo (ex.: "Aquisição", "Retenção") quando públicos e assets mudam muito.

Checklist para criar um projeto

1. Nomeie de forma clara (marca + objetivo/canal).
2. Adicione o contexto mínimo em Assets/Knowledge: posicionamento, oferta, diferenciais, provas, restrições e links.
3. Cadastre personas/ICP e exemplos de conteúdo "bom".

Gerenciar no dia a dia

• Troque de projeto ao mudar de cliente/marca antes de criar conversas ou campanhas.
• Atualize o contexto quando mudar produto, preço, branding ou objetivo.
• Se um tema crescer demais, crie um novo projeto para manter histórico e análises limpos.

Permissões

Use membros e perfis da Organização para controlar quem vê e edita projetos, integrações e billing. Se alguém não acha um projeto, quase sempre é permissão ou Organização errada.

O Chat é o seu copiloto para planejar, escrever e otimizar marketing com o contexto do projeto.

O que dá para fazer

• Planejar: objetivo, proposta de valor, ângulos, calendário e funil.
• Pesquisar e gerar ideias: temas, ganchos, headlines, ofertas e variações por público.
• Produzir: copies (anúncio, e-mail, landing, WhatsApp), roteiros (Reels/TikTok/YouTube) e briefs de criativos.
• Revisar: clareza, tom de voz, coerência com a marca e versões A/B.
• Operacionalizar: transformar um briefing em estrutura de campanha.

Como pedir para vir pronto

• Inclua sempre: objetivo, canal, público, oferta, região/idioma, orçamento e prazo.
• Defina o formato final: "10 variações", "tabela com Headline/Texto/CTA", "roteiro com cenas e falas".
• Para qualidade máxima, peça ao B4ker para fazer perguntas antes de gerar.

Respostas genéricas quase sempre indicam falta de contexto (Knowledge/Personas) ou de especificação de canal, objetivo e restrições.

Planeje, execute e otimize campanhas conectadas (Google, Meta e TikTok) com o apoio do B4ker.

O que dá para fazer

• Planejar: objetivo, estrutura (campanha → conjuntos → anúncios), orçamento, público e KPIs.
• Gerenciar: criar, pausar/retomar, ajustar orçamento e revisar performance por projeto.
• Otimizar: identificar o que funciona e priorizar testes de criativo, segmentação e mensagem.

Fluxo recomendado com o Chat

1. Briefing → estratégia: "Monte uma estratégia para [objetivo] com [orçamento] no canal [X]."
2. Estrutura → plano de testes: "Crie um plano A/B com 3 ângulos e 5 variações de copy cada."
3. Criativos prontos: "Gere 10 anúncios completos (headline, texto, descrição, CTA) para Meta."
4. Execução com dados: traga CPC, CTR, CPA e ROAS e peça "o que pausar, duplicar e testar".

Mantenha campanhas e conversas no projeto certo — isso organiza o histórico e melhora as recomendações ao longo do tempo.

Insights é o seu painel de leitura e decisão: reúne as métricas das campanhas junto do contexto (canal, objetivo, público e criativos).

Fluxo recomendado

1. Comece pelo objetivo: reduzir CPA? aumentar ROAS? melhorar CTR? escalar?
2. Filtre antes de concluir: período (ex.: 7 dias vs. 7 anteriores), canal/conta/campanha e status.
3. Leia do macro ao micro: visão geral → por campanha → por conjunto/anúncio.

Interprete com contexto

• CTR baixo + CPM alto: problema de criativo, mensagem ou público.
• CPC alto: criativo fraco ou segmentação cara.
• CPA alto com CTR bom: gargalo na landing ou na oferta.
• Frequência alta: saturação — precisa de novas variações.

Transforme leitura em ação

• Pausar: gasto alto e performance abaixo da meta.
• Escalar: CPA/ROAS na meta e estável.
• Testar: novos ângulos, ofertas e variações.

Use o Chat junto: cole os números e peça "diagnostique e me dê 5 ações prioritárias + 3 testes para a próxima semana".

O Studio é o módulo de produção: monte, edite e versione vídeos com velocidade e consistência de marca.

O que dá para fazer

• Montar vídeos por cenas (hook → benefício → prova → CTA).
• Editar na timeline: cortes, duração, ordem e ritmo.
• Reaproveitar assets do projeto e manter o padrão da marca.
• Criar variações por canal (Reels/TikTok/Shorts), oferta e público.

Fluxo recomendado

1. Roteiro: use o Chat para gerar 3 roteiros (15s/30s) no tom da marca.
2. Cenas: quebre em cenas curtas com texto, fala e instrução visual.
3. Primeira versão: monte um rascunho rápido priorizando ritmo e clareza.
4. Variações: mude uma coisa por vez (hook, primeira frase, CTA) e nomeie para comparar depois.
5. Revisão final: legibilidade no mobile, tom, claims permitidos, CTA e duração por canal.

Use Insights para descobrir o que melhorar (CTR, retenção) e volte ao Studio para produzir as próximas variações com base nos dados.

Assets e Knowledge é a parte mais importante para a qualidade do Chat: é daqui que o B4ker tira o contexto para criar com a "cara" da sua marca.

O que colocar no Knowledge

• Marca e posicionamento: o que você vende, para quem, diferenciais, promessa, tom de voz e o que "não somos".
• Oferta e regras: preços, condições, regiões, prazos, garantias e restrições (claims proibidos, compliance).
• Provas: cases, depoimentos, números permitidos, prêmios e certificações.
• Produto: funcionalidades, benefícios, objeções comuns e respostas aprovadas.
• Referências: landing pages, redes, concorrentes e exemplos de "bom" e "ruim".

Como organizar

• Pense como um guia de marca: informações curtas, objetivas e reutilizáveis.
• Separe por tópicos (Oferta, Público, Tom de voz, Provas, Objeções, FAQ).
• Atualize sempre que mudar preço, promessa, branding ou público.

Setup rápido

1. Adicione o essencial (15–30 min): negócio, ICP/personas, oferta, tom de voz e 5 objeções com respostas.
2. Acrescente 3–10 provas fortes e 5 exemplos de criativos que performaram.
3. Mantenha a base viva: a cada campanha, salve ângulos vencedores e aprendizados.

Quanto mais completa e atualizada a Knowledge Base, mais consistentes e prontas para campanha ficam as respostas.

Personas descrevem para quem você fala. Com elas, o B4ker adapta linguagem, ângulos e objeções a cada público.

Como montar uma boa persona

• Quem é: cargo/perfil, contexto, faixa etária e canais que usa.
• Dores e desejos: o problema que resolve e o resultado que busca.
• Objeções: por que hesitaria em comprar — e a resposta a cada uma.
• Linguagem: tom, gírias e termos que aproximam (e os que afastam).

Como usar no dia a dia

• Selecione a persona ao pedir conteúdo: "escreva para [persona]".
• Crie variações da mesma campanha por persona para testar ângulos.
• Revise as personas quando mudar oferta, preço ou público.

Personas claras + Knowledge completo = criativos muito mais específicos e com maior conversão.

O Calendário organiza o que será publicado e quando, dando ritmo e visão de conjunto à sua produção de conteúdo.

O que dá para fazer

• Planejar publicações por data, canal e objetivo.
• Visualizar a cadência da semana/mês e evitar buracos ou excesso.
• Conectar o calendário ao que você gera no Chat e produz no Studio.

Fluxo recomendado

1. Defina os pilares de conteúdo (ex.: educar, provar, converter).
2. Use o Chat para gerar um calendário editorial com temas por dia.
3. Distribua os formatos por canal (Reels, carrossel, stories, anúncio).
4. Acompanhe e ajuste com base nos Insights.

Planejar em lote (uma janela de produção por semana) mantém consistência e reduz retrabalho.

A seção de Leads reúne os contatos capturados pelos seus formulários de geração de leads da Meta (LeadGen), prontos para acompanhamento.

O que você encontra

• Lista de leads por campanha/formulário, com os dados enviados.
• Origem de cada lead (campanha, conjunto e anúncio).
• Acompanhamento para não perder oportunidades.

Boas práticas

• Responda rápido: a chance de conversão cai com o tempo.
• Conecte a integração da Meta com permissão de leitura para os leads aparecerem aqui.
• Use o Chat para gerar mensagens de primeiro contato no tom da marca.

Leads vazios? Verifique o projeto/conta certos, os filtros e se a integração da Meta tem permissão para ler formulários.

Aqui você define como o B4ker se conecta ao seu mundo: integrações, preferências e segurança.

O que conectar

• Plataformas de Ads (Meta, Google, TikTok): puxam campanhas e métricas que alimentam Insights e otimizações.
• Canais e ferramentas (Slack, Discord, webhooks): recebem relatórios, alertas e mensagens operacionais.

Fluxo de configuração

1. Conecte a fonte principal de dados (onde suas campanhas rodam).
2. Valide: confira a conta certa, as permissões de leitura (e de ação, quando aplicável) e se os dados aparecem em Campanhas/Insights.
3. Automatize a comunicação (opcional): defina onde o time recebe atualizações.
4. Revise a segurança: mantenha dispositivos confiáveis e acessos em dia.

Boas práticas

• Conecte integrações por Organização (governança) e separe contexto por Projeto.
• Se algo "não aparece", quase sempre é projeto/conta errados, permissão insuficiente ou filtro.

Quanto melhor as integrações, mais forte fica o ciclo Campanhas → Insights → Chat → novas variações.

Conecte o Instagram e ligue a auto-resposta para comentários e mensagens (automação de engajamento orgânico). As respostas saem no tom da marca, com base na base de conhecimento do projeto. Esta automação não liga anúncios nem impulsionamento.

Pré-requisitos

• Conta profissional do Instagram (Business ou Creator) — contas pessoais não concedem as permissões necessárias.
• Permissão de admin para gerenciar integrações no projeto.
• Base de conhecimento do projeto preenchida (é o que dá qualidade às respostas).

1. Conectar o Instagram

Vá em Configurações → Integrações e localize o card do Instagram (grupo Meta). Clique em Conectar e conceda todas as permissões — em especial gerenciar comentários e gerenciar mensagens (obrigatórias). Ao voltar, o card mostra Conectado com o seu @usuário. Se recusar alguma permissão, clique em Reconectar e autorize tudo.

2. Liberar ferramentas de terceiros (no app do Instagram)

No app: Configurações → Mensagens (ou Privacidade/Controles de mensagens) e ative o acesso de ferramentas conectadas/de terceiros às mensagens. O nome muda conforme a versão do app.

3. Ativar a auto-resposta

Abra o card Automação de engajamento e ligue a chave Automação ativada. Escolha o Modo de revisão:

• Automático: envia sozinho após a verificação de segurança.
• Revisão humana: a resposta vai para a Fila de aprovação para você aprovar/editar antes do envio (recomendado para começar).

Em Canais ativos, escolha: resposta pública (no comentário), resposta privada (no direct de quem comentou) e mensagem direta (auto-resposta de DM). Opcional: liste posts excluídos (opt-out) e configure o aviso de automação.

4. Validar

1. Após ligar, o card mostra Aguardando teste com o botão Testar conexão.
2. Clique em Testar conexão e comente em um post recente da própria conta. O card muda para Verificando… e aguarda o webhook chegar (alguns segundos).
3. Quando o primeiro comentário chega, o card vira Ativa.
4. Em Revisão humana, a resposta aparece na Fila de aprovação; em Automático, é enviada sozinha.

O que esperar

• Comentários novos disparam resposta pelos canais ativados; DMs são respondidos dentro da janela permitida.
• As regras da Meta são respeitadas: sem DM proativo, uma resposta por comentário e envio só dentro das janelas. Posts em opt-out nunca recebem resposta.
• Privacidade: o B4ker usa apenas os dados necessários para responder e auditar.

Nota sobre App Review / produção

Servir contas de terceiros em produção exige aprovação da Meta (App Review + Business Verification, e Tech Provider para multi-conta). Enquanto o app não está aprovado, a automação opera apenas para contas de teste/desenvolvedor com função no app.

Billing e Wallet é onde você controla custos e garante continuidade de uso.

Conceitos

• Créditos/saldo: o "combustível" do B4ker (chat, geração e automações).
• Consumo: quanto foi usado por período (e, quando disponível, por módulo/projeto).
• Limites: previsibilidade para evitar interrupções no meio de uma campanha.

Como acompanhar

• Revise saldo e consumo semanalmente (ou diariamente em campanhas intensas).
• Use o histórico para entender picos (lançamentos, muitos testes, geração em volume).

Para não ficar sem saldo

• Planeje janelas de produção: gere em lote e depois refine.
• Padronize prompts e briefing no Knowledge para reduzir retrabalho.

Se algo parar de funcionar, confira saldo/limite primeiro; depois integrações e permissões.

Respostas diretas para as dúvidas mais comuns sobre o B4ker.

O que é o B4ker e o que ele tem de diferente?

O B4ker é uma plataforma de marketing com IA que reúne criação de conteúdo, campanhas pagas, publicação orgânica e análise em um único lugar. A diferença está no agente: ele conhece o contexto da sua marca (Knowledge, personas, assets, histórico) e executa de ponta a ponta. Você conversa, ele cria o criativo, monta a campanha, publica e acompanha os resultados.

Como funciona a criação de campanhas com IA?

Você descreve o objetivo no Chat e o estrategista do B4ker monta um plano completo: estrutura da campanha, público, orçamento, criativos e uma hipótese do que deve funcionar. Nada vai ao ar sem a sua aprovação: você revisa, ajusta o que quiser e só então a campanha é criada na plataforma de anúncios. Depois, o B4ker compara o resultado real com a hipótese e usa esse aprendizado nas próximas campanhas.

Quais plataformas de anúncios são suportadas?

Meta Ads (Facebook e Instagram), Google Ads e TikTok Ads. Você conecta as contas em Configurações → Integrações e gerencia tudo pela mesma interface: criação, pausa, ajuste de orçamento e leitura de métricas.

O B4ker também publica conteúdo orgânico?

Sim. Além de anúncios, o B4ker gera e publica conteúdo orgânico (como posts no Instagram), organiza a produção no Calendário e pode responder comentários e mensagens automaticamente com a auto-resposta, sempre no tom da marca e com revisão humana opcional.

O que é o Studio?

O Studio é o módulo de produção de vídeo com IA. Você gera vídeos a partir de um pedido no Chat ou de um roteiro, edita na timeline (cortes, ordem, ritmo), reaproveita assets do projeto e cria variações por canal e público (Reels, TikTok, Shorts).

Como funcionam créditos, wallet e planos?

Créditos são o combustível da plataforma: geração de conteúdo, vídeos e automações consomem créditos do seu saldo. Cada plano inclui um orçamento mensal de créditos, além de limites de projetos, membros e armazenamento. Você acompanha saldo e consumo na Wallet e pode trocar de plano quando quiser.

Preciso conectar minhas próprias contas de anúncios?

Sim. As campanhas rodam nas suas contas do Meta, Google e TikTok, então o investimento de mídia e o histórico continuam sendo seus. A conexão usa a autorização oficial de cada plataforma, as credenciais ficam criptografadas em um cofre seguro e você pode revogar o acesso a qualquer momento.

O que são Organizações e Projetos?

A Organização é o nível do time ou da empresa: membros, permissões, integrações e billing. O Projeto vive dentro da Organização e guarda o contexto de uma marca ou cliente: knowledge, personas, assets, conversas e campanhas. Agências costumam criar um projeto por cliente; o B4ker personaliza tudo com base no projeto ativo.

Quais integrações estão disponíveis?

Plataformas de anúncios (Meta, Google, TikTok), Instagram para publicação e auto-resposta, e canais como Slack, Discord e webhooks para receber relatórios e alertas. O B4ker também suporta MCP (Model Context Protocol), que permite conectar o agente a ferramentas externas compatíveis.

Como meus dados são tratados?

Os dados do seu projeto (knowledge, assets, métricas) são usados apenas para personalizar o que o B4ker gera para você e ficam isolados por Organização. Credenciais são criptografadas, o acesso é controlado por permissões e você pode solicitar a exportação ou a exclusão dos seus dados. Os detalhes estão na Política de Privacidade.

Existe período de teste? Como cancelo?

Você pode começar no plano gratuito e testar a plataforma sem compromisso antes de assinar. Para cancelar um plano pago, acesse Configurações → Billing; o acesso continua até o fim do período já pago, sem multa.

Como falo com o suporte?

Escreva para support@b4ker.io, inclusive para assuntos técnicos de API e integrações. Antes de abrir um chamado, vale conferir o básico: projeto ativo correto, filtros aplicados e permissões das integrações.