Gerenciar um app ao vivo em Administração

"Alguém pode corrigir o erro de digitação no cartão de exportação?" "Para onde foram aquelas 200 linhas antigas?" "Alguém de fora chegou a abrir o link?" Um mês depois de a equipe de produto publicar o quadro de feedback de clientes, ninguém mais pergunta o que o app deveria fazer. As perguntas agora são outras: o que ele guarda, quem pode mexer nele e se ele está funcionando.

O chat de criação é o caminho mais lento para responder a isso. Reconstruir o app para corrigir uma palavra em um cartão é usar a ferramenta errada, e uma alteração em um registro salvo nunca deveria passar despercebida. A aba Administração existe para cuidar do app que você já tem: os registros, as conexões, o agendamento, o link e as chaves. O chat continua sendo o lugar para mudar o que o app faz.

Este guia percorre Administração na ordem em que o menu à esquerda lista as seções, usando o mesmo quadro de feedback. Como o quadro foi criado e publicado está em Criar um app ao vivo.

Resumo

Abra o app ao vivo e clique na aba Administração. Renomeie o app e adicione administradores em Visão geral. Em Dados, confira o Uso de registros, edite os registros na tabela e use o menu Mais ações de dados para Adicionar de arquivo CSV ou Salvar como arquivo CSV. Configure agendamentos em Automação, a versão publicada e o endereço em Compartilhamento e as chaves em Segredos. Quando a IA propuser no chat uma alteração em dados salvos, escolha Aplicar ou Descartar.

Quem vê a aba Administração

A aba Administração fica ao lado de Pré-visualização e Código, e só aparece para quem pode gerenciar o app: o criador e os administradores do app que ele adicionar. Todas as outras pessoas que abrem o app ao vivo, incluindo membros do canvas, convidados e visitantes de um link publicado, veem apenas o app.

O menu à esquerda não é igual para os dois grupos:

Dentro de Visão geral, só o criador pode mudar quem está na lista de administradores.

Dê nome ao app e escolha administradores em Visão geral

Visão geral é a primeira seção que abre. No topo ficam os dados de referência do app: ID do app, com um botão de copiar ao lado, e as datas de Criação e Atualização. O ID do app identifica exatamente este app, então inclua-o quando falar com o suporte sobre ele.

Nome do app é o nome que todas as pessoas com quem você compartilha o app veem, e também o título da página publicada. Digite um nome novo e clique em Salvar.

Abaixo do nome, três linhas resumem o app. Clique em uma delas para abrir a seção correspondente:

• Dados mostra em quantas tabelas o app salva, como "2 tabelas", ou Nenhum dado salvo ainda.
• Dados conectados mostra o nome da primeira fonte conectada ou Nada conectado.
• Automação mostra o estado do agendamento, como Automação desligada.

Por último vem Administradores do app. O criador aparece primeiro, marcado como Criador. Para adicionar alguém, o criador digita em Buscar por nome ou e-mail, clica em Adicionar administrador ao lado da pessoa certa e confirma com Salvar alterações. Administradores precisam ser membros do espaço de trabalho que já conseguem abrir este canvas. Ter permissão de edição no canvas, por si só, não torna ninguém administrador.

Cada administrador tem uma chave Compartilhar conversas. Com ela ativada, a pessoa também lê as conversas anteriores e altera o app pelo chat. Com ela desativada, a pessoa gerencia código, dados e automação sem ver a conversa. Remover acesso tira alguém da lista.

No quadro de feedback, a gerente de produto que o criou adiciona a designer como administradora com Compartilhar conversas ativado, porque é ela quem vai pedir mudanças de layout no chat. O engenheiro que só organiza os registros recebe acesso de administrador com a chave desativada.

Acompanhe o limite de registros em Dados

Dados reúne tudo o que o app salvou, e a primeira coisa que aparece ali é o Uso de registros: um medidor que mostra, por exemplo, "63 de 10.000 registros", com a contagem de cada coleção logo abaixo.

