Como criar uma Função no Uappi Ágora 1.4

O que é uma Função?

As Funções são códigos personalizados responsáveis por processar os eventos capturados pelo Uappi Ágora.

Sempre que um evento é disparado, a função correspondente é executada para realizar uma ação, como integrar sistemas, consultar APIs ou automatizar processos.

---

Pré-requisitos

Antes de criar uma Função, é recomendado possuir:

• Conhecimento em JavaScript (Uappi Ágora Provider) ou TypeScript (Supabase);
• Conhecimento em APIs e requisições HTTP;
• Familiaridade com JSON;
• Compreensão de async/await e promises.

Também é possível utilizar LLMs como assistentes durante o desenvolvimento das Funções.

---

Como criar uma Função

1. Selecione o Evento

Ao iniciar a criação de uma Função, selecione o evento que será responsável por disparar sua execução.

Os eventos disponíveis são organizados por categorias e podem ser localizados utilizando o campo de busca e os filtros disponíveis.

---

2. Escolha o Provider

Na etapa seguinte, selecione o Provider responsável pela execução da Função.

O Ágora permite utilizar diferentes Providers, conforme a configuração realizada anteriormente.

---

3. Informe o nome da Função

Defina um nome e uma descrição para facilitar a identificação da Função.

Utilize nomes objetivos que representem claramente a finalidade da automação.

---

4. Faça a implementação

Na etapa Implementação, desenvolva o código ou informe o endpoint responsável pela execução da Função.

Ao criar uma nova Função, o Ágora disponibiliza automaticamente um template básico para auxiliar no desenvolvimento.

O código utilizado dependerá do Provider escolhido.

---

🎥 Tutorial em vídeo

Como criar funções no Ágora

---

Como testar uma Função

Antes de colocar a Função em produção, utilize o Playground para validar sua implementação.

Com o Playground é possível:

• Testar a Função antes da publicação;
• Visualizar um payload de exemplo;
• Simular diferentes cenários;
• Identificar erros e problemas de validação.

Utilize a opção Deploy & Testar para realizar os testes necessários.

Importante: As alterações não são salvas automaticamente. Utilize Salvar rascunho ou Salvar em produção para registrar as modificações.

---

Variáveis de ambiente

Caso a Função utilize tokens, API Keys ou outras credenciais, configure essas informações na aba Variáveis.

As Variáveis de Ambiente permitem armazenar informações sensíveis de forma segura e reutilizá-las em diferentes Funções.

Importante: Nunca armazene credenciais diretamente no código da Função.

---

Boas práticas

• Teste a Função antes de publicá-la.
• Utilize Variáveis de Ambiente para armazenar credenciais.
• Valide os dados recebidos no payload.
• Faça o tratamento adequado de erros.
• Utilize HTTPS em integrações externas.

---

Perguntas frequentes

Preciso saber programação para criar uma Função?

Sim. É recomendado possuir conhecimentos em JavaScript ou TypeScript, dependendo do Provider utilizado. LLMs podem ser utilizadas como apoio durante o desenvolvimento.

---

Posso testar a Função antes de publicá-la?

Sim. Utilize o Playground para executar testes, validar o payload e identificar possíveis erros antes da publicação.

---

O código é salvo automaticamente?

Não. É necessário utilizar Salvar rascunho ou Salvar em produção para registrar as alterações realizadas.

---

Onde devo armazenar API Keys e tokens?

Utilize as Variáveis de Ambiente. Elas permitem armazenar credenciais de forma segura e reutilizá-las em diferentes Funções.