📌 Tutorial: Como Criar um BOT no AppSheet para Registrar Ações em Outra Aba

📖 O que vamos fazer?

Vamos criar um BOT no AppSheet que, sempre que um usuário selecionar um valor na coluna “Morador”, registre automaticamente:
✅ O e-mail do usuário que fez a ação.
✅ A data e hora da modificação.
✅ O valor escolhido na coluna “Morador”.

Os dados serão salvos em outra aba (outra tabela) do Google Sheets.

🔧 Passo 1: Configurar o Google Sheets

Antes de configurar o AppSheet, precisamos garantir que o Google Sheets está pronto.

1.1 Criar duas abas na planilha

1. Aba principal:

   • Nome: CadastroDeMoradores (ou outro nome que você já tenha).
   • Colunas principais:
     • ID (chave primária, tipo Text, com fórmula UNIQUEID()).
     • Morador (tipo Enum, onde os botões estarão).

2. Aba onde as modificações serão registradas:

   • Nome: HistoricoModificacoes
   • Colunas:
     • ID (tipo Text, com UNIQUEID()).
     • EmailUsuario (tipo Email).
     • DataHora (tipo DateTime).
     • ValorMorador (tipo Text).

🛠️ Passo 2: Criar um BOT no AppSheet

Agora, vamos criar um BOT para registrar os cliques na aba HistoricoModificacoes.

2.1 Acessar a seção de Automação

1. No AppSheet, clique em “Automation” no menu lateral esquerdo.
2. Clique no botão “Create a bot” para adicionar um novo BOT.

2.2 Configurar o Trigger (Evento que ativa o BOT)

Agora, precisamos definir quando o BOT será acionado.

1. No painel do BOT, clique em “Add Event”.
2. Escolha “When data changes”.
3. Configure assim:
   • Table: CadastroDeMoradores (ou a tabela onde está a coluna Morador).
   • Update event: Marque apenas “ADDS” e “UPDATES”.
   • Condition: Adicione esta expressão:

     ISNOTBLANK([Morador])
     

     Isso garante que o BOT só será acionado quando um valor for selecionado.

2.3 Criar a Ação para Salvar os Dados

Agora, vamos criar a ação que adicionará uma linha na outra aba (HistoricoModificacoes).

1. No painel do BOT, clique em “Add a step” > “Run a task”.
2. Clique em “Create a new task” e configure assim:
   • Name: “Salvar Modificação”
   • Task Type: “Data: Add a new row”
   • Table: HistoricoModificacoes
   • Values para inserir na nova linha:
     • ID → UNIQUEID()
     • EmailUsuario → USEREMAIL()
     • DataHora → NOW()
     • ValorMorador → [Morador]

Clique em Salvar.

2.4 Testar o BOT

1. Vá até o aplicativo e edite um registro da tabela CadastroDeMoradores.
2. Escolha um valor na coluna Morador.
3. Salve a alteração.
4. Agora, vá até o Google Sheets e abra a aba HistoricoModificacoes.
5. Você verá uma nova linha com o e-mail do usuário, data/hora e o valor escolhido. 🎉

📌 Conclusão

Agora, sempre que um usuário selecionar uma opção na coluna Morador, o BOT registrará automaticamente as informações em outra aba. 🚀

Se precisar de mais detalhes ou ajustes, me avise! 😊