@danhachuel/thunderbolt 0.2.67 → 0.2.68

package/MANUAL-INSTALACAO.md

@@ -345,14 +345,14 @@ Set-ExecutionPolicy -Scope CurrentUser RemoteSigned
 
 ## 8. Configuração inicial da UI
 
-Na primeira execução, a barra lateral apresenta **Início**, **Niche Finder**, **Pipeline**, **Automação**, **Edição**, **Models AI** e **Configurações**. O menu expansível **Automação** contém a subaba **Automação Youtube**. O menu expansível **Edição** contém **Limpador de Metadados**, **Cortes** e **Editor Python**. O menu expansível **Models AI** contém **Personagens** e **Redes Sociais**, nessa ordem; ambas estão reservadas para desenvolvimento futuro e não executam operações. O menu expansível **Niche Finder** contém **Niche Finder Kaggle** e **Niche Finder Apify**. A aba **Niche Finder Kaggle** mantém a análise do dataset Kaggle; **Niche Finder Apify** é uma segunda alternativa independente, com actor, dataset, parâmetros, credencial, execução e resultados próprios. Abra **Configurações > Configurações Técnicas** e reveja. A página está organizada em três subabas sem numeração visível, na ordem **Contas Google/YouTube — canais em lote**, **API Keys** e **Teste de vozes**. A subaba de contas contém os registos Google, sessionInfo e documentos de Upload directo; **API Keys** reúne execução local, OAuth, LLM, TTS, materiais e restantes credenciais; **Teste de vozes** contém apenas o preview de áudio. O menu **Pipeline** contém **Criação de Vídeos**, **Criação de Músicas** e **Upload**. O menu **Configurações** contém **Canais Youtube**, **Blueprints Youtube**, **MCP** e **Configurações Técnicas**. Para YouTube, preencha primeiro o par **OAuth Client ID + OAuth Client Secret** se pretende autorizar uploads. A **YouTube Data API Key** é uma credencial Google Cloud diferente e fica numa área opcional, apenas para o método oficial de métricas; Client ID + Client Secret não formam uma API Key.
+Na primeira execução, a barra lateral apresenta **Início**, **Niche Finder**, **Pipeline**, **Pipeline TikTok**, **Automação**, **Edição**, **Models AI** e **Configurações**. O menu expansível **Automação** contém a subaba **Automação Youtube**. O menu expansível **Edição** contém **Limpador de Metadados**, **Cortes** e **Editor Python**. O menu expansível **Models AI** contém **Personagens**, **Redes Sociais** e **Tutorial Meta**, nessa ordem. O **Tutorial Meta** apresenta o guia de configuração de Instagram e credenciais Meta para automações com n8n. O menu expansível **Niche Finder** contém **Niche Finder Kaggle** e **Niche Finder Apify**. A aba **Niche Finder Kaggle** mantém a análise do dataset Kaggle; **Niche Finder Apify** é uma segunda alternativa independente, com actor, dataset, parâmetros, credencial, execução e resultados próprios. O menu **Pipeline** contém **Criação de Vídeos**, **Criação de Músicas**, **Roteiros** e **Upload**. O menu **Configurações** contém **Canais Youtube**, **Blueprints Youtube**, **MCP**, **Contas Google**, **Configuração API** e **Notificações**. Abra **Configurações > Contas Google** para gerir contas Google/YouTube, cartões, documentos de Upload directo, `sessionInfo`, `INNERTUBE_API_KEY`, contas adicionais e a configuração global do YouTube. Abra **Configurações > Configuração API** para configurar as restantes API Keys, providers, modelos, serviços e o **Teste de vozes**. A página **Configurações > Notificações** está reservada para futuros eventos locais. Para YouTube, preencha primeiro o par **OAuth Client ID + OAuth Client Secret** em **Contas Google** se pretende autorizar uploads. A **YouTube Data API Key** é uma credencial Google Cloud diferente e fica em **Contas Google**, apenas para o método oficial de métricas; Client ID + Client Secret não formam uma API Key.
 
 | Configuração | Finalidade |
 |---|---|
 | Porta Streamlit | Definir a porta local da UI |
 | Pasta MoneyPrinterTurbo | Indicar o clone local que será sincronizado com `config.toml` |
-| YouTube Data API Key (opcional) | Permitir o método oficial Data API para métricas públicas; não é necessária para a página pública nem para OAuth |
-| YouTube OAuth Client ID | Identificar a aplicação OAuth 2.0 do Google para autorizar operações autenticadas, como upload |
+| YouTube Data API Key (opcional) | Em **Configurações > Contas Google**, permitir o método oficial Data API para métricas públicas; não é necessária para a página pública nem para OAuth |
+| YouTube OAuth Client ID | Em **Configurações > Contas Google**, identificar a aplicação OAuth 2.0 do Google para autorizar operações autenticadas, como upload |
 | YouTube OAuth Client Secret | Secret do mesmo cliente OAuth 2.0; não é uma Data API Key nem um token de acesso |
 | OpenAI/ NVIDIA NIM API key | Credencial do OpenAI ou NVIDIA Build/NIM, guardada apenas no storage local |
 | OpenAI/ NVIDIA NIM Base URL | Endpoint OpenAI-compatible; por padrão `https://integrate.api.nvidia.com/v1` |

package/README.md

@@ -38,11 +38,13 @@ Os dados são segredos de sessão. Os valores não aparecem em tabelas ou logs,
 
 Os adaptadores do MoneyPrinterTurbo e de publicação nas plataformas são ligados pelas configurações locais e pelos pontos de integração em `integrations/`. A UI não inventa dados quando um serviço externo ou credencial não está disponível.
 
-## Navegação da UI 0.2.56
+## Navegação da UI 0.2.68
 
-A barra lateral mantém os níveis principais, nesta ordem: **Início**, **Niche Finder**, **Pipeline**, **Automação**, **Edição**, **Models AI** e **Configurações**. **Pipeline** é expansível e contém **Criação de Vídeos**, **Criação de Músicas**, **Roteiros** e **Upload**. **Automação** também é expansível e contém **Automação Youtube**. **Edição** é expansível e contém **Limpador de Metadados**, **Cortes** e **Editor Python**, nessa ordem. **Models AI** é expansível e contém **Personagens** e **Redes Sociais**, nessa ordem. **Niche Finder** é expansível e contém **Niche Finder Kaggle** e **Niche Finder Apify**. **Configurações** é expansível e contém **Canais Youtube**, **Blueprints Youtube**, **MCP** e **Configurações Técnicas**. O Início reúne o dashboard e as filas do Pipeline, sem botões de acções rápidas.
+A barra lateral mantém os níveis principais, nesta ordem: **Início**, **Niche Finder**, **Pipeline**, **Pipeline TikTok**, **Automação**, **Edição**, **Models AI** e **Configurações**. **Pipeline** é expansível e contém **Criação de Vídeos**, **Criação de Músicas**, **Roteiros** e **Upload**. **Automação** também é expansível e contém **Automação Youtube**. **Edição** é expansível e contém **Limpador de Metadados**, **Cortes** e **Editor Python**, nessa ordem. **Models AI** é expansível e contém **Personagens**, **Redes Sociais** e **Tutorial Meta**, nessa ordem. **Niche Finder** é expansível e contém **Niche Finder Kaggle** e **Niche Finder Apify**. **Configurações** é expansível e contém **Canais Youtube**, **Blueprints Youtube**, **MCP**, **Contas Google**, **Configuração API** e **Notificações**. O Início reúne o dashboard e as filas do Pipeline, sem botões de acções rápidas.
 
