Aplicar mudanças do site (GraphQL/MCP) — referência da IA

Atualizado em 15 jun 2026

Referência técnica para a IA do Insider e integrações aplicarem mudanças no site (não só dizer onde clicar). Liga o pedido do cliente à ferramenta (mutation) e à variável exata que faz a mudança.

Dois caminhos (sempre ofereça os dois): a IA pode fazer pra o usuário (a ferramenta da coluna "IA faz") OU o usuário faz sozinho (coluna "Você faz" = link "clique aqui" da tela). Quando NÃO houver ferramenta, ofereça só o link + os passos.

Como a IA aplica uma mudança

Ler o estado atual com a tool q_siteSettings (retorna colors/seo/behavior/models/contact/legal/media/company).
Escrever chamando a tool da mutation correspondente. Toda mutation recebe um único argumento input (objeto). Ex.: m_updateSiteColors(input: { cor2: "#1a73e8" }).
Forçar atualização (opcional) com m_purgeSiteCache — Depois de escrever, o site tem cache de alguns minutos; pode forçar a atualização com m_purgeSiteCache.

Importante: as tools rodam no /internal/graphql MCP do Insider (tools q_/m_); a execução é re-autenticada com o JWT do usuário e escopada pelo codsite automaticamente. Não é preciso passar codsite no input — ele é resolvido pela sessão. Cada escrita respeita a permissão do usuário (ex.: canEditSiteSettings).

Pedido do cliente → IA faz / Você faz

