MCP: Marketing

Herramientas de esta área, generadas del código del servidor. Las descripciones vienen de ese código, en portugués. Para conectar, mira el MCP de XBASE.

distribution_get_overviewCopy Anchor Link

Visão geral da Distribuição (XBASE → Marketing → Distribuição): estratégias e canais ativos, parceiros ativos e em negociação, indicadores do período (registro manual), ações pendentes, acordos vencendo em 30 dias, aprovações pendentes e conflitos entre regras. empty = nada cadastrado ainda.

distribution_get_resultsCopy Anchor Link

Indicadores da Distribuição (XBASE → Marketing → Distribuição → Resultados) no período (padrão: mês atual): oportunidades, vendas, conversão, receita vendida e recebida, custos, comissões previstas e pagas, ticket médio, margem (só com custo registrado), metas, comparação por canal e por parceiro. null = ainda não registrado; 0 = registrado e soma zero. Origem: registro manual. withRecords=true traz também os registros (até 500).

distribution_list_channelsCopy Anchor Link

Canais de venda e distribuição (XBASE → Marketing → Distribuição → Canais): site, loja, WhatsApp, marketplace, revenda, representante, afiliados, indicação, redes e influenciadores, com papéis, custos, capacidade e status. Não são as contas conectadas (marketing_list_channels); um canal pode apontar para uma (connectionId). Com channelId devolve o detalhe com estratégias, parceiros, regras, ações e resultados.

distribution_list_partnersCopy Anchor Link

Parceiros (XBASE → Marketing → Distribuição → Parceiros): indicadores, afiliados, revendas, distribuidores, estratégicos, entrega e influenciadores, com etapa do funil, contatos, remuneração e a situação dela (termsStatus), vigência e perfis sociais. type=INFLUENCER e network filtram influenciadores. affiliateStatus diz se o parceiro está ligado ao programa de afiliados da XBASE (LINKED), convidado (INVITED) ou não (null); convidar e ligar só pela tela, por uma pessoa. Com partnerId devolve o detalhe com estratégias, canais, regras, ações, resultados e o bloco affiliate (nome mascarado de quem aceitou, links, status do recebimento, contagem da rede e comissões do programa, que não são resultados da Distribuição).

distribution_list_rulesCopy Anchor Link

Regras comerciais documentadas (XBASE → Marketing → Distribuição → Regras), cada uma com o resumo em linguagem natural, abrangência, vigência e status, mais conflicts: pares de regras que valem ao mesmo tempo para o mesmo alvo com condições diferentes (nunca resolvidos sozinhos).

distribution_list_strategiesCopy Anchor Link

Estratégias de distribuição (XBASE → Marketing → Distribuição → Estratégias): o que vende, para quem, onde, modelo (direto, indireto, híbrido), canais, parceiros, metas e status. Com strategyId devolve o detalhe com canais, parceiros, regras, ações e resultados. As arquivadas só com archived=true.

distribution_record_resultCopy Anchor Link

Registra um resultado à mão (XBASE → Marketing → Distribuição → Resultados → Registrar): OPPORTUNITY, SALE, RECEIPT, COST ou COMMISSION. amountBrl é obrigatório fora de OPPORTUNITY. channelId é o canal principal (a venda conta uma vez, nele); assistChannelIds são os de apoio. Venda com parceiro devolve commissionSuggestion (valor pelas regras ativas e pela remuneração aprovada) ou commissionReview (o motivo de não sugerir): para registrar a comissão, chame de novo com kind COMMISSION, saleId e o valor. A comissão nasce FORECAST; aprovar ou marcar paga é só na tela. Grava só com token MCP pessoal (xmcp_); conexão de agente só lê.

distribution_upsert_channelCopy Anchor Link

Cria ou edita um canal de venda (XBASE → Marketing → Distribuição → Canais). Sem channelId cria (name, type e roles obrigatórios; nasce PREPARING); com channelId edita só os campos enviados. roles: PROMOTION (divulga), LEADS (gera oportunidades), SALES (vende), DELIVERY (entrega). commercialTerms é texto livre; as regras formais vão em distribution_upsert_rule. Grava só com token MCP pessoal (xmcp_); conexão de agente só lê.

distribution_upsert_partnerCopy Anchor Link

Cadastra ou edita um parceiro ou influenciador (XBASE → Marketing → Distribuição → Parceiros). Sem partnerId cria (name e type obrigatórios; nasce PROSPECTED); com partnerId edita só os campos enviados. Mover no funil = stage. A remuneração não é aprovada aqui: termsStatus aceita DRAFT ou PENDING_APPROVAL, e mudar a remuneração de uma condição aprovada a devolve para aprovação. Seguidores e engajamento são digitados (a leitura automática ainda não existe). Contratos e materiais (arquivos) só pela tela. Grava só com token MCP pessoal (xmcp_); conexão de agente só lê.