-Dentro de **Configurações Técnicas**, a UI está organizada em três subabas, sem numeração visível: **Contas Google/YouTube — canais em lote**, **API Keys** e **Teste de vozes**. A primeira contém cartões expansíveis de contas Google, sessionInfo e documentos de Upload directo; o formulário **Adicionar outra conta Gmail** fica fora dos cartões. **API Keys** reúne execução local, OAuth, LLM, TTS, materiais e restantes credenciais; **Teste de vozes** contém exclusivamente o preview de áudio.
+Dentro de **Configurações > Contas Google**, a UI contém os cartões expansíveis de contas Google/YouTube, `sessionInfo`, documentos de Upload directo, `INNERTUBE_API_KEY`, o formulário **Adicionar outra conta Gmail** e a configuração global do YouTube (OAuth Client ID, OAuth Client Secret e YouTube Data API Key). A página **Configuração API** contém as restantes API Keys, providers, modelos, serviços, materiais, Nano Banana, TikTok, Postiz e o **Teste de vozes**.
+
+A página **Models AI > Tutorial Meta** apresenta o guia de configuração de uma conta Instagram profissional e das credenciais Meta para automações com n8n, distribuído localmente em `seed/references/guide-instagram.md` e com ligação para a [fonte original no GitHub](https://github.com/gyoridavid/ai_agents_az/blob/main/episode_8/guide-instagram.md). A página **Configurações > Notificações** é o centro local reservado para futuros eventos de processamento, publicação e integrações.
 
 ## Canais Youtube — edição por cartão e vídeos recentes
 

package/app/main.py

@@ -1010,7 +1010,7 @@ def render_channels():
                 if lookup_mode.startswith("Página pública"):
                     result = youtube.fetch_channel_public(source)
                 elif not youtube.api_key:
-                    result = IntegrationResult(False, "A YouTube Data API Key não está configurada. Escolha a opção Página pública — sem API Key ou configure a chave em Configurações.", {"status": "api_key_not_configured"})
+                    result = IntegrationResult(False, "A YouTube Data API Key não está configurada. Escolha a opção Página pública — sem API Key ou configure a chave em Configurações > Contas Google.", {"status": "api_key_not_configured"})
                 else:
                     result = youtube.fetch_channel(source)
                 st.session_state["yt_import"] = result.data
@@ -1092,7 +1092,7 @@ def render_channels():
         st.caption("Esta subaba usa a conta Google/YouTube seleccionada para listar os canais que ela gere. Não lê a caixa Gmail e não usa e-mails como pesquisa pública.")
         accounts = [account for account in settings.get("youtube_batch_accounts", []) if isinstance(account, dict) and account.get("id")]
         if not accounts:
-            st.info("Configure primeiro uma conta em Configurações > Configurações Técnicas > Contas Google/YouTube para canais em lote.")
+            st.info("Configure primeiro uma conta em Configurações > Configuração API > Contas Google/YouTube para canais em lote.")
         else:
             account_ids = [str(account["id"]) for account in accounts]
             account_labels = {str(account["id"]): f"{account.get('email', 'Conta Google')} — {account.get('label', 'Canais YouTube')}" for account in accounts}
@@ -1545,7 +1545,7 @@ def render_new_video(page_title: str = "Criação de Vídeos"):
                                 payload["thumbnail_path"] = thumbnail_path
                                 payload["thumbnail_status"] = "generated"
                             else:
-                                st.caption("A imagem ainda não foi gerada. Configure a API key em Configurações Técnicas > API Keys.")
+                                st.caption("A imagem ainda não foi gerada. Configure a API key em Configuração API > API Keys.")
                         st.caption(f"Estado da thumbnail: {payload.get('thumbnail_status', 'prompt_ready')} · texto: {payload.get('thumbnail_text') or 'sem texto'}")
             else:
                 topic_for_creative = str(st.session_state.get("new_video_topic", "") or "").strip()
@@ -1599,7 +1599,7 @@ def render_new_video(page_title: str = "Criação de Vídeos"):
                             payload["thumbnail_path"] = thumbnail_path
                             payload["thumbnail_status"] = "generated"
                         else:
-                            st.info("Escolha a variante e clique em **Gerar imagem da thumbnail com Nano Banana**. A API key é configurada em Configurações Técnicas > API Keys.")
+                            st.info("Escolha a variante e clique em **Gerar imagem da thumbnail com Nano Banana**. A API key é configurada em Configuração API > API Keys.")
                     st.session_state["new_video_creative_payload"] = payload
 
             with st.form("new_video_form"):
@@ -2588,11 +2588,11 @@ def render_upload():
 
 def render_upload_postiz():
     st.subheader("Upload para Postiz")
-    st.caption("O Thunderbolt envia primeiro o MP4 para o Postiz e cria um post na integração seleccionada. A API key e o servidor são configurados em Configurações Técnicas.")
+    st.caption("O Thunderbolt envia primeiro o MP4 para o Postiz e cria um post na integração seleccionada. A API key e o servidor são configurados em Configuração API.")
     settings = read_json("settings.json", {})
     postiz = PostizAdapter(settings)
     if not settings.get("postiz_enabled"):
-        st.warning("Postiz está desactivado. Active-o em Configurações Técnicas > API Keys e guarde a API key antes de enviar.")
+        st.warning("Postiz está desactivado. Active-o em Configuração API > API Keys e guarde a API key antes de enviar.")
     if not postiz.api_key:
         st.info("Nenhuma API key Postiz configurada.")
         return
@@ -2619,7 +2619,7 @@ def render_upload_postiz():
             format_func=lambda value: integration_labels.get(value, value),
             key="postiz_upload_integration",
         )
-        st.caption("Para alterar a integração padrão, guarde o ID seleccionado em Configurações Técnicas.")
+        st.caption("Para alterar a integração padrão, guarde o ID seleccionado em Configuração API.")
     else:
         selected_integration = st.text_input("ID da integração Postiz", value=integration_default, key="postiz_upload_integration_manual", help="Carregue as integrações para seleccionar uma conta ou introduza o ID devolvido pela API do Postiz.").strip()
         st.info("Carregue as integrações para descobrir os canais Postiz ligados à sua conta.")
@@ -2758,7 +2758,7 @@ def render_upload_conventional():
             postiz_status = postiz.status()
             (st.success if postiz_status.ok else st.warning)(postiz_status.message)
         else:
-            st.caption("Postiz está desactivado; active-o em Configurações Técnicas para o usar como fallback final.")
+            st.caption("Postiz está desactivado; active-o em Configuração API para o usar como fallback final.")
         status_cols = st.columns(2)
         with status_cols[0]:
             (st.success if status["agent"].ok else st.warning)(f"Agente: {status['agent'].message}")
@@ -2861,9 +2861,239 @@ def render_upload_conventional():
                 st.button("Preparar Facebook Pages", key=f"upload_facebook_{task['id']}", disabled=True, help="UI preparada; publicação Facebook Pages ainda não está activa.")
 
 