O que o cliente quer mudar	IA faz (ferramenta)	Variável (em `input`)	Você faz (link)
Topo	`m_updateSiteColors`	`input.cor1`	clique aqui
Botão	`m_updateSiteColors`	`input.cor2`	clique aqui
Fundo do rodapé	`m_updateSiteColors`	`input.cor3`	clique aqui
Fundo	`m_updateSiteColors`	`input.cor5`	clique aqui
Fundo do rodapé 2	`m_updateSiteColors`	`input.cor6`	clique aqui
Letras do rodapé	`m_updateSiteColors`	`input.cor7`	clique aqui
Hover do card	`m_updateSiteColors`	`input.cor8`	clique aqui
Letra hover do card	`m_updateSiteColors`	`input.cor9`	clique aqui
Fundo do menu	`m_updateSiteColors`	`input.cor10`	clique aqui
Letra em fundo claro	`m_updateSiteColors`	`input.cor11`	clique aqui
Fundo da busca	`m_updateSiteColors`	`input.cor12`	clique aqui
Letra em fundo escuro	`m_updateSiteColors`	`input.cor13`	clique aqui
Fundo depoimentos/blog	`m_updateSiteColors`	`input.cor15`	clique aqui
Título da página	`m_updateSiteSEO`	`input.tituloPagina`	clique aqui
Meta keywords	`m_updateSiteSEO`	`input.metaKeywords`	clique aqui
Meta description	`m_updateSiteSEO`	`input.metaDescription`	clique aqui
Frase H1	`m_updateSiteSEO`	`input.fraseBuscaH1`	clique aqui
Frase H2	`m_updateSiteSEO`	`input.fraseBuscaH2`	clique aqui
Montar título do imóvel automaticamente	`m_updateSiteBehavior`	`input.tituloAutomatico`	clique aqui
E-mail da empresa	`m_updateSiteContact`	`input.email`	clique aqui
Link do WhatsApp	`m_updateSiteContact`	`input.whatsappLink`	clique aqui
Mensagem padrão do WhatsApp	`m_updateSiteContact`	`input.whatsappText`	clique aqui
Texto do rodapé	`m_updateSiteLegal`	`input.rodapeTexto`	clique aqui
HTML do rodapé	`m_updateSiteCrmConfig`	`input.htmlRodape`	clique aqui
Política de privacidade	`m_updateSiteLegal`	`input.politicaPrivacidade`	clique aqui
Termos de uso	`m_updateSiteLegal`	`input.termosUso`	clique aqui
Logo	`m_updateSiteMedia`	`input.logoUrl`	clique aqui
Tamanho do logo	`m_updateSiteMedia`	`input.tamanhoLogo`	clique aqui
Favicon	`m_updateSiteMedia`	`input.faviconUrl`	clique aqui
Vídeo	`m_updateSiteMedia`	`input.videoUrl`	clique aqui
Barra de navegação transparente na home	`m_updateSiteBehavior`	`input.navbarTransparente`	clique aqui
Mostrar mapa na página do imóvel	`m_updateSiteBehavior`	`input.mostrarMapa`	clique aqui
Ocultar endereço completo no card	`m_updateSiteBehavior`	`input.ocultarEndereco`	clique aqui
Mostrar endereço do imóvel	`m_updateSiteBehavior`	`input.exibirEndereco`	clique aqui
Mostrar seção de empreendimentos	`m_updateSiteBehavior`	`input.exibirEmpreendimento`	clique aqui
Exibir simulador de financiamento	`m_updateSiteBehavior`	`input.exibirSimulador`	clique aqui
Mostrar corretores no site	`m_updateSiteBehavior`	`input.mostrarCorretores`	clique aqui
Mostrar redes sociais no topo	`m_updateSiteBehavior`	`input.mostrarRedesTopo`	clique aqui
Mostrar depoimento na página do imóvel	`m_updateSiteBehavior`	`input.mostrarDepoimentoImovel`	clique aqui
Exibir redes sociais	`m_updateSiteModels`	`input.exibirRedesSociais`	clique aqui
Ativar tags de busca na home	`m_updateSiteBehavior`	`input.cardsBusca`	clique aqui
Modelo de busca	`m_updateSiteModels`	`input.modeloBusca`	clique aqui
Modelo de card	`m_updateSiteModels`	`input.modeloCard`	clique aqui
Modelo de depoimento	`m_updateSiteModels`	`input.modeloDepoimento`	clique aqui
Modelo da página do imóvel	`m_updateSiteModels`	`input.modeloPaginaImovel`	clique aqui
Modelo de ícones	`m_updateSiteModels`	`input.modeloSelection`	clique aqui
Modelo do rodapé	`m_updateSiteModels`	`input.rodapeModelo`	clique aqui
Nome fantasia	`m_updateCompanyInfo`	`input.nomeFantasia`	clique aqui
Razão social	`m_updateCompanyInfo`	`input.razaoSocial`	clique aqui
CRECI	`m_updateCompanyInfo`	`input.creci`	clique aqui
Endereço	`m_updateCompanyInfo`	`input.endereco`	clique aqui
Horário	`m_updateCompanyInfo`	`input.horario`	clique aqui
E-mail 1	`m_updateCompanyInfo`	`input.email1`	clique aqui
Telefone 1	`m_updateCompanyInfo`	`input.tel1`	clique aqui
Nome do telefone 1	`m_updateCompanyInfo`	`input.tel1Nome`	clique aqui
Instagram	`m_updateCompanyInfo`	`input.instagram`	clique aqui
Facebook	`m_updateCompanyInfo`	`input.facebook`	clique aqui
YouTube	`m_updateCompanyInfo`	`input.youtube`	clique aqui
TikTok	`m_updateCompanyInfo`	`input.tiktok`	clique aqui
Link do Google Maps	`m_updateCompanyInfo`	`input.urlMaps`	clique aqui
Mostrar descrição cidade/bairro no imóvel	`m_updateSiteBehavior`	`input.mostrarCidadeBairro`	clique aqui
Formulário de contato via WhatsApp	`m_updateSiteBehavior`	`input.formularioWhats`	clique aqui
Pedir país no cadastro de telefone	`m_updateSiteBehavior`	`input.selecionarPaisTelefone`	clique aqui
Corretor afiliado permanece em todos os imóveis	`m_updateSiteBehavior`	`input.afiliadoTodoSite`	clique aqui
Desativar cookie de afiliado	`m_updateSiteBehavior`	`input.desativarAfiliado`	clique aqui
Mostrar agenciador na página do imóvel	`m_updateSiteBehavior`	`input.brokerHunter`	clique aqui
Mostrar visualização do imóvel	`m_updateSiteBehavior`	`input.mostrarVisualizacao`	clique aqui
Exigir cadastro do visitante para ver fotos	`m_updateSiteBehavior`	`input.solicitarCadastroFotos`	clique aqui
Liberar quantas fotos antes de bloquear?	`m_updateSiteBehavior`	`input.qtdFotosBloqueio`	clique aqui
Não exigir cadastro para fotos de imóveis de ALUGUEL	`m_updateSiteBehavior`	`input.naoBloquearFotosAluguel`	clique aqui

