Documentação Técnica — App Local Bitrix24 + Embed Notion (RESOLVIDO)

Registro técnico verificado por execução real (navegador logado + curl no CDN + documentação oficial Bitrix24/Notion + inspeção de bundles). Status: RESOLVIDO, FUNCIONANDO, LIMPO, TEMA CONSISTENTE — 27/07/2026.

Resultado final

O app 273 (application 1695) aparece no menu esquerdo do Bitrix (indufix.bitrix24.com.br) e renderiza esta base do Notion via kb.indufix.com.br/ebd/, com:

Tema CLARO fixo (não varia mais com o navegador).
Barra do Notion 100% limpa: só a lupa de busca.
Sem o botão "Get Notion free" e sem o menu "…".

Arquitetura (por que "Estático" e não "Servidor")

App Local Estático: um ZIP com um único index.html na raiz. O Bitrix hospeda em cdn.bitrix24.com.br/b<PORTAL>/app_local/<hash>/index.html e renderiza dentro de um iframe na UI. É o modo correto para embutir o Notion.
App Local Servidor: o Bitrix faz POST para a URL do handler. O Notion só aceita GET no /ebd/, então retorna Cannot POST /ebd/…. ❌ Incompatível com Notion.
Static Local Apps não têm REST API — criação e upload do ZIP são manuais (via navegador).

O truque do embed: endpoint `/ebd/`

A URL publicada normal do Notion responde X-Frame-Options: SAMEORIGIN → não embuti em iframe.
O endpoint /ebd/<pageId> responde frame-ancestors https: http: → permite o iframe. Por isso o src usa /ebd/.

Remoção do "Get Notion free" — via OFICIAL do Notion

Requer plano pago + Domínio personalizado (custom domain). notion.site (mesmo pago) não libera. Conectado: kb.indufix.com.br.
No Notion: Share → Publish → Customize site styling → Header → Search ON (mantém a busca), Show Notion sign up button ("Get Notion free") OFF, Breadcrumbs/Share/Duplicate OFF → Publish changes.

Remoção do menu "…" — overlay CSS (não há toggle oficial)

O "…" (Report/Cookie) é fixo e persiste com todos os toggles OFF. Solução no HTML do app: um #cover de 48×48px no canto superior direito, cor = fundo do tema. Como o "Get Notion free" já saiu, o "…" é o último elemento à direita; o cover pega só ele e a lupa (à esquerda) continua clicável.

Consistência de tema (claro/escuro) — `color-scheme`

Sintoma: a página aparecia branca em um contexto e o app no Bitrix aparecia preto. Causa: o embed /ebd/ segue o prefers-color-scheme do navegador (dark no navegador escuro do Bitrix), não o Theme do site. Correção no HTML do app (controle total): <html style="color-scheme: light"> + <meta name="color-scheme" content="light"> + iframe{color-scheme:light} → força o /ebd/ em CLARO sempre. Para tema ESCURO: trocar light→dark e o --nt-bg do overlay (#191919).