+def render_google_accounts():
+    st.title("Contas Google")
+    st.caption("Gestão das contas Google/YouTube, documentos de credenciais, canais em lote e credenciais globais do YouTube.")
+    settings = read_json("settings.json", {})
+
+    st.subheader("Contas Google/YouTube — canais em lote")
+    st.caption("Abra uma conta para ver e editar os detalhes. O e-mail identifica a conta Google; esta área não lê a caixa Gmail.")
+    batch_accounts = [account for account in settings.get("youtube_batch_accounts", []) if isinstance(account, dict) and account.get("id")]
+    channel_state = read_json("channels.json", [])
+    youtube_accounts_missing_document: list[str] = []
+
+    for batch_account in batch_accounts:
+        account_id = str(batch_account["id"])
+        account_email_snapshot = str(batch_account.get("email") or "sem e-mail")
+        account_label_snapshot = str(batch_account.get("label") or "Canais YouTube")
+        ensure_credentials_document(STORAGE, batch_account, settings, channel_state)
+        direct_status = direct_account_status(STORAGE, batch_account, settings)
+        missing_document_parts = list(direct_status.get("missing_cookies", []))
+        if not direct_status.get("has_session_info"):
+            missing_document_parts.append("sessionInfo")
+        if missing_document_parts:
+            youtube_accounts_missing_document.append(account_email_snapshot)
+
+        with st.expander(f"{account_label_snapshot} — {account_email_snapshot}", expanded=False):
+            with st.form(f"batch_account_form_{account_id}"):
+                account_cols = st.columns(2)
+                with account_cols[0]:
+                    account_label = st.text_input("Nome da conta", value=account_label_snapshot, key=f"batch_label_{account_id}")
+                    account_email = st.text_input("E-mail/Gmail da conta", value=account_email_snapshot if account_email_snapshot != "sem e-mail" else "", key=f"batch_email_{account_id}")
+                    account_client_id = st.text_input("OAuth Client ID", value=str(batch_account.get("client_id", "")), key=f"batch_client_id_{account_id}")
+                with account_cols[1]:
+                    account_client_secret = st.text_input("OAuth Client Secret", value=str(batch_account.get("client_secret", "")), type="password", key=f"batch_client_secret_{account_id}")
+                    account_session_info = st.text_input(
+                        "sessionInfo token desta conta Google",
+                        value=str(batch_account.get("sessionInfo") or batch_account.get("session_info") or batch_account.get("direct_session_info", "")),
+                        type="password",
+                        key=f"batch_session_info_{account_id}",
+                        help="Token sessionInfo usado pelo Upload directo. É guardado por conta e sincronizado no credentials.json; os cookies e restantes valores continuam exclusivamente no documento.",
+                    )
+                save_account = st.form_submit_button("Guardar dados da conta Google", type="primary", use_container_width=True)
+
+            st.markdown("**Documento de cookies/credenciais desta conta Google**")
+            st.caption("O documento padrão é criado automaticamente. Suba um JSON completo ou apenas o documento de cookies; os valores preenchidos são incorporados e mantidos em credentials.json.")
+            document_upload = st.file_uploader(
+                "Subir documento de cookies/credenciais",
+                type=["json"],
+                key=f"direct_credentials_document_{account_id}",
+                help="Aceita o JSON do YouTube-Video-Upload-Frontend-Api. Um documento parcial de cookies também é incorporado sem apagar os restantes campos.",
+            )
+            if missing_document_parts:
+                st.warning(f"Documento incompleto: {', '.join(missing_document_parts)}")
+            else:
+                st.success("Documento completo para a conta Google")
+            st.caption(f"Documento guardado em: {direct_status['document_file']}")
+            document_save = st.button("Guardar documento nesta conta", key=f"save_direct_account_{account_id}", use_container_width=True)
+
+            account_status = youtube_batch_account_status(batch_account, STORAGE)
+            status_cols = st.columns(3)
+            with status_cols[0]:
+                (st.success if account_status.ok else st.warning)(account_status.message)
+            with status_cols[1]:
+                if st.button("Autorizar/Reautorizar", key=f"batch_authorize_settings_{account_id}", use_container_width=True):
+                    result = authorize_youtube_batch_account(batch_account, STORAGE)
+                    (st.success if result.ok else st.error)(result.message)
+                    if result.ok:
+                        st.rerun()
+            with status_cols[2]:
+                if st.button("Apagar conta", icon=":material/delete:", key=f"batch_remove_settings_{account_id}", use_container_width=True):
+                    delete_youtube_batch_token(batch_account, STORAGE)
+                    delete_credentials_document(STORAGE, batch_account)
+                    remaining_accounts = [account for account in batch_accounts if str(account.get("id")) != account_id]
+                    settings["youtube_batch_accounts"] = remaining_accounts
+                    if settings.get("youtube_batch_selected_account_id") == account_id:
+                        settings["youtube_batch_selected_account_id"] = str(remaining_accounts[0].get("id")) if remaining_accounts else ""
+                    for channel in channel_state:
+                        if str(channel.get("google_account_id") or "") == account_id:
+                            channel.update({"google_account_id": "", "google_account_email": ""})
+                    write_json("channels.json", channel_state)
+                    write_json("settings.json", settings)
+                    st.rerun()
+
+            if save_account:
+                if "@" not in account_email.strip():
+                    st.error("Informe um e-mail Google válido.")
+                elif not account_client_id.strip() or not account_client_secret.strip():
+                    st.error("Informe o Client ID e o Client Secret desta conta.")
+                else:
+                    for existing in batch_accounts:
+                        if str(existing.get("id")) == account_id:
+                            credentials_changed = any(existing.get(field, "") != value for field, value in (("email", account_email.strip()), ("client_id", account_client_id.strip()), ("client_secret", account_client_secret.strip())))
+                            if credentials_changed:
+                                delete_youtube_batch_token(existing, STORAGE)
+                            existing.update({"label": account_label.strip() or "Canais YouTube", "email": account_email.strip(), "client_id": account_client_id.strip(), "client_secret": account_client_secret.strip(), "sessionInfo": account_session_info.strip()})
+                            update_credentials_document_session_info(STORAGE, existing, account_session_info.strip())
+                            ensure_credentials_document(STORAGE, existing, settings, channel_state)
+                    settings["youtube_batch_accounts"] = batch_accounts
+                    write_json("settings.json", settings)
+                    st.success("Conta Google/YouTube guardada.")
+                    st.rerun()
+
+            if document_save:
+                if document_upload is None:
+                    st.error("Seleccione um documento JSON de cookies/credenciais antes de guardar.")
+                else:
+                    try:
+                        merge_credentials_document(
+                            STORAGE,
+                            batch_account,
+                            document_upload.getvalue(),
+                            document_upload.name,
+                            session_info_override=str(batch_account.get("sessionInfo") or ""),
+                            channels=channel_state,
+                        )
+                        st.success("Documento incorporado e guardado nesta conta Google.")
+                        st.rerun()
+                    except ValueError as exc:
+                        st.error(str(exc))
+
+    if youtube_accounts_missing_document:
+        st.info("Contas que ainda precisam de dados no documento: " + ", ".join(youtube_accounts_missing_document))
+
+    st.divider()
+    st.markdown("### INNERTUBE_API_KEY")
+    st.caption("Esta chave pertence à conta Google/YouTube seleccionada e fica guardada na configuração da conta. Não faz parte do documento de cookies/credenciais e não é editada no separador API Keys.")
+    account_key_options = [str(account.get("id")) for account in batch_accounts if account.get("id")]
+    account_key_labels = {str(account.get("id")): f"{account.get('label', 'Canais YouTube')} — {account.get('email', 'sem e-mail')}" for account in batch_accounts if account.get("id")}
+    if account_key_options:
+        with st.form("innertube_api_key_form"):
+            selected_key_account_id = st.selectbox("Conta Google/YouTube", account_key_options, format_func=lambda value: account_key_labels.get(value, value), key="innertube_key_account")
+            selected_key_account = next(account for account in batch_accounts if str(account.get("id")) == selected_key_account_id)
+            current_innertube_api_key = direct_account_status(STORAGE, selected_key_account, settings).get("innertube_api_key", "")
+            innertube_api_key_value = st.text_input("INNERTUBE_API_KEY", value=current_innertube_api_key, type="password", key=f"innertube_api_key_{selected_key_account_id}", help="Chave usada pelo Upload directo desta conta. Guarde-a aqui, separada do documento de cookies.")
+            save_innertube_api_key = st.form_submit_button("Guardar INNERTUBE_API_KEY", type="primary", use_container_width=True)
+        if save_innertube_api_key:
+            selected_key_account["innertube_api_key"] = innertube_api_key_value.strip()
+            selected_key_account.pop("INNERTUBE_API_KEY", None)
+            settings.pop("direct_innertube_api_key", None)
+            settings["youtube_batch_accounts"] = batch_accounts
+            write_json("settings.json", settings)
+            document = load_credentials_document(STORAGE, selected_key_account, settings, channel_state, create=True)
+            save_credentials_document(STORAGE, selected_key_account, document)
+            st.success("INNERTUBE_API_KEY guardada na configuração da conta Google/YouTube, fora do documento de cookies.")
+            st.rerun()
+    else:
+        st.info("Adicione primeiro uma conta Google/YouTube para configurar a INNERTUBE_API_KEY.")
+
+    st.divider()
+    st.markdown("### Adicionar outra conta Gmail")
+    st.caption("Este formulário fica fora dos cartões das contas existentes. A associação de canais não depende da completude deste documento; ela apenas ficará pendente para Upload directo até os campos serem preenchidos.")
+    with st.form("add_batch_account_form"):
+        add_cols = st.columns(2)
+        with add_cols[0]:
+            new_account_label = st.text_input("Nome da nova conta", value="Canais YouTube", key="new_batch_account_label")
+            new_account_email = st.text_input("E-mail/Gmail", key="new_batch_account_email")
+            new_account_client_id = st.text_input("OAuth Client ID", key="new_batch_account_client_id")
+        with add_cols[1]:
+            new_account_client_secret = st.text_input("OAuth Client Secret", type="password", key="new_batch_account_client_secret")
+            new_account_session_info = st.text_input("sessionInfo token desta conta Google", type="password", key="new_batch_account_session_info", help="Token sessionInfo desta conta. Os cookies e delegated_session_ids ficam no documento; a INNERTUBE_API_KEY é configurada no bloco próprio acima.")
+            new_account_document = st.file_uploader("Documento de cookies/credenciais opcional", type=["json"], key="new_batch_account_credentials_document", help="Pode subir agora um JSON completo ou apenas o documento de cookies. Se não subir, será criado um credentials.json padrão vazio.")
+        add_account = st.form_submit_button("Adicionar conta Google/YouTube", type="primary", use_container_width=True)
+    if add_account:
+        document_error = ""
+        if "@" not in new_account_email.strip():
+            st.error("Informe um e-mail Google válido.")
+        elif not new_account_client_id.strip() or not new_account_client_secret.strip():
+            st.error("Informe o Client ID e o Client Secret da nova conta.")
+        elif new_account_document is not None:
+            try:
+                raw_document = new_account_document.getvalue()
+                json.loads(raw_document.decode("utf-8-sig", errors="replace"))
+            except (UnicodeDecodeError, json.JSONDecodeError, AttributeError) as exc:
+                document_error = f"O documento {new_account_document.name} deve ser JSON válido."
+                st.error(document_error)
+        if "@" in new_account_email.strip() and new_account_client_id.strip() and new_account_client_secret.strip() and not document_error:
+            new_account = {"id": f"google_batch_{uuid.uuid4().hex[:12]}", "label": new_account_label.strip() or "Canais YouTube", "email": new_account_email.strip(), "client_id": new_account_client_id.strip(), "client_secret": new_account_client_secret.strip(), "sessionInfo": new_account_session_info.strip()}
+            batch_accounts.append(new_account)
+            settings["youtube_batch_accounts"] = batch_accounts
+            settings["youtube_batch_selected_account_id"] = new_account["id"]
+            write_json("settings.json", settings)
+            ensure_credentials_document(STORAGE, new_account, settings, channel_state)
+            if new_account_document is not None:
+                try:
+                    merge_credentials_document(STORAGE, new_account, new_account_document.getvalue(), new_account_document.name, session_info_override=new_account_session_info.strip(), channels=channel_state)
+                except ValueError as exc:
+                    st.error(str(exc))
+                    st.stop()
+                st.success(f"Conta {new_account['email']} adicionada e documento incorporado.")
+            else:
+                st.warning(f"Conta {new_account['email']} adicionada. Foi criado um credentials.json padrão; suba o documento de cookies nesta conta quando estiver pronto.")
+            st.rerun()
+
+    st.divider()
+    st.subheader("Configuração global do YouTube")
+    st.caption("Estas credenciais pertencem à aplicação Google/YouTube e ficam separadas das restantes APIs do Thunderbolt.")
+    with st.form("google_global_api_settings_form"):
+        google_api_cols = st.columns(2)
+        with google_api_cols[0]:
+            youtube_client_id = st.text_input(
+                "YouTube OAuth Client ID",
+                value=str(settings.get("youtube_client_id", "") or ""),
+                key="google_page_youtube_client_id",
+                help="Client ID OAuth 2.0 criado no Google Cloud para autorizar a conta YouTube.",
+            )
+        with google_api_cols[1]:
+            youtube_client_secret = st.text_input(
+                "YouTube OAuth Client Secret",
+                value=str(settings.get("youtube_client_secret", "") or ""),
+                type="password",
+                key="google_page_youtube_client_secret",
+                help="Client Secret do mesmo cliente OAuth 2.0. Não é uma API Key.",
+            )
+        st.caption(f"OAuth local: use um cliente do tipo Desktop app. Se o Google Cloud pedir uma URI autorizada, registe exactamente `{loopback_redirect_uri()}`.")
+        youtube_api_key = st.text_input(
+            "YouTube Data API Key (opcional)",
+            value=str(settings.get("youtube_api_key", "") or ""),
+            type="password",
+            key="google_page_youtube_api_key",
+            help="Credencial Google Cloud separada, usada apenas para métricas oficiais da YouTube Data API.",
+        )
+        save_google_global = st.form_submit_button("Guardar configuração global do YouTube", type="primary", use_container_width=True)
+    if save_google_global:
+        settings.update({
+            "youtube_client_id": youtube_client_id.strip(),
+            "youtube_client_secret": youtube_client_secret.strip(),
+            "youtube_api_key": youtube_api_key.strip(),
+        })
+        write_json("settings.json", settings)
+        st.success("Configuração global do YouTube guardada em Contas Google.")
+        st.rerun()
+
 def render_settings():