Cada app pode guardar 10.000 registros no total, somando todas as coleções. Os arquivos anexados aos registros não entram nesse limite. O tamanho deles ocupa o armazenamento do espaço de trabalho, como avisa a nota de rodapé do medidor.

Dois limites menores valem para itens individuais. Um registro pode ter até 32 KB, e um arquivo anexado, até 64 MB. Qualquer coisa maior é recusada com uma mensagem própria.

Quando o uso chega a 90% do limite, o medidor fica vermelho e aparece a nota "O limite de registros está próximo. Entre em contato para solicitar um aumento." Clique em Entrar em contato e um chat de suporte abre com o pedido de aumento do limite deste app já escrito. Administração não tem nenhuma configuração para o limite: um limite maior é algo que você solicita ao ALLO por esse caminho.

Quando o limite é atingido

Quando um app chega a 10.000 registros, novos registros são recusados, venham eles do próprio app, de um visitante pelo link publicado ou de uma importação sua. Um único aviso cobre todos esses casos:

• O criador e os administradores do app veem "O limite de registros do app foi atingido. Entre em contato para solicitar um aumento." com Ver uso, que abre Administração → Dados, e Entrar em contato.
• Todas as outras pessoas veem "O limite de registros do app foi atingido. Peça a um administrador do app para entrar em contato."

Se um colega encaminhar essa segunda mensagem para você, abra Dados, confira o medidor e clique em Entrar em contato. O pedido vai para a mesma equipe que atende quando você fala com o suporte.

Defina quem pode ver e adicionar em cada coleção

Abaixo do medidor, uma aba para cada coleção troca a visualização. As abas levam o nome das coleções, como Registros e Envios, ou "feedback" e "votos" no quadro de feedback.

Cada coleção tem suas próprias Permissões da coleção. O proprietário e os administradores sempre têm acesso total, com uma exceção: uma coleção conectada de outro app com acesso Só ver continua somente leitura para todo mundo aqui, inclusive para o criador e os administradores deste app. A tabela avisa "Dados somente de visualização. Edite no app original.", então faça essas alterações no app de origem. A linha Todas as outras pessoas vale para membros do canvas, convidados e visitantes de um link publicado. Clique em Alterar acesso para configurá-la:

• Ver e Adicionar ficam ativados ou desativados.
• Atualizar e Excluir ficam em Desativado, Apenas os próprios ou Todos.

Clique em Salvar para aplicar. Ao ativar Ver, o aviso de exposição aparece antes, e você confirma com Compartilhar registros.

Edite registros na tabela

Logo abaixo das permissões fica a tabela da coleção, que funciona como uma pequena planilha.

• Buscar filtra as linhas por texto. Filtro adiciona condições, como um campo que é, contém ou está vazio.
• A seta ao lado do nome de um campo abre Ordem crescente, Ordem decrescente, Filtrar por este campo e Ocultar campo.
• Nova linha adiciona um registro. Em uma coleção cujos campos ainda não foram definidos, Adicionar campo (o sinal de mais no fim da linha de cabeçalho) cria um.
• Clique em uma célula para editá-la. Enter salva, Esc cancela.
• O menu de cada linha tem Copiar ID do registro e Excluir. Um item excluído continua excluído mesmo que você volte para uma versão anterior do código.

As colunas Autor, Criado em e Atualizado em mostram quem adicionou cada registro e quando, então a pergunta "quem adicionou essas 200 linhas?" tem resposta.

O menu Mais ações de dados (...), no canto superior direito da tabela, reúne as ações que valem para a coleção inteira:

Uma busca na conexão nunca desfaz o seu trabalho. As linhas que você excluiu continuam excluídas, e as que você editou na tabela não são sobrescritas. Para que uma linha editada volte a seguir a origem, abra o menu dela e escolha Voltar à fonte.

Vale conhecer dois limites antes de confiar em uma sincronização:

• Se a origem não tiver ID de linha, uma linha alterada lá chega como um registro novo em vez de atualizar o antigo. O resultado da busca avisa "A origem não tem ID de linha, então uma linha alterada entra como uma nova linha".
• Registros que somem da origem continuam na coleção. O resultado da busca conta esses registros como "não estão mais na origem e continuam aqui". Exclua-os na tabela se não quiser mais mantê-los.

Importe uma planilha com Adicionar de arquivo CSV

O quadro de feedback entrou no ar em outubro, mas a equipe tem 200 linhas de feedback antigo em uma planilha. Adicionar de arquivo CSV traz essas linhas sem redigitar nada e confere cada uma antes de salvar qualquer coisa.

Os campos do app precisam estar definidos antes. Se não estiverem, o ALLO avisa "Os campos deste app ainda não foram definidos. Reconstrua o app ou solicite uma alteração para definir os campos antes de importar." Peça os campos no chat e depois importe. Um CSV pode ter até 10 MB e no máximo 10.000 linhas.

1. Abra a coleção, abra Mais ações de dados e escolha Adicionar de arquivo CSV. Selecione o arquivo.
2. Revisar importação CSV abre com o nome do arquivo no topo e suas linhas logo abaixo. Cada coluna do CSV tem um seletor de campo no cabeçalho. Colunas cujo título coincide com o nome de um campo já vêm associadas. Para as demais, escolha um campo ou escolha Ignorar esta coluna para dados de que o app não precisa.
3. Leia os chips acima da tabela: Prontas, Para corrigir, Colunas sem correspondência e Colunas ignoradas, cada um com uma contagem.
4. Corrija as linhas que precisam de ajuste. As células com problema ficam destacadas, e a coluna Erros indica os campos, como "É necessário informar um valor: Título" ou "O valor não corresponde ao tipo do campo: Votos". Uma linha com mais de 32 KB mostra "Esta linha excede 32 KB." Corrija tudo na planilha e selecione o arquivo de novo.
5. Clique em Importar linhas com a contagem, por exemplo Importar linhas (200).

Importar linhas fica desativado até que todas as linhas sejam válidas e todas as colunas estejam associadas ou ignoradas. Até lá, nada é gravado. Uma importação também nunca altera os campos do app. Para uma coluna da planilha sem campo correspondente, escolha Ignorar esta coluna no cabeçalho dela ou, se você precisar desses dados, peça o campo no chat primeiro e depois selecione o arquivo de novo. Deixar a coluna sem associação mantém Importar linhas desativado.

Alguns detalhes evitam uma segunda tentativa:

• Um campo de lista aceita texto simples separado por vírgulas, como "doce, crocante", e também a lista em JSON que Salvar como arquivo CSV gera.
• Importar o mesmo arquivo de novo, com as mesmas escolhas de coluna, não duplica as linhas. Elas são contadas como linhas que já estavam aqui.
• Arquivos grandes são importados em etapas, e uma linha de progresso mostra quantas linhas já foram concluídas.

Quando a importação termina, os chips mostram quantas linhas foram adicionadas, quantas já estavam aqui e quantas falharam. As linhas entram em lotes de até 500, e cada lote é salvo inteiro ou não é salvo. Se um lote fizer o app passar do limite de registros, nenhuma linha dele é adicionada, nem mesmo as que caberiam, e todas contam como falhas. Em um arquivo grande, lotes anteriores podem já ter sido salvos. O aviso padrão "O limite de registros do app foi atingido. Entre em contato para solicitar um aumento." aparece com Ver uso e Entrar em contato.

Revise as alterações da IA nos dados salvos

O chat também pode alterar dados salvos, mas nunca em silêncio. Peça à IA para corrigir o erro de digitação no cartão de exportação ou para excluir um registro duplicado, e ela não mexe no registro diretamente. Em vez disso, aparece no chat uma linha de revisão marcada como Aguardando aprovação. Em uma alteração, ela mostra o valor atual de cada campo riscado ao lado do novo valor. Em uma exclusão, mostra o registro que seria removido.