Variáveis por ferramenta

`m_updateSiteColors` (mutation `updateSiteColors`)

Permissão necessária: canEditSiteSettings.

Variável (em `input`)	Muda	Coluna no banco
`cor1`	Topo	`CorSite`
`cor2`	Botão	`CorSite2`
`cor3`	Fundo do rodapé	`CorSite3`
`cor5`	Fundo	`CorSite5`
`cor6`	Fundo do rodapé 2	`CorSite6`
`cor7`	Letras do rodapé	`CorSite7`
`cor8`	Hover do card	`CorSite8`
`cor9`	Letra hover do card	`CorSite9`
`cor10`	Fundo do menu	`CorSite10`
`cor11`	Letra em fundo claro	`CorSite11`
`cor12`	Fundo da busca	`CorSite12`
`cor13`	Letra em fundo escuro	`CorSite13`
`cor15`	Fundo depoimentos/blog	`CorSite15`

`m_updateSiteSEO` (mutation `updateSiteSEO`)

Permissão necessária: canEditSiteSettings.

Variável (em `input`)	Muda	Coluna no banco
`tituloPagina`	Título da página	`TituloPagina`
`metaKeywords`	Meta keywords	`Metakeywords`
`metaDescription`	Meta description	`Metadescription`
`fraseBuscaH1`	Frase H1	`FraseBusca`
`fraseBuscaH2`	Frase H2	`FraseBusca2`

`m_updateSiteContact` (mutation `updateSiteContact`)

Permissão necessária: canEditSiteSettings.

Variável (em `input`)	Muda	Coluna no banco
`email`	E-mail da empresa	`email`
`whatsappLink`	Link do WhatsApp	`link_whats`
`whatsappText`	Mensagem padrão do WhatsApp	`texto_whats`

`m_updateSiteLegal` (mutation `updateSiteLegal`)

Permissão necessária: canEditSiteSettings.

Variável (em `input`)	Muda	Coluna no banco
`rodapeTexto`	Texto do rodapé	`texto_rodape`
`politicaPrivacidade`	Política de privacidade	`Privacidade`
`termosUso`	Termos de uso	`termoUso`

`m_updateSiteMedia` (mutation `updateSiteMedia`)

Permissão necessária: canEditSiteContent.

Variável (em `input`)	Muda	Coluna no banco
`logoUrl`	Logo	`url_logo`
`faviconUrl`	Favicon	`url_favicon`
`videoUrl`	Vídeo	`url_video`
`tamanhoLogo`	Tamanho do logo	`tamanho_logo`

`m_updateSiteModels` (mutation `updateSiteModels`)

Permissão necessária: canEditSiteSettings.

Variável (em `input`)	Muda	Coluna no banco
`modeloBusca`	Modelo de busca	`modelo_busca`
`modeloSelection`	Modelo de ícones	`modelo_selection`
`modeloCard`	Modelo de card	`modelo_card`
`modeloDepoimento`	Modelo de depoimento	`modelo_depoimento`
`modeloPaginaImovel`	Modelo da página do imóvel	`modelo_pagina_imovel`
`rodapeModelo`	Modelo do rodapé	`rodape`
`exibirRedesSociais`	Exibir redes sociais	`exibe_redes_sociais`

`m_updateSiteBehavior` (mutation `updateSiteBehavior`)

Permissão necessária: canEditSiteSettings.