-    st.title("Configurações Técnicas")
-    st.caption("Configuração do motor de vídeo e dos serviços usados pelo Thunderbolt. As credenciais ficam no storage local e não são enviadas para o GitHub.")
+    st.title("Configuração API")
+    st.caption("Configuração das APIs, providers, serviços e ferramentas técnicas usados pelo Thunderbolt. As credenciais ficam no storage local e não são enviadas para o GitHub.")
     settings = read_json("settings.json", {})
 
     def text_setting(label: str, key: str, *, secret: bool = False, help_text: str | None = None) -> str:
@@ -2875,209 +3105,13 @@ def render_settings():
             key=f"settings_{key}",
         )
 
-    google_accounts_tab, api_keys_tab, voice_test_tab = st.tabs(["Contas Google/YouTube — canais em lote", "API Keys", "Teste de vozes"])
-
-    with google_accounts_tab:
-        st.subheader("Contas Google/YouTube — canais em lote")
-        st.caption("Abra uma conta para ver e editar os detalhes. O e-mail identifica a conta Google; esta área não lê a caixa Gmail.")
-        batch_accounts = [account for account in settings.get("youtube_batch_accounts", []) if isinstance(account, dict) and account.get("id")]
-        channel_state = read_json("channels.json", [])
-        youtube_accounts_missing_document: list[str] = []
-
-        for batch_account in batch_accounts:
-            account_id = str(batch_account["id"])
-            account_email_snapshot = str(batch_account.get("email") or "sem e-mail")
-            account_label_snapshot = str(batch_account.get("label") or "Canais YouTube")
-            ensure_credentials_document(STORAGE, batch_account, settings, channel_state)
-            direct_status = direct_account_status(STORAGE, batch_account, settings)
-            missing_document_parts = list(direct_status.get("missing_cookies", []))
-            if not direct_status.get("has_session_info"):
-                missing_document_parts.append("sessionInfo")
-            if missing_document_parts:
-                youtube_accounts_missing_document.append(account_email_snapshot)
-
-            with st.expander(f"{account_label_snapshot} — {account_email_snapshot}", expanded=False):
-                with st.form(f"batch_account_form_{account_id}"):
-                    account_cols = st.columns(2)
-                    with account_cols[0]:
-                        account_label = st.text_input("Nome da conta", value=account_label_snapshot, key=f"batch_label_{account_id}")
-                        account_email = st.text_input("E-mail/Gmail da conta", value=account_email_snapshot if account_email_snapshot != "sem e-mail" else "", key=f"batch_email_{account_id}")
-                        account_client_id = st.text_input("OAuth Client ID", value=str(batch_account.get("client_id", "")), key=f"batch_client_id_{account_id}")
-                    with account_cols[1]:
-                        account_client_secret = st.text_input("OAuth Client Secret", value=str(batch_account.get("client_secret", "")), type="password", key=f"batch_client_secret_{account_id}")
-                        account_session_info = st.text_input(
-                            "sessionInfo token desta conta Google",
-                            value=str(batch_account.get("sessionInfo") or batch_account.get("session_info") or batch_account.get("direct_session_info", "")),
-                            type="password",
-                            key=f"batch_session_info_{account_id}",
-                            help="Token sessionInfo usado pelo Upload directo. É guardado por conta e sincronizado no credentials.json; os cookies e restantes valores continuam exclusivamente no documento.",
-                        )
-                    save_account = st.form_submit_button("Guardar dados da conta Google", type="primary", use_container_width=True)
-
-                st.markdown("**Documento de cookies/credenciais desta conta Google**")
-                st.caption("O documento padrão é criado automaticamente. Suba um JSON completo ou apenas o documento de cookies; os valores preenchidos são incorporados e mantidos em credentials.json.")
-                document_upload = st.file_uploader(
-                    "Subir documento de cookies/credenciais",
-                    type=["json"],
-                    key=f"direct_credentials_document_{account_id}",
-                    help="Aceita o JSON do YouTube-Video-Upload-Frontend-Api. Um documento parcial de cookies também é incorporado sem apagar os restantes campos.",
-                )
-                if missing_document_parts:
-                    st.warning(f"Documento incompleto: {', '.join(missing_document_parts)}")
-                else:
-                    st.success("Documento completo para a conta Google")
-                st.caption(f"Documento guardado em: {direct_status['document_file']}")
-                document_save = st.button("Guardar documento nesta conta", key=f"save_direct_account_{account_id}", use_container_width=True)
-
-                account_status = youtube_batch_account_status(batch_account, STORAGE)
-                status_cols = st.columns(3)
-                with status_cols[0]:
-                    (st.success if account_status.ok else st.warning)(account_status.message)
-                with status_cols[1]:
-                    if st.button("Autorizar/Reautorizar", key=f"batch_authorize_settings_{account_id}", use_container_width=True):
-                        result = authorize_youtube_batch_account(batch_account, STORAGE)
-                        (st.success if result.ok else st.error)(result.message)
-                        if result.ok:
-                            st.rerun()
-                with status_cols[2]:
-                    if st.button("Apagar conta", icon=":material/delete:", key=f"batch_remove_settings_{account_id}", use_container_width=True):
-                        delete_youtube_batch_token(batch_account, STORAGE)
-                        delete_credentials_document(STORAGE, batch_account)
-                        remaining_accounts = [account for account in batch_accounts if str(account.get("id")) != account_id]
-                        settings["youtube_batch_accounts"] = remaining_accounts
-                        if settings.get("youtube_batch_selected_account_id") == account_id:
-                            settings["youtube_batch_selected_account_id"] = str(remaining_accounts[0].get("id")) if remaining_accounts else ""
-                        for channel in channel_state:
-                            if str(channel.get("google_account_id") or "") == account_id:
-                                channel.update({"google_account_id": "", "google_account_email": ""})
-                        write_json("channels.json", channel_state)
-                        write_json("settings.json", settings)
-                        st.rerun()
-
-                if save_account:
-                    if "@" not in account_email.strip():
-                        st.error("Informe um e-mail Google válido.")
-                    elif not account_client_id.strip() or not account_client_secret.strip():
-                        st.error("Informe o Client ID e o Client Secret desta conta.")
-                    else:
-                        for existing in batch_accounts:
-                            if str(existing.get("id")) == account_id:
-                                credentials_changed = any(existing.get(field, "") != value for field, value in (("email", account_email.strip()), ("client_id", account_client_id.strip()), ("client_secret", account_client_secret.strip())))
-                                if credentials_changed:
-                                    delete_youtube_batch_token(existing, STORAGE)
-                                existing.update({"label": account_label.strip() or "Canais YouTube", "email": account_email.strip(), "client_id": account_client_id.strip(), "client_secret": account_client_secret.strip(), "sessionInfo": account_session_info.strip()})
-                                update_credentials_document_session_info(STORAGE, existing, account_session_info.strip())
-                                ensure_credentials_document(STORAGE, existing, settings, channel_state)
-                        settings["youtube_batch_accounts"] = batch_accounts
-                        write_json("settings.json", settings)
-                        st.success("Conta Google/YouTube guardada.")
-                        st.rerun()
-
-                if document_save:
-                    if document_upload is None:
-                        st.error("Seleccione um documento JSON de cookies/credenciais antes de guardar.")
-                    else:
-                        try:
-                            merge_credentials_document(
-                                STORAGE,
-                                batch_account,
-                                document_upload.getvalue(),
-                                document_upload.name,
-                                session_info_override=str(batch_account.get("sessionInfo") or ""),
-                                channels=channel_state,
-                            )
-                            st.success("Documento incorporado e guardado nesta conta Google.")
-                            st.rerun()
-                        except ValueError as exc:
-                            st.error(str(exc))
-
-        if youtube_accounts_missing_document:
-            st.info("Contas que ainda precisam de dados no documento: " + ", ".join(youtube_accounts_missing_document))
-
-        st.divider()
-        st.markdown("### INNERTUBE_API_KEY")
-        st.caption("Esta chave pertence à conta Google/YouTube seleccionada e fica guardada na configuração da conta. Não faz parte do documento de cookies/credenciais e não é editada no separador API Keys.")
-        account_key_options = [str(account.get("id")) for account in batch_accounts if account.get("id")]
-        account_key_labels = {str(account.get("id")): f"{account.get('label', 'Canais YouTube')} — {account.get('email', 'sem e-mail')}" for account in batch_accounts if account.get("id")}
-        if account_key_options:
-            with st.form("innertube_api_key_form"):
-                selected_key_account_id = st.selectbox("Conta Google/YouTube", account_key_options, format_func=lambda value: account_key_labels.get(value, value), key="innertube_key_account")
-                selected_key_account = next(account for account in batch_accounts if str(account.get("id")) == selected_key_account_id)
-                current_innertube_api_key = direct_account_status(STORAGE, selected_key_account, settings).get("innertube_api_key", "")
-                innertube_api_key_value = st.text_input("INNERTUBE_API_KEY", value=current_innertube_api_key, type="password", key=f"innertube_api_key_{selected_key_account_id}", help="Chave usada pelo Upload directo desta conta. Guarde-a aqui, separada do documento de cookies.")
-                save_innertube_api_key = st.form_submit_button("Guardar INNERTUBE_API_KEY", type="primary", use_container_width=True)
-            if save_innertube_api_key:
-                selected_key_account["innertube_api_key"] = innertube_api_key_value.strip()
-                selected_key_account.pop("INNERTUBE_API_KEY", None)
-                settings.pop("direct_innertube_api_key", None)
-                settings["youtube_batch_accounts"] = batch_accounts
-                write_json("settings.json", settings)
-                document = load_credentials_document(STORAGE, selected_key_account, settings, channel_state, create=True)
-                save_credentials_document(STORAGE, selected_key_account, document)
-                st.success("INNERTUBE_API_KEY guardada na configuração da conta Google/YouTube, fora do documento de cookies.")
-                st.rerun()
-        else:
-            st.info("Adicione primeiro uma conta Google/YouTube para configurar a INNERTUBE_API_KEY.")
-
-        st.divider()
-        st.markdown("### Adicionar outra conta Gmail")
-        st.caption("Este formulário fica fora dos cartões das contas existentes. A associação de canais não depende da completude deste documento; ela apenas ficará pendente para Upload directo até os campos serem preenchidos.")
-        with st.form("add_batch_account_form"):
-            add_cols = st.columns(2)
-            with add_cols[0]:
-                new_account_label = st.text_input("Nome da nova conta", value="Canais YouTube", key="new_batch_account_label")
-                new_account_email = st.text_input("E-mail/Gmail", key="new_batch_account_email")
-                new_account_client_id = st.text_input("OAuth Client ID", key="new_batch_account_client_id")
-            with add_cols[1]:
-                new_account_client_secret = st.text_input("OAuth Client Secret", type="password", key="new_batch_account_client_secret")
-                new_account_session_info = st.text_input("sessionInfo token desta conta Google", type="password", key="new_batch_account_session_info", help="Token sessionInfo desta conta. Os cookies e delegated_session_ids ficam no documento; a INNERTUBE_API_KEY é configurada no bloco próprio acima.")
-                new_account_document = st.file_uploader("Documento de cookies/credenciais opcional", type=["json"], key="new_batch_account_credentials_document", help="Pode subir agora um JSON completo ou apenas o documento de cookies. Se não subir, será criado um credentials.json padrão vazio.")
-            add_account = st.form_submit_button("Adicionar conta Google/YouTube", type="primary", use_container_width=True)
-        if add_account:
-            document_error = ""
-            if "@" not in new_account_email.strip():
-                st.error("Informe um e-mail Google válido.")
-            elif not new_account_client_id.strip() or not new_account_client_secret.strip():
-                st.error("Informe o Client ID e o Client Secret da nova conta.")
-            elif new_account_document is not None:
-                try:
-                    raw_document = new_account_document.getvalue()
-                    json.loads(raw_document.decode("utf-8-sig", errors="replace"))
-                except (UnicodeDecodeError, json.JSONDecodeError, AttributeError) as exc:
-                    document_error = f"O documento {new_account_document.name} deve ser JSON válido."
-                    st.error(document_error)
-            if "@" in new_account_email.strip() and new_account_client_id.strip() and new_account_client_secret.strip() and not document_error:
-                new_account = {"id": f"google_batch_{uuid.uuid4().hex[:12]}", "label": new_account_label.strip() or "Canais YouTube", "email": new_account_email.strip(), "client_id": new_account_client_id.strip(), "client_secret": new_account_client_secret.strip(), "sessionInfo": new_account_session_info.strip()}
-                batch_accounts.append(new_account)
-                settings["youtube_batch_accounts"] = batch_accounts
-                settings["youtube_batch_selected_account_id"] = new_account["id"]
-                write_json("settings.json", settings)
-                ensure_credentials_document(STORAGE, new_account, settings, channel_state)
-                if new_account_document is not None:
-                    try:
-                        merge_credentials_document(STORAGE, new_account, new_account_document.getvalue(), new_account_document.name, session_info_override=new_account_session_info.strip(), channels=channel_state)
-                    except ValueError as exc:
-                        st.error(str(exc))
-                        st.stop()
-                    st.success(f"Conta {new_account['email']} adicionada e documento incorporado.")
-                else:
-                    st.warning(f"Conta {new_account['email']} adicionada. Foi criado um credentials.json padrão; suba o documento de cookies nesta conta quando estiver pronto.")
-                st.rerun()
+    api_keys_tab, voice_test_tab = st.tabs(["API Keys", "Teste de vozes"])
 
     with api_keys_tab:
         with st.form("settings_form"):
             st.subheader("API Keys")
             port = st.number_input("Porta Streamlit", 1, 65535, int(settings.get("port", 3030)))
             moneyprinter_path = st.text_input("Pasta do motor de vídeo", settings.get("moneyprinter_path", ""), key="settings_moneyprinter_path")