Nada muda até você escolher Aplicar. Descartar cancela a proposta e deixa o registro como estava. Depois disso a linha mostra Aplicado ou Descartado, e o chat guarda o registro do que aconteceu. Aplicar espera terminar qualquer construção que esteja em andamento.

Itens novos que a IA adiciona são salvos sem essa revisão, já que adicionar um item não sobrescreve nada que alguém tenha salvado.

Conecte dados externos em Dados conectados

Dados conectados lista todas as fontes das quais o app lê dados:

• Um serviço externo. Cada um aparece como "Busca dados de" seguido do endereço, com o provedor e "chave guardada com segurança" logo abaixo. Desconectar remove a fonte, e a chave Só atualizar os dados mantém os dados dela atualizados em um agendamento.
• Outro app deste canvas. Cada um aparece como "Usa dados de" seguido do nome desse app, com Só ver ou Ver e editar. Desconectar remove só o vínculo; o app original mantém os dados e os arquivos dele.
• Uma pasta local. Pasta local conecta uma pasta deste dispositivo. O acesso à pasta fica no dispositivo, e as cópias que você selecionar são compartilhadas com quem tem acesso ao objeto.

Quando não há nada conectado, a seção mostra o formulário de conexão (Endpoint de dados (URL), Chave de API e Conectar e testar) ou sugere que você peça no chat, algo como "conecte meus dados". No fim da seção, Apps que usam os dados deste app lista os apps que leem dados deste.

Agende tarefas em Automação

Automação executa uma Ação agendada para o app:

• Reexecutar a tarefa do app executa de novo, em um agendamento, o último pedido concluído. Cada execução consome créditos de IA. O padrão é uma vez por dia, e o agendamento atual fica visível. É preciso ter um pedido concluído no chat antes.
• Só atualizar os dados busca dados novos na conexão. É gratuito e não altera o app. Roda a cada 15 minutos, a cada hora ou uma vez por dia, e exige uma conexão antes.

Escolha uma das opções, confira o Intervalo de repetição e ative a chave. Para trocar a ação depois, pause a automação primeiro. Mais abaixo, Histórico de execuções lista cada execução como Concluído, Falhou, Ignorado, Precisa de você ou Iniciado por você.

Se o espaço de trabalho ficar sem créditos de IA, a próxima reexecução agendada é ignorada e a automação é pausada. Adicione créditos e ative a automação de novo.

Publique versões e defina o link em Compartilhamento

Compartilhamento reúne o que os visitantes veem:

• Versão publicada mostra a versão no ar, como "Versão 3", ou Não publicado. Publicar compartilha a versão mais recente, e Cancelar publicação fecha o link. Os visitantes continuam usando a versão publicada enquanto você edita a próxima.
• Endereço mostra o link do app com Copiar link e Abrir em nova aba.
• Qualquer pessoa com o link pode ver deixa o link abrir sem login. Desative a opção e só quem foi convidado para o canvas consegue abrir; Convidar pessoas abre o compartilhamento do canvas.
• Busca e prévia do link guarda a Descrição que aparece abaixo do nome do app nos resultados de busca e nas prévias de links. Clique em Salvar depois de editar. O título da página é sempre o nome do app, e as prévias de links usam uma captura da página publicada quando houver uma disponível.

Acompanhe visitas e atividade em Estatísticas

Estatísticas é exclusiva do criador. A seção conta as Visualizações (carregamentos da página publicada, incluindo visitantes do link anônimo) e Pessoas/navegadores, e mostra a Última visualização. Visitas do proprietário e dos administradores identificados, assim como as prévias, ficam de fora, então os seus próprios testes não inflam os números.

Alterne entre Por dia · 90 dias e Por hora · 7 dias, clique em Atualizar para ver os números mais recentes ou em Exportar JSON para guardar uma cópia. Mais abaixo, Coleções mostra os Registros e os Arquivos de cada coleção, um gráfico de Adições diárias e quando houve a Última adição e a Última alteração.