distribution_upsert_ruleCopy Anchor Link

Cria ou edita uma regra documentada (XBASE → Marketing → Distribuição → Regras). Não aprova: regra de preço, comissão, pagamento ou exclusividade enviada como ACTIVE fica PENDING_APPROVAL até alguém com a permissão aprovar na tela. Sem ruleId cria (name, category e scopeType obrigatórios; scopeId para STRATEGY, CHANNEL ou PARTNER). params por categoria: COMMISSION { model: FIXED|PERCENT|RECURRING, value, base: GROSS_SALE|NET_SALE|RECEIVED|MARGIN, installments? }; PRICING { maxDiscountPct?, approvalAbovePct?, minPriceBrl? }; ATTRIBUTION { criteria: LAST_CONTACT|FIRST_CONTACT|COUPON|TRACKING_LINK|CUSTOMER_DECLARED, windowDays }; PAYMENT { daysAfter, base: SALE_DATE|RECEIPT_DATE|MONTH_CLOSE, refundPolicy }; SERVICE_LEVEL { responseHours? }; PRODUCTS_TERRITORY { productIds, regions }; EXCLUSIVITY { condition }; as demais {} (o texto vai em description). Só regra documentada: a automática ainda não existe. Grava só com token MCP pessoal (xmcp_); conexão de agente só lê.

distribution_upsert_strategyCopy Anchor Link

Cria ou edita uma estratégia de distribuição (XBASE → Marketing → Distribuição → Estratégias). Sem strategyId cria (só name é obrigatório; nasce rascunho); com strategyId edita só os campos enviados (listas trocam inteiras). Para sair do rascunho precisa de produto (productIds ou productsNote), objetivo, modelo e um canal: o erro lista o que falta. Pausar = status PAUSED. Só registra o plano. Grava só com token MCP pessoal (xmcp_); conexão de agente só lê.

marketing_add_referenceCopy Anchor Link

Adiciona uma referência por link (XBASE → Marketing → Identidade visual → Referências). kind: INSPIRATION, COMPETITOR, APPROVED_CREATIVE ou BRAND_ASSET. Arquivo (imagem ou PDF) só pela tela.

marketing_create_actionCopy Anchor Link

Cria uma ação de marketing (XBASE → Marketing → Ações → Nova ação), solta ou num projeto. kind: CONTENT, AD, MESSAGE, EMAIL, EVENT, TASK ou DECISION. links liga a ação à produção do Estúdio, à publicação agendada, à campanha ou a uma URL. Com distributionStrategyId/ChannelId/PartnerId entra no plano de ação da Distribuição (prioridade, verba, custo e checklist). Anexos só pela tela. Só registra: não publica nem envia nada.

marketing_create_projectCopy Anchor Link

Cria um projeto de marketing (XBASE → Marketing → Projetos → Novo projeto). kind: ALWAYS_ON (sempre ligado), SEASONAL (data comemorativa), LAUNCH (lançamento) ou INSTITUTIONAL. Ligue adCampaignIds e crmTags para o projeto ter números. Só registra o plano: não cria campanha nem publica.

marketing_get_audienceCopy Anchor Link

Público do workspace (XBASE → Marketing → Público): personas completas (dores, desejos, objeções, gatilhos, palavras que usam), público-alvo dos anúncios (idade, regiões, empresas ou consumidor, segmentos, cidades) e os termos-chave do início dos anúncios com o status de cada um. Só leitura.

marketing_get_identityCopy Anchor Link

Identidade visual do workspace (XBASE → Marketing → Identidade visual): frase, logos, paleta, fontes e tom de voz (faça/não faça), mais a marca do Estúdio (nome, @, cores, logo, CTA) e as regras (claims proibidos e diretrizes). Só leitura.

marketing_get_projectCopy Anchor Link

Um projeto de marketing com as ações e os números do período (XBASE → Marketing → Projetos → projeto): mídia das campanhas ligadas (investimento, impressões, cliques, conversões da plataforma, conversas vindas de anúncio), CRM das etiquetas (conversas, qualificados, vendas), CPL, receita estimada (vendas × ticket médio), ROAS e cada KPI com real, meta e progresso. Padrão do período: desde o início do projeto (ou 30 dias) até hoje.

marketing_get_strategyCopy Anchor Link

Estratégia de marketing do workspace (XBASE → Marketing → Estratégia): posicionamento, mensagem central, diferenciais, provas reais, ofertas (código, mecânica, status, validade), sazonalidade (épocas do ano), metas do negócio (ticket médio, margem, CPL e ROAS alvo) e as linhas editoriais completas. Só leitura.

marketing_import_productsCopy Anchor Link