-            st.markdown("**YouTube — OAuth 2.0 e consulta pública**")
-            st.caption("Para autorizar uploads, preencha apenas o YouTube OAuth Client ID e o YouTube OAuth Client Secret. Depois, autorize o agente na aba Upload. Estes dados identificam a aplicação OAuth; não são uma Data API Key nem um token de acesso.")
-            st.info(f"OAuth local: use um cliente do tipo Desktop app. Se o Google Cloud pedir uma URI autorizada, registe exactamente `{loopback_redirect_uri()}`.")
-            youtube_cols = st.columns(2)
-            with youtube_cols[0]:
-                youtube_client_id = text_setting("YouTube OAuth Client ID", "youtube_client_id", help_text="Client ID do OAuth 2.0 criado no Google Cloud. É usado para iniciar a autorização da conta YouTube.")
-            with youtube_cols[1]:
-                youtube_client_secret = text_setting("YouTube OAuth Client Secret", "youtube_client_secret", secret=True, help_text="Client Secret do mesmo cliente OAuth 2.0. Não é uma API Key.")
-
             with st.expander("Niche Finder — execução remota no Kaggle", expanded=True):
                 st.caption("O dataset permanece no Kaggle. O Thunderbolt usa estas credenciais apenas para publicar/executar a kernel e obter os resultados pequenos da análise.")
                 kaggle_cols = st.columns(3)
