Bancos de dados do Notion exibem cada página com um ícone cinza padrão. Talvez você queira que cada página mostre um ícone que corresponda a um valor de propriedade, como categoria de projeto, status ou prioridade. O Notion não oferece uma configuração nativa para mapear um valor de propriedade a um ícone. Este artigo explica como usar uma fórmula combinada com a API do Notion para atribuir automaticamente um ícone de página com base no valor de uma propriedade de texto ou seleção.
Você aprenderá a sintaxe da fórmula que gera uma URL pública de emoji e como acionar a atualização do ícone usando uma ferramenta de automação sem código. O método funciona para qualquer banco de dados do Notion em um workspace com acesso à API. Após seguir estas etapas, cada página nova ou atualizada exibirá um ícone relevante sem trabalho manual.
Principais Conclusões: Automatizar Ícones de Página do Banco de Dados a Partir de Valores de Propriedade
- Propriedade de fórmula com instruções “se”: Gera uma string de URL que aponta para uma imagem de emoji específica com base no valor de uma propriedade.
- Endpoint da API do Notion “Atualizar página”: Aceita a URL gerada e define o ícone da página programaticamente.
- Ferramenta de automação externa como Zapier ou Make: Aciona a chamada à API sempre que uma página é criada ou modificada no banco de dados.
Como Funcionam os Ícones de Página do Notion e Por Que a Automação é Necessária
Cada página do Notion pode ter um ícone personalizado exibido ao lado do título. Você pode escolher um emoji, fazer upload de uma imagem personalizada ou deixar o ícone padrão. Ao adicionar uma nova página a um banco de dados, você precisa definir o ícone manualmente, a menos que use um modelo. Os modelos permitem um ícone fixo para todas as páginas criadas a partir desse modelo, mas não podem alterar o ícone com base no valor de uma propriedade. Por exemplo, um banco de dados de tarefas com status “A Fazer”, “Em Andamento” e “Concluído” não pode mostrar automaticamente um ícone diferente por status usando apenas modelos.
Para obter ícones dinâmicos, você precisa combinar uma fórmula do Notion com a API do Notion. A fórmula cria uma URL que aponta para uma imagem de emoji hospedada em uma CDN pública. A API lê essa URL e a define como ícone da página. Uma ferramenta de automação monitora páginas novas ou atualizadas e executa a chamada à API. Essa abordagem requer um workspace do Notion com integração de API ativada e uma ferramenta que possa fazer requisições HTTP.
Propriedade de Fórmula que Gera uma URL de Emoji
A fórmula usa a função if() para verificar o valor de uma propriedade e retornar uma URL correspondente. O formato da URL para um emoji da CDN do Twemoji é https://cdn.jsdelivr.net/gh/twitter/twemoji@latest/assets/svg/1f600.svg, onde a última parte é o ponto de código Unicode do emoji. Você substitui o ponto de código para cada condição.
Endpoint de Ícone da API do Notion
O endpoint da API do Notion PATCH /v1/pages/{page_id} aceita um corpo JSON com um objeto icon. Para um ícone de imagem externa, o objeto tem "type": "external" e "external": {"url": "sua-url"}. A ferramenta de automação envia essa requisição com a URL da propriedade de fórmula.
Passos para Configurar Ícones de Página Automáticos a Partir de Valores de Propriedade
Siga estas etapas para criar a fórmula, conectar a API e automatizar a atualização do ícone. Você precisa de um workspace do Notion com acesso à API e uma conta gratuita no Zapier ou Make.
- Crie uma propriedade de fórmula que gere uma URL de emoji
Abra seu banco de dados. Clique no botão + no cabeçalho da última coluna. Selecione Fórmula. Nomeie como “URL do Ícone.” Cole o seguinte modelo de fórmula, substituindo o nome da propriedade e os códigos de emoji pelos seus valores:if(prop("Status") == "A Fazer", "https://cdn.jsdelivr.net/gh/twitter/twemoji@latest/assets/svg/1f4cb.svg", if(prop("Status") == "Em Andamento", "https://cdn.jsdelivr.net/gh/twitter/twemoji@latest/assets/svg/1f501.svg", if(prop("Status") == "Concluído", "https://cdn.jsdelivr.net/gh/twitter/twemoji@latest/assets/svg/2705.svg", "")))
Encontre o ponto de código Unicode para cada emoji desejado. Use um site como Emojipedia para copiar o ponto de código. A URL deve usar o formato SVG com o ponto de código em hexadecimal minúsculo sem o prefixo U+. - Crie uma integração do Notion no workspace
Acesse https://www.notion.so/my-integrations. Clique em Nova integração. Dê um nome como “Auto Icon Updater.” Selecione o workspace que contém seu banco de dados. Clique em Enviar. Copie o token Segredo de Integração Interna. Você usará esse token na ferramenta de automação. - Compartilhe o banco de dados com a integração
Abra seu banco de dados no Notion. Clique no menu … no canto superior direito. Selecione Adicionar conexões. Encontre o nome da sua integração e clique nele. A integração agora tem acesso de leitura e escrita a esse banco de dados. - Configure uma automação no Zapier ou Make
Crie uma nova automação. O gatilho é Novo Item no Banco de Dados ou Item de Banco de Dados Atualizado no Notion. Selecione o banco de dados que você compartilhou. Para a ação, escolha Notion > Atualizar Página ou use uma requisição HTTP personalizada. Mapeie o ID da Página do gatilho para a ação. Na ação, defina o campo URL do Ícone com o valor da propriedade de fórmula. Se usar uma requisição personalizada, o corpo JSON será assim:{ "icon": { "type": "external", "external": { "url": "{{valor_da_propriedade_formula}}" } } }
Teste a automação adicionando uma nova página com um valor de propriedade que corresponda a uma de suas condições. O ícone da página deve mudar para o emoji correspondente em alguns segundos. - Lide com páginas existentes que precisam de atualização de ícone
A automação só é executada quando uma página é criada ou atualizada. Para atualizar páginas existentes, execute uma ação em lote única. Use uma ferramenta como a API do Notion com um script ou uma atualização em lote no Make. Busque todas as páginas no banco de dados e, em seguida, percorra cada uma chamando o endpoint Atualizar Página com a URL do ícone da propriedade de fórmula.
Problemas Comuns e Soluções ao Definir Ícones de Página Automaticamente
A Fórmula Retorna uma String Vazia e Nenhum Ícone Aparece
A fórmula retorna uma string vazia se o valor da propriedade não corresponder a nenhuma condição. Adicione uma condição padrão ao final das instruções if() aninhadas. Por exemplo, use uma URL de emoji genérica como valor de fallback final. Verifique também se o nome da propriedade na fórmula corresponde exatamente ao nome da propriedade no banco de dados, incluindo maiúsculas e espaços.
A Requisição à API Falha com Erro 400 Bad Request
A API espera que a URL do ícone seja uma URL de imagem válida e publicamente acessível. A URL da CDN do Twemoji deve apontar para um arquivo SVG. Se você usar uma URL PNG, a API ainda a aceita, mas o ícone pode não renderizar corretamente em algumas visualizações do Notion. Certifique-se de que a URL termine com .svg ou .png. Verifique também se o token de integração não expirou e se o banco de dados ainda está conectado à integração.
A Automação é Acionada em Toda Edição, Causando Chamadas de API Desnecessárias
Se sua automação for acionada em toda atualização de item do banco de dados, ela chamará a API mesmo quando a propriedade relevante não mudou. Para reduzir chamadas de API, adicione um filtro na sua ferramenta de automação. Por exemplo, no Zapier, adicione uma etapa de filtro que só continue se o valor da propriedade Status mudou. No Make, use um roteador com uma condição de filtro. Isso evita requisições desnecessárias e mantém-se dentro dos limites de taxa da API.
Atribuição Manual de Ícone vs Automação com Fórmula + API: Comparação
| Item | Atribuição Manual de Ícone | Automação com Fórmula + API |
|---|---|---|
| Esforço de configuração | Nenhum; requer clicar em cada página | Requer criação de fórmula e configuração de automação |
| Ícone muda dinamicamente | Não; o ícone permanece até ser alterado manualmente | Sim; o ícone é atualizado quando o valor da propriedade muda |
| Funciona sem API | Sim | Não; requer integração com a API do Notion |
| Suporta imagens personalizadas | Sim; faça upload de qualquer imagem | Apenas URLs externas; não é possível fazer upload de arquivos locais |
| Atualização em lote de páginas existentes | Não é prático para muitas páginas | Possível com um script em lote |
A atribuição manual é mais simples para bancos de dados pequenos com poucas páginas. A automação é melhor para bancos de dados grandes onde os valores das propriedades mudam com frequência e você deseja dicas visuais consistentes sem trabalho manual.
Agora você tem um método funcional para definir automaticamente o ícone de uma página do banco de dados do Notion com base no valor de uma propriedade. A fórmula gera a URL de emoji correta, e a ferramenta de automação chama a API do Notion para aplicá-la. Para estender ainda mais, você pode adicionar mais condições à fórmula para valores de propriedade adicionais. Para usuários avançados, use a API do Notion diretamente com um script agendado para atualizar ícones em um temporizador em vez de depender de gatilhos.