Importa produtos de fora (XBASE → Marketing → Produtos → Adicionar por link / Importar feed). source page: lê a página do produto (og:title, og:image, preço do Open Graph) e cria ou atualiza o produto desse link. source feed: baixa o feed da loja (JSON ou CSV, até 5 MB e 2.000 itens) e atualiza por id ou link; devolve created, updated, skipped e os erros. Só https de site público; o link não pode redirecionar.

marketing_list_actionsCopy Anchor Link

Ações de marketing (XBASE → Marketing → Ações): conteúdos, anúncios, mensagens, e-mails, eventos, tarefas e decisões, por prazo (sem prazo por último), até 500. Filtros por projeto, status, responsável e prazo; distribution=true traz só o plano de ação da Distribuição (ou filtre pela estratégia, canal ou parceiro).

marketing_list_channelsCopy Anchor Link

Canais e perfis do workspace (XBASE → Marketing → Canais e perfis): Instagram, Página do Facebook, WhatsApp, TikTok, YouTube e contas de anúncio, cada um com status, saúde (ok, aviso ou erro e o motivo), agente vinculado, projetos que usam o canal e a tela para gerenciar. O id é o que vai em channelIds do projeto. Só leitura.

marketing_list_productsCopy Anchor Link

Catálogo de produtos do workspace (XBASE → Marketing → Produtos): nome, link, foto, preço de referência e quando foi lido, categoria, etiquetas e status, por nome (até 500). Traz também o último feed importado (feed). Os projetos ligam produtos por productIds.

marketing_list_projectsCopy Anchor Link

Projetos de marketing (XBASE → Marketing → Projetos): campanhas e iniciativas com tipo, status, período, objetivo, KPIs, verba, público e o que cada um liga (campanhas de anúncio, etiquetas do CRM, canais, linhas). Ativos primeiro. Números do período: marketing_get_project.

marketing_list_referencesCopy Anchor Link

Referências visuais (XBASE → Marketing → Identidade visual → Referências): inspirações, concorrentes, criativos aprovados e ativos da marca, com link e/ou arquivo, etiquetas, notas e projeto. As mais novas primeiro (até 500).

marketing_update_actionCopy Anchor Link

Edita uma ação de marketing (XBASE → Marketing → Ações): só os campos enviados mudam. status DONE marca como feita (guarda quando); sair de DONE reabre.

marketing_update_audienceCopy Anchor Link

Atualiza o público-alvo e os termos-chave (XBASE → Marketing → Público → Público-alvo e Termos-chave). targeting: só os campos enviados mudam (listas trocam inteiras). hookTerms: termo com id é editado, sem id é novo; removeHookTermIds remove; os outros ficam. Até 100 termos; o texto não repete. Não mexe em campanhas na Meta.

marketing_update_editorial_linesCopy Anchor Link

Cria, edita ou remove linhas editoriais (XBASE → Marketing → Estratégia → Linhas editoriais). Linha com id é editada (só os campos enviados); sem id é nova; removeIds remove. As outras ficam como estão. Até 50 linhas; o nome não repete. O Estúdio usa a linha no roteiro (objetivo, estrutura, tom, regras do início e do CTA).

marketing_update_identityCopy Anchor Link

Atualiza o guia visual e o tom (XBASE → Marketing → Identidade visual). Só os campos enviados mudam; listas (logos, paleta, fontes, faça/não faça) trocam inteiras, então mande a lista completa (leia antes com marketing_get_identity). A marca e as regras do Estúdio não mudam aqui.

marketing_update_personasCopy Anchor Link

Cria, edita ou remove personas (XBASE → Marketing → Público → Personas). Persona com id é editada (só os campos enviados); sem id é nova; removeIds remove (e tira a persona das linhas que a usavam). As outras ficam como estão. Até 20 personas; o nome não repete. O Estúdio usa as personas no roteiro.

marketing_update_projectCopy Anchor Link

Edita um projeto de marketing (XBASE → Marketing → Projetos → projeto → Editar): só os campos enviados mudam; listas e objetos (KPIs, verba, público, campanhas, etiquetas) trocam inteiros. Para encerrar, use status DONE ou CANCELED.

marketing_update_strategyCopy Anchor Link

Atualiza a estratégia (XBASE → Marketing → Estratégia). Só os campos enviados mudam; listas (diferenciais, provas, ofertas, sazonalidade) trocam inteiras, então mande a lista completa (leia antes com marketing_get_strategy). Provas são só fatos reais (certificado, garantia, loja, história). goals grava as metas do negócio (aba Metas), que também valem para Anúncios. Não publica nem gasta nada.

marketing_upsert_productCopy Anchor Link

Cadastra ou edita um produto do catálogo (XBASE → Marketing → Produtos). Sem productId cria (name e url obrigatórios; o link é único no workspace); com productId edita só os campos enviados. Para arquivar, status ARCHIVED. Para ler a página ou o feed da loja, use marketing_import_products.