@@ -3100,10 +3134,6 @@ def render_settings():
                 with apify_cols[3]:
                     apify_run_timeout = st.number_input("Limite da execução (s)", min_value=30, max_value=7200, value=int(settings.get("apify_run_timeout_seconds", 900)), step=30)
 
-            with st.expander("Consulta oficial de métricas — opcional"):
-                st.caption("A YouTube Data API Key é uma credencial Google Cloud separada do OAuth. Só é necessária se escolher o método YouTube Data API para consultar métricas oficiais. Não é necessária para Página pública — sem API Key, para autorizar OAuth ou para fazer upload.")
-                youtube_api_key = text_setting("YouTube Data API Key (opcional)", "youtube_api_key", secret=True, help_text="Credencial separada, criada em Google Cloud > APIs e serviços > Credenciais > Chave de API. Não cole aqui o Client ID nem o Client Secret.")
-
             with st.expander("Serviço, materiais e rede"):
                 cols = st.columns(2)
                 with cols[0]:
@@ -3260,8 +3290,7 @@ def render_settings():
             save_all_settings = st.form_submit_button("Guardar configurações do Thunderbolt", type="primary")
             if save_all_settings:
                 settings.update({
-                    "port": port, "moneyprinter_path": moneyprinter_path, "youtube_api_key": youtube_api_key,
-                    "youtube_client_id": youtube_client_id, "youtube_client_secret": youtube_client_secret,
+                    "port": port, "moneyprinter_path": moneyprinter_path,
                     "kaggle_username": kaggle_username.strip(), "kaggle_api_key": kaggle_api_key.strip(), "kaggle_kernel_slug": kaggle_kernel_slug.strip() or "thunderbolt-niche-finder",
                     "apify_api_token": apify_api_token.strip(), "apify_actor_id": apify_actor_id.strip() or DEFAULT_ACTOR_ID, "apify_poll_interval_seconds": int(apify_poll_interval), "apify_run_timeout_seconds": int(apify_run_timeout),
                     "log_level": log_level, "listen_host": listen_host, "listen_port": listen_port, "video_source": video_source,
@@ -3329,6 +3358,32 @@ def render_settings():
             st.warning("A amostra de voz anterior não é um ficheiro de áudio legível e foi removida do estado local. Teste a voz novamente.")
 
 
+def render_notifications():
+    st.title("Notificações")
+    st.caption("Centro de notificações locais do Thunderbolt.")
+    st.info("Ainda não existem notificações registadas. Os eventos de processamento, publicação e integração serão ligados aqui numa etapa posterior.")
+    st.divider()
+    st.subheader("Preferências de notificação")
+    st.caption("Os canais de e-mail, push e webhook ainda não estão activos nesta versão.")
+    st.checkbox("Notificações no painel", value=True, disabled=True, key="notifications_panel_preview")
+    st.checkbox("Notificações por e-mail", value=False, disabled=True, key="notifications_email_preview")
+
+
+def render_models_ai_tutorial():
+    tutorial_url = "https://github.com/gyoridavid/ai_agents_az/blob/main/episode_8/guide-instagram.md"
+    tutorial_path = ROOT / "seed" / "references" / "guide-instagram.md"
+    st.title("Tutorial Meta")
+    st.caption("Guia de configuração de uma conta Instagram profissional e das credenciais Meta para automações com n8n.")
+    st.markdown(f"[Abrir fonte original no GitHub]({tutorial_url})")
+    try:
+        tutorial_content = tutorial_path.read_text(encoding="utf-8").strip()
+    except OSError:
+        tutorial_content = ""
+    if not tutorial_content:
+        st.error("O conteúdo local do tutorial não está disponível. Consulte a fonte original no GitHub.")
+        return
+    st.markdown(tutorial_content, unsafe_allow_html=True)
+
 def render_mcp():
     st.title("MCP")
     st.caption("Clientes externos, servidor MCP do Thunderbolt e a skill local ficam separados para evitar confundir funções diferentes.")
@@ -3615,12 +3670,15 @@ def main():
     models_ai_items = [
         ("Personagens", ":material/person:", "Personagens"),
         ("Redes Sociais", ":material/share:", "Redes Sociais"),
+        ("Tutorial Meta", ":material/menu_book:", "Tutorial Meta"),
     ]
     settings_items = [
         ("Canais Youtube", ":material/ondemand_video:", "Canais Youtube"),
         ("Blueprints Youtube", ":material/library_books:", "Blueprints Youtube"),
         ("MCP", ":material/hub:", "MCP"),
-        ("Configurações Técnicas", ":material/settings:", "Configurações Técnicas"),
+        ("Contas Google", ":material/account_circle:", "Contas Google"),
+        ("Configuração API", ":material/settings:", "Configuração API"),
+        ("Notificações", ":material/notifications:", "Notificações"),
     ]
     niche_finder_items = [
         ("Niche Finder Kaggle", ":material/search:", "Niche Finder Kaggle"),
@@ -3648,7 +3706,8 @@ def main():
         "Automação": "Automação Youtube",
         "Canais": "Canais Youtube",
         "Blueprints": "Blueprints Youtube",
-        "Configurações Técnicas": "Configurações Técnicas",
+        "Configurações Técnicas": "Configuração API",
+        "Contas Google/YouTube — canais em lote": "Contas Google",
     }
     current_page = aliases.get(st.session_state.get("page", "Início"), st.session_state.get("page", "Início"))
     if current_page not in {item[0] for item in top_pages + pipeline_items + pipeline_tiktok_items + automation_items + edition_items + models_ai_items + niche_finder_items + settings_items}:
@@ -3713,13 +3772,16 @@ def main():
         "Cortes": render_cuts,
         "Editor Python": render_python_editor,
         "Models AI": lambda: render_edit_placeholder("Models AI", "Seleccione uma das abas Models AI no menu expansível."),
+        "Tutorial Meta": render_models_ai_tutorial,
         "Personagens": lambda: render_edit_placeholder("Personagens", "Área reservada para a futura funcionalidade de personagens."),
         "Redes Sociais": lambda: render_edit_placeholder("Redes Sociais", "Área reservada para a futura funcionalidade de redes sociais."),
         "Upload": render_upload,
         "Canais Youtube": render_channels,
         "Blueprints Youtube": render_blueprints,
         "MCP": render_mcp,
-        "Configurações Técnicas": render_settings,
+        "Contas Google": render_google_accounts,
+        "Configuração API": render_settings,
+        "Notificações": render_notifications,
     }
     renderers.get(current_page, render_dashboard)()
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@danhachuel/thunderbolt",
-  "version": "0.2.67",
+  "version": "0.2.68",
   "description": "Thunderbolt — interface local para operação de canais faceless e motor MoneyPrinterTurbo",
   "main": "scripts/cli.mjs",
   "type": "module",

package/seed/references/guide-instagram.md

@@ -0,0 +1,179 @@
+# Setting up Instagram for automations with n8n
+
+## [📚 Join our Skool community for support, premium content and more!](https://www.skool.com/ai-agents-az/about?gw8)
+
+### Be part of a growing community and help us create more content like this
+
+## Convert the Instagram account to a professional account
+
+> [!IMPORTANT]
+> Converting the Instagram account to a professional (business or creator) account will make the account public
+
+In the Instagram application, follow these steps to convert your account to a professional account.
+
+<table>
+  <tr>
+    <td>
+      1. Open the settings, and select `Account type and tools`
+      <img src="https://github.com/user-attachments/assets/adffda31-f8ce-4a49-a971-40e5cd5f5395" alt="" />
+    </td>
+    <td>
+      2. Click on `Switch to professinal account`
+      <img src="https://github.com/user-attachments/assets/5ea13aeb-b6ac-40b4-906f-2fc563625c52" alt="" />
+    </td>
+    <td>
+      3. Click on `Next`
+      <img src="https://github.com/user-attachments/assets/10942cc8-6045-4ca1-a14a-241a2d94591c" />
+    </td>
+  </tr>
+  <tr>
+    <td>
+      4. Select the type of account your want to create
+      <img src="https://github.com/user-attachments/assets/c9e19bf8-b48d-49e7-b560-e8edf423233d" alt="" />
+    </td>
+    <td>
+      5. Select the right category, that describe your account
+      <img src="https://github.com/user-attachments/assets/eb4680b2-1d38-476c-8fb0-c428d1e12db9" alt="" />
+    </td>
+    <td>
+      6. Confirm the choice
+      <img src="https://github.com/user-attachments/assets/22ee13cf-f751-4cea-9fc0-be466c885b02" alt="" />
+    </td>
+  </tr>
+</table>
+
+## Create credentials to use with n8n
+
+### 1. Create a Facebook page
+
+Navigate to [https://www.facebook.com/pages/create](https://www.facebook.com/pages/create) to create a new Facebook page.
+Fill out the required parameters (name, category) and create the page.
+
+<img width="1554" alt="Screenshot 2025-05-05 at 10 02 00 AM" src="https://github.com/user-attachments/assets/f0e321a2-7b85-4b23-b85b-f8e63281b6b9" />
+
+Now, you need to be acting on behalf of the page - if it's not active for some reason, select it from the menu.
+
+<img width="372" alt="image" src="https://github.com/user-attachments/assets/7aaaccc8-4b0a-4f72-a8c9-f2ecc453584a" />
+
+### 2. Connect Instagram account to the Facebook page
+
+Click on your page's name on the left side.
+
+<img width="379" alt="image" src="https://github.com/user-attachments/assets/fd1ed1d8-8890-4636-a4ae-0496db252283" />
+
+Select `Settings` from the menu.
+
+<img width="368" alt="image" src="https://github.com/user-attachments/assets/641904ec-764e-4d56-bede-618da33db7fe" />
+
+Scroll down to `Permissions` and select `Linked accounts`.
+
+<img width="369" alt="image" src="https://github.com/user-attachments/assets/a024ad7e-8358-4329-a864-c7b621810405" />
+
+Select `Instagram`.
+
+<img width="740" alt="image" src="https://github.com/user-attachments/assets/141164a0-c88e-46a0-a335-466f81297bc6" />
+
+Click on `Connect account` and sign in with your Instagram account.
+
+<img width="708" alt="image" src="https://github.com/user-attachments/assets/5324b945-621b-4f2b-b513-9b51e5b5c071" />
+
+Click on `Connect`.
+
+<img width="573" alt="image" src="https://github.com/user-attachments/assets/85cad094-a815-441a-a0e5-84081fd0ee2d" />
+
+Click on `Confirm`.
+
+<img width="570" alt="image" src="https://github.com/user-attachments/assets/df5bb377-22a8-41de-b99d-0f80052cb372" />
+
+Click on `Continue`.
+
+<img width="561" alt="image" src="https://github.com/user-attachments/assets/81fd3143-f00b-4e33-9521-12c0c9ce623d" />
+
+You are done.
+
+<img width="713" alt="image" src="https://github.com/user-attachments/assets/ce4c0bbe-beed-4c6c-8731-23216efbccb5" />
+
+### 3. Create a Facebook application
+
+Head to [https://developers.facebook.com/apps](https://developers.facebook.com/apps) and click on `Create app`
+
+<img width="1027" alt="image" src="https://github.com/user-attachments/assets/ca5c79b9-974a-4c55-8f88-6def8c1b98d1" />
+
+Select the `Other` use case and hit `Next`.
+
+<img width="1033" alt="image" src="https://github.com/user-attachments/assets/31f296bd-3b47-432b-9037-7974e821a311" />
+
+Select `Business` app type.
+
+<img width="818" alt="image" src="https://github.com/user-attachments/assets/2ab06dd1-33ba-4d87-8365-3637c8327877" />
+
+Review, and click on `Create app`
+
+<img width="815" alt="image" src="https://github.com/user-attachments/assets/c8cc8e1d-c006-428a-9bfa-8cc78a2932c9" />
+
+Add the Instagram product to your app.
+
+<img width="1008" alt="image" src="https://github.com/user-attachments/assets/4186f90b-b619-4c1c-9ea8-bfc5294eaeb4" />
+
+You don't need to configure it, just leave it as it is.
+
+### 4. Create an access token
+
+From the tools menu, select the `Graph API Explorer`
+
+<img width="877" alt="image" src="https://github.com/user-attachments/assets/006a40a7-894a-4bd0-9483-0d495b77206f" />
+
+You'll see this interface below.
+
+<img width="541" alt="image" src="https://github.com/user-attachments/assets/414ece47-2f1d-4d08-9998-ada85ffb065f" />
+
+1. Make sure the Meta app is the one you just created
+2. In the permissions panel, add the following permissions
+
+- `pages_show_list`
+- `business_management`
+- `instagram_basic`
+- `instagram_content_publish`
+- `pages_read_engagement`
+
+3. Click on `Generate Access Token`
+
+4. You'll be prompted to select the Facebook page you give access to, the business account and the Instagram account. Select all of them. During the process, take a not of the **Instagram account id** you are connecting, you'll need that later.
+
+<table>
+  <tr>
+    <td>
+      <img width="564" alt="Screenshot 2025-05-09 at 11 07 22 AM" src="https://github.com/user-attachments/assets/6b77415e-1ca2-47f0-b046-974fd391c90a" />
+    </td>
+    <td>
+      <img width="562" alt="Screenshot 2025-05-09 at 11 07 27 AM" src="https://github.com/user-attachments/assets/353b9973-426b-4034-b5fc-e77840ca0d18" />
+    </td>
+    <td>
+      <img width="562" alt="Screenshot 2025-05-09 at 11 08 35 AM" src="https://github.com/user-attachments/assets/58132694-1376-4c40-9d20-61cb8fdb9df5" />
+    </td>
+    <td>
+      <img width="562" alt="Screenshot 2025-05-09 at 11 08 58 AM" src="https://github.com/user-attachments/assets/c2676755-f12f-49d6-9a92-49ea688fc832" />
+    </td>
+  </tr>
+</table>
+
+5. Copy the access token, and head to the [Facebook token debugger tool](https://developers.facebook.com/tools/debug/accesstoken) and paste in the access token, and click `debug`. Scroll to the very bottom of the page, and click on `Extend Access Token`. Copy the long-lived access token.
+
+6. Go back to the `Graph API Explorer` and paste the access token to the access token field and add `me/accounts` to the graph path and click `Submit`. In the results, you'll find field `access_token` that contains the long-lived page access token that will never expire. Copy that.
+
+<img width="693" alt="image" src="https://github.com/user-attachments/assets/0e1bd821-5c27-4c9a-b14e-eeed9c17850f" />
+
+7. (optional) you can verify the expiration of the token, if you paste it to the [Facebook token debugger tool](https://developers.facebook.com/tools/debug/accesstoken).
+
+8. (optional) you can also get the Instagram Business Account's id, if you click on the id of the page in the Graph API explorer, and add `?fields=instagram_business_account` after the id, then click `Submit`
+
+<img width="766" alt="image" src="https://github.com/user-attachments/assets/ac0cb186-849a-4c55-8f88-6def8c1b98d1" />
+
+**If you did everything above, you'll have two things**
+
+1. A page token, that won't expire to manage your Instagram account. You will use the page token to setup the Facebook Graph node in n8n.
+2. The Instagram account id which you'll need to set in the `Configure` node in the n8n workflow
+
+---
+
+> **Source:** [ai_agents_az/episode_8/guide-instagram.md](https://github.com/gyoridavid/ai_agents_az/blob/main/episode_8/guide-instagram.md)