--- title: "Widget de linha do tempo" slug: "timeline-widget" updated: 2026-10-22T17:18:25Z published: 2026-10-22T17:18:25Z canonical: "support.tulip.co/timeline-widget" --- > ## Documentation Index > Fetch the complete documentation index at: https://support.tulip.co/llms.txt > Use this file to discover all available pages before exploring further. # Widget de linha do tempo :::(Info)To download, visit: [Library](https://library.tulip.co/apps/timeline-widget). ::: ## Objetivo O widget Linha do tempo é um widget interativo que exibe eventos registrados em uma tabela do Tulip. Ele mostra o registro mais recente na parte superior, permitindo que você esteja sempre atualizado. ![image](https://tulip.widen.net/content/w9asw7xkxy/web/Timelinewidget.gif?animate=true&u=hhrpm9) ## Configuração Campos obrigatórios: - ID de agregação (agregação da tabela do Tulip) - Chave da API (texto) - Segredo (texto) - URL da conta (texto) Campo opcional: - Texto branco (sim/não) - Ative a opção “sim” para alterar a cor da fonte para branco. O padrão é “não”. Para configurar este widget, você precisa fornecer uma chave de API, um segredo e uma URL (que tem o formato `sua-conta.tulip.co`). Se você não sabe o que é uma chave de API, consulte a próxima seção.Como alternativa, você pode configurar o widget no editor do aplicativo (antes de executá-lo) inserindo as informações diretamente nas propriedades do widget.Depois de fornecer as informações necessárias, atualize o widget. Nesse momento, se houver eventos na tabela, eles deverão ser exibidos no widget.O widget utiliza uma agregação. Por meio dessa agregação, o widget é preenchido com as informações dos eventos. Sem essa agregação, o widget precisaria ser atualizado após cada inserção na tabela para se manter atualizado. ### Como criar uma conta de serviço Feature rename Prior to r383, Service Accounts were called "API Tokens". Para acessar a tabela de eventos, você deve ter uma conta de serviço com permissão `de leitura para tabelas.` Verifique se você possui uma acessando a seção de configurações da sua instância e, em seguida, “Tulip API”. Se um espaço de trabalho estiver configurado, essa opção pode estar em “Configurações do espaço de trabalho”.Se você já possui uma conta de serviço, ela estará listada nesse local. Clique em “Editar” e certifique-se de que `“tabelas: leitura”` esteja marcado em “escopos”. Se estiver marcado, está tudo pronto; caso contrário, ajuste os escopos ou crie uma nova conta de serviço.Se não houver nenhuma conta de serviço, crie uma clicando no botão “Criar conta de serviço”. Atribua o nome que preferir e, em seguida, selecione os escopos, certificando-se de que `“tabelas: leitura”` esteja marcado, bem como quaisquer outros escopos que julgar necessários. De preferência, atribua o mínimo de privilégios necessários; no entanto, se estiver em dúvida, você pode marcar todas as opções.Ao clicar em “Criar”, aparecerá uma janela solicitando que você salve a chave secreta. Siga essa instrução, pois, se você a perder e precisar regenerar a chave secreta, todos os locais onde a chave anterior for utilizada precisarão ser atualizados com a nova chave. ## Como funciona O widget é atualizado automaticamente quando um novo registro é adicionado à tabela. Ele exibe os eventos mais recentes na parte superior. Você pode alterar a fonte caso esteja usando o widget em um fundo mais escuro. A tabela se chama `“Eventos da linha do tempo` ” e possui as seguintes colunas: - ID (texto) - ID exclusivo para os eventos; deve ser criado automaticamente; não se destina a ser exibido, mas é necessário - Título (texto) - título do evento; deve ser conciso, pois é exibido em tamanho maior - Descrição (texto) - se o título não for descritivo o suficiente, mais detalhes podem ser adicionados e exibidos abaixo do Título- Tipo (texto) - pode ser um dos seguintes ou deixado em branco: `sucesso, erro, aviso, mensagem, andon, pausa, iniciar, parar, msteams` - há também um ícone padrão caso o tipo não seja especificado ou não seja nenhum dos mencionados anteriormente - eles são tratados sem distinção entre maiúsculas e minúsculas no widget- Data de criação (metadados, oculta) - cada registro em um “ Tulip table ” possui metadados (Data de criação e Data de atualização) que não podem ser modificados, mas podem ser usados em consultas