No quadro de feedback, isso responde à pergunta do início deste guia: se as Visualizações sobem depois que o link é enviado, mas a Última adição da coleção de feedback não muda, os entrevistados estão abrindo o quadro sem adicionar nada.

Proteja as chaves em Segredos

Segredos guarda as chaves que o app usa para acessar serviços externos, como uma chave de API de um CRM. Só o criador as gerencia. A IA (o modelo) nunca vê os valores; o ALLO envia uma chave apenas ao serviço para o qual ela foi aprovada.

1. Clique em Adicionar segredo. Preencha Nome e Valor. Adicionar outra chave cria mais linhas, para você salvar várias de uma vez.
2. Clique em Salvar.

Cada chave passa a ter sua própria linha com quatro botões: Copiar nome, Editar, Mostrar valores (o olho) e Excluir segredos (a lixeira). Editar renomeia a chave ou substitui o valor; deixe o valor em branco para manter o atual.

Mostrar valores não pede nenhuma senha extra. O valor aparece na hora, com um botão de copiar e Ocultar valores, e volta a ficar oculto sozinho depois de 15 segundos ou assim que você muda para outra aba do navegador.

Excluir uma chave interrompe todas as operações que a utilizam, e isso não pode ser desfeito. Com mais de uma chave, selecione várias e use Excluir segredos selecionados. Abaixo das chaves, Operações aprovadas lista o que o app foi autorizado a fazer com elas.

Exclua o app para sempre

No fim de Dados, Apps conectados e exclusão abre a Zona de risco com Excluir o app para sempre. Essa ação exclui todas as cópias do app e tudo o que ele salvou. Nem desfazer nem versões anteriores trazem o app de volta, então use antes Salvar como arquivo CSV em cada coleção que você quiser guardar. Se outros apps leem dados deste, um segundo aviso, Apps conectados usam estes dados, lista esses apps antes de você poder escolher Aposentar mesmo assim.

O que pode dar errado

Importar linhas continua desativado. Confira os chips:

• Para corrigir acima de zero: algumas linhas têm erros. A coluna Erros indica os campos.
• Colunas sem correspondência acima de zero: escolha um campo para cada uma ou escolha Ignorar esta coluna.

"Os campos deste app ainda não foram definidos." Peça no chat os campos que o app deve guardar e importe de novo.

"Os campos do app mudaram. Selecione o CSV novamente para revisar as associações." Alguém alterou o app enquanto você revisava o arquivo. Selecione o CSV de novo.

Algumas linhas importadas falharam. Se o aviso "O limite de registros do app foi atingido." apareceu junto, a importação teria ultrapassado o limite de registros, então todas as linhas daquele lote falharam, inclusive as que caberiam. Sem esse aviso, siga a mensagem exibida com a falha e selecione o arquivo de novo; as linhas que já foram salvas não são adicionadas duas vezes.

A revisão mostra "Esta linha excede 32 KB." Essa linha bloqueia Importar linhas para o arquivo inteiro. Encurte a linha na planilha e selecione o arquivo corrigido de novo.

"O limite de registros do app foi atingido." O criador e os administradores clicam em Entrar em contato. As demais pessoas pedem a um administrador do app que faça isso.

A IA disse que alterou um registro, mas a tabela continua igual. A alteração está esperando no chat. Encontre a linha de revisão e escolha Aplicar.

Uma atualização agendada foi ignorada. O espaço de trabalho ficou sem créditos de IA e a automação foi pausada. Adicione créditos e ative a automação de novo.

Você não vê Estatísticas nem Segredos. Só o criador vê essas seções.

Um colega não consegue abrir Administração. Só o criador e os administradores do app veem essa aba. Peça ao criador que adicione o colega em Visão geral → Administradores do app.

O valor de uma chave sumiu. Os valores exibidos ficam ocultos de novo depois de 15 segundos ou quando você muda de aba. Clique em Mostrar valores outra vez.

Se nada disso resolver, fale com o suporte informando o ID do app que aparece em Visão geral e a mensagem exata que você vê.