Variável (em `input`)	Muda	Coluna no banco
`mostrarMapa`	Mostrar mapa na página do imóvel	`mostrar_mapa`
`exibirSimulador`	Exibir simulador de financiamento	`simulador`
`navbarTransparente`	Barra de navegação transparente na home	`navbar_transparente`
`ocultarEndereco`	Ocultar endereço completo no card	`ocultar_endereco`
`exibirEndereco`	Mostrar endereço do imóvel	`ExibirEndereco`
`mostrarCorretores`	Mostrar corretores no site	`mostrarCorretores`
`mostrarRedesTopo`	Mostrar redes sociais no topo	`redes_topo`
`mostrarDepoimentoImovel`	Mostrar depoimento na página do imóvel	`depoimento_imovel`
`mostrarCidadeBairro`	Mostrar descrição cidade/bairro no imóvel	`exibir_cidade_bairro_no_imovel`
`exibirEmpreendimento`	Mostrar seção de empreendimentos	`exibir_empreendimento`
`formularioWhats`	Formulário de contato via WhatsApp	`formulario_whats`
`selecionarPaisTelefone`	Pedir país no cadastro de telefone	`internacional`
`brokerHunter`	Mostrar agenciador na página do imóvel	`BrokerHunter`
`desativarAfiliado`	Desativar cookie de afiliado	`desativarAfiliado`
`mostrarVisualizacao`	Mostrar visualização do imóvel	`MostrarVisualizacao`
`afiliadoTodoSite`	Corretor afiliado permanece em todos os imóveis	`afiliado_todo_site`
`cardsBusca`	Ativar tags de busca na home	`cards_busca`
`tituloAutomatico`	Montar título do imóvel automaticamente	`titulo_automatico`
`solicitarCadastroFotos`	Exigir cadastro do visitante para ver fotos	`SolicitarCadastroFotos`
`qtdFotosBloqueio`	Liberar quantas fotos antes de bloquear?	`QtdFotosBloqueio`
`naoBloquearFotosAluguel`	Não exigir cadastro para fotos de imóveis de ALUGUEL	`naoBloqFotosAlug`

`m_updateSiteCrmConfig` (mutation `updateSiteCrmConfig`)

Permissão necessária: canEditSiteSettings.

Variável (em `input`)	Muda	Coluna no banco
`htmlRodape`	HTML do rodapé	`html_rodape`

`m_updateCompanyInfo` (mutation `updateCompanyInfo`)

Permissão necessária: canEditSiteSettings.

Variável (em `input`)	Muda	Coluna no banco
`razaoSocial`	Razão social	`Empresa`
`nomeFantasia`	Nome fantasia	`NomeFantasia`
`creci`	CRECI	`Creci`
`endereco`	Endereço	`Endereco`
`horario`	Horário	`Horario`
`email1`	E-mail 1	`Email1`
`tel1`	Telefone 1	`Tel_1`
`tel1Nome`	Nome do telefone 1	`Tel_1_nome`
`instagram`	Instagram	`instagram`
`facebook`	Facebook	`Facebook`
`youtube`	YouTube	`Youtube`
`tiktok`	TikTok	`tiktok`
`urlMaps`	Link do Google Maps	`url_maps`

Exemplos (IA faz / Você faz)

"deixa o botão do site azul" → IA: m_updateSiteColors(input: { cor2: "#1a73e8" }) · Você: clique aqui.
"muda o título que aparece no Google" → IA: m_updateSiteSEO(input: { tituloPagina: "..." }) · Você: clique aqui.
"corrige o telefone do site" → IA: m_updateCompanyInfo(input: { tel1: "(51) ..." }) · Você: clique aqui.
"tira o mapa da página do imóvel" → IA: m_updateSiteBehavior(input: { mostrarMapa: false }) · Você: clique aqui.
"quero fazer um post no blog" → NÃO há ferramenta: oriente com o link clique aqui + os passos (não diga que você faz).

O que a IA NÃO escreve direto

Estes itens NÃO têm tool de escrita exposta ao Insider (a IA orienta o usuário a editar pela tela própria): banners, carrosséis, carrossel de banner, tags de busca, depoimentos, Nossa Empresa, vídeos do YouTube, páginas/menu, marca d'água, equipe/corretores, e as integrações Pixel/Analytics/Tag Manager. O logo_horizontal não é editável.

Nesses casos, a IA deve orientar o usuário com o caminho do CRM (ver o mapa "onde mudar cada coisa do site").