---
title: "Bloco JavaScript e base de conhecimento para agente de IA"
description: "Use o bloco JavaScript das automações do Datacrazy para validar e transformar dados e alimentar a base de conhecimento (KB) do agente de IA."
url: https://help.datacrazy.io/pt-br/articles/10670790-bloco-javascript-e-base-de-conhecimento-para-agente-de-ia
collection: "Bloco de ação"
updated: 2026-11-18
language: pt-br
alternates: [es, en]
---

# Bloco JavaScript e base de conhecimento para agente de IA

Use o bloco JavaScript das automações do Datacrazy para validar e transformar dados e alimentar a base de conhecimento (KB) do agente de IA.

![](https://staticfiles.gleap.io/attachments/20260610033642_2508.png)

Use o ChatGPT já com a base de conhecimento → [https://chatgpt.com/share/6a28ddc0-6628-83e9-9e53-8dacedc4c19c](https://chatgpt.com/share/6a28ddc0-6628-83e9-9e53-8dacedc4c19c) ou então baixe o .PDF e alimete seu agente com esta base de conhecimento(KB), no link em anexo abaixo:

[https://drive.google.com/file/d/1JmGq1J-H\_oqtGT3gqXLftgWiCDdEQghq/view?usp=sharing](https://drive.google.com/file/d/1JmGq1J-H_oqtGT3gqXLftgWiCDdEQghq/view?usp=sharing)

# 🧠 Padrão Oficial — Bloco JavaScript (CRM Datacrazy)

## Objetivo

Utilize este padrão sempre que precisar gerar códigos para o bloco JavaScript do CRM Datacrazy.

Todo código gerado deve ser:

-   Seguro
    
-   Validado
    
-   Resiliente a erros
    
-   Pronto para produção
    
-   Fácil de manter
    
-   Padronizado
    

* * *

# 📌 Contexto do Ambiente

Os scripts serão executados dentro do bloco JavaScript do CRM Datacrazy.

Características do ambiente:

-   JavaScript nativo (sem bibliotecas externas)
    
-   Suporte a `async/await`
    
-   Manipulação de campos do lead
    
-   Consumo de APIs via `fetch`
    
-   Acesso a datasources
    
-   Persistência de dados em campos do CRM
    
-   Retorno obrigatório em formato JSON
    

* * *

# 📋 Informações Necessárias Antes de Gerar o Código

Sempre solicitar ou considerar:

### Origem dos dados

Exemplos:

-   Webhook
    
-   API
    
-   Campo do CRM
    
-   Datasource
    

### Nome do datasource

Exemplo:

```javascript
Api-request-1

```

### Payload de exemplo

Caso os dados venham de um webhook, solicitar o JSON recebido.

#### Explicação para usuários iniciantes

**Payload:** conjunto de dados recebidos pelo sistema.

* * *

# ⚠ Regras Obrigatórias

## 1\. Utilizar async/await

Sempre utilizar operações assíncronas com `await`.

* * *

## 2\. Validar dados antes de acessar

Utilizar acesso seguro:

```javascript
obj?.campo

```

Exemplo:

```javascript
if (data?.telefone) {
  // processamento
}

```

* * *

## 3\. Nunca assumir que um dado existe

Todo valor deve ser validado antes de ser utilizado.

* * *

## 4\. Trabalhar com fatos

Nunca assumir que uma informação está correta apenas porque foi informada.

Sempre validar e confirmar através dos dados disponíveis.

* * *

## 5\. Datas para agendamento

Quando o resultado for utilizado em agendamentos do CRM, o formato de saída deve ser obrigatoriamente:

```text
2026-03-31T00:59:00:000-03:00

```

A data e hora podem variar, porém o formato deve permanecer exatamente igual.

Qualquer alteração na estrutura poderá impedir o funcionamento do agendamento.

* * *

## 6\. Não utilizar bibliotecas externas

Permitido:

```javascript
fetch()
Date()
JSON

```

Não permitido:

```javascript
moment
axios
lodash
dayjs

```

* * *

## 7\. Utilizar try/catch

Todo código deve possuir tratamento de exceções.

* * *

## 8\. Validar o lead antes de salvar

Sempre garantir que o lead existe e que os dados são válidos antes de gravar informações.

* * *

## 9\. Nunca interromper o fluxo

Todo erro deve ser tratado adequadamente.

O código não deve quebrar a execução do fluxo.

* * *

# 🔁 Padrão de Retorno

## Sucesso

```javascript
return {
  sucesso: true,
  erro: false,
  dados: {
    // resultado
  }
};

```

* * *

## Erro

```javascript
return {
  sucesso: false,
  erro: true,
  mensagem: "Descrição clara do erro",
  debug: error?.message || null
};

```

* * *

# 📌 Funções Disponíveis

## Campos do CRM

```javascript
await session.getValue("campo");
await session.setValue("campo", valor);

```

* * *

## Campos adicionais

```javascript
await session.getAdditionalValue("campo");
await session.setAdditionalValue("campo", valor);

```

* * *

## Datasources

```javascript
await session.datasources["NomeDoDatasource"];

```

* * *

# ✅ Boas Práticas

-   Utilizar nomes de variáveis claros
    
-   Validar absolutamente todos os dados
    
-   Evitar sobrescrever informações existentes
    
-   Retornar dados úteis para depuração
    
-   Comentar trechos importantes
    
-   Pensar sempre em ambiente de produção
    
-   Priorizar legibilidade e manutenção
    

* * *

# 🧩 Estrutura Base Recomendada

```javascript
// ##CONFIG##

const DATASOURCE = "Api-request-1";

let data = null;

try {
  data = await session.datasources[DATASOURCE];

  if (!data) {
    throw new Error(`Datasource "${DATASOURCE}" não encontrado`);
  }

  if (!data?.campoObrigatorio) {
    throw new Error(
      "Campo obrigatório não encontrado no payload"
    );
  }

  const valor = data.campoObrigatorio;

  const existente = await session.getValue("campoCRM");

  if (!existente) {
    await session.setValue("campoCRM", valor);
  }

  return {
    sucesso: true,
    erro: false,
    dados: {
      valor
    }
  };

} catch (error) {
  return {
    sucesso: false,
    erro: true,
    mensagem: error.message,
    debug: data
  };
}

```

* * *

# 🆘 Orientação para Diagnóstico de Problemas

Caso algo não funcione corretamente, solicitar ao usuário:

### Erro exibido

> Copie o erro (botão direito → copiar) e envie aqui.

### Captura de tela

> Se possível, envie um print da tela.

### Payload recebido

> Envie o JSON recebido pelo webhook ou datasource.

* * *

# 📖 Termos Simplificados

### Payload

Dados recebidos pelo sistema.

### Erro

Mensagem que informa o motivo da falha.

### Datasource

Fonte de dados utilizada pelo bloco JavaScript.

* * *

# 🎯 Resultado Esperado

Todo código gerado deve ser:

-   Seguro
    
-   Validado
    
-   Robusto
    
-   Padronizado
    
-   Fácil de entender
    
-   Preparado para produção
    
-   Compatível com o CRM Datacrazy
    

Ao finalizar qualquer análise ou geração de código, responder apenas:

**Como posso ajudar?**

## //////////////////////////////////////////////////////////////////

## 🧠 Bloco JavaScript (Datacrazy)

## 🤖 **Documentação + KB, Base de conhecimento do Bloco JavaScript para seu Agentes de IA auxiliar você.**

**Acesse o ChatGPT Diretamente neste Link →**[**https://chatgpt.com/share/69e58457-b630-83e9-b8ef-8c7dbf0653ab**](https://chatgpt.com/share/69e58457-b630-83e9-b8ef-8c7dbf0653ab)

**KB Para Claude Code em .PDF→** [**https://drive.google.com/file/d/1zlkvheDSY7npEQk1MNfSpMqfC9tqovqD/view?usp=sharing**](https://drive.google.com/file/d/1zlkvheDSY7npEQk1MNfSpMqfC9tqovqD/view?usp=sharing)

* * *

![](https://staticfiles.gleap.io/gattachments/zRqK0vbxjOk7EHRROAZCaYvlJQXS0YIus3VzevORJ6jxFbPYRH7czjAr9Zc7D8SEkfbUQzaRNMl.png)

O bloco <> JavaScript é um dos, se não o mais poderoso dos blocos, dado a ampla e gigantesca utilidade, podendo usar programação para validações e configurações de diferentes saídas de dados.

⚠ Este recurso pressupõe conhecimento prévio em programação.  
O suporte **não cobre dúvidas introdutórias** sobre lógica ou código.

👉 Dúvidas técnicas sobre funcionamento do bloco podem ser enviadas ao suporte normalmente.

💡 Recomendação: Aprenda o básico de JavaScript — isso será um marco no uso da Datacrazy.

* * *

## 📚 O que você vai aprender

-   Comentários
    
-   Parâmetros
    
-   Variáveis e Constantes
    
-   Objetos e Arrays
    
-   GET / POST
    
-   Webhook
    
-   Dados de Lead e Negócio
    
-   Salvamento de dados
    
-   Retorno JSON
    
-   Boas práticas
    

* * *

## 💬 Comentários

Comentários são ignorados pelo sistema.

### ✔ Linha única

```javascript
// Isso é um comentário
```

### ✔ Bloco

```javascript
/*
Tudo aqui será ignorado
Inclusive código
*/
```

### ⚠ Erro comum

```javascript
isso não é comentário // ❌ vai quebrar o código
```

* * *

## 📦 Variáveis

Guardam valores que podem mudar:

```javascript
let fruta = 'maçã';
```

### Array (lista)

```javascript
let frutas = ["uvaBah", "banana", "maçã"];
```

* * *

## 🔒 Constantes

Não podem ser alteradas:

```javascript
const nomeLead = "Tiger Allan";
```

❌ Erro:

```javascript
Identificador 'nomeLead' já foi declarado
```

* * *

## 🧱 Objetos

```javascript
const dadosLead = {
  leadName: "Tiger Allan",
  leadPhone: 5547992185579
};
```

### Acesso:

```javascript
dadosLead.leadName
```

### Uso:

```javascript
await session.setAdditionalValue("apelido", dadosLead.leadName);
```

* * *

## 📚 Arrays

```javascript
let frutas = ["uvaBah", "banana", "maçã"];
```

### Índices:

```javascript
frutas[0] // uvaBah
frutas[1] // banana
frutas[2] // maçã
```

### Exemplo:

```javascript
await session.setAdditionalValue("fruta-preferida", frutas[1]);
```

### Alteração:

```javascript
frutas[1] = "abacaxi";
```

* * *

## 🌐 GET vs POST

Método

Uso

<table data-id="977bdb73-28bd-40ce-9e85-d4f3cd015f26" style="min-width: 50px;"><colgroup><col style="min-width: 25px;"><col style="min-width: 25px;"></colgroup><tbody><tr><td colspan="1" rowspan="1"><p data-id="f2ea009f-e200-443c-8bde-78807ee9fbe0">GET</p></td><td colspan="1" rowspan="1"><p data-id="f2207b26-25e8-4d84-a7d2-7344c52baff2">Buscar dados</p></td></tr><tr><td colspan="1" rowspan="1"><p data-id="7788ebe8-96b3-44f9-bb87-613178f73e63">POST</p></td><td colspan="1" rowspan="1"><p data-id="148a5da5-fd55-4bdb-b062-c0d941e73a52">Enviar dados</p></td></tr></tbody></table>

* * *

## 🔌 Webhook (entrada de dados)

### Exemplo JSON:

```javascript
{
  "dadosLead": {
    "leadName": "Tiger Allan2",
    "leadPhone": "5547992185579Bah",
    "fruta": "uvaBah"
  },
  "dadosEmpresaLead": {
    "nomeEmpresa": "ATECH Company",
    "sloganEmpresa": "ATECH tende bem",
    "urlLogo": "https://i.imgur.com/Pis9lRg.png"
  },
  "assets": {
    "valorEmReais": 997,
    "valorReaisComCentavos": 997.89,
    "falida": null
  }
}
```

* * *

## 📥 Capturar dados

```javascript
const webhook = session.datasources["Api-request-1"];
```

* * *

## 🎯 Identificar Lead

```javascript
await session.setValue("leadName", webhook.dadosLead.leadname);
await session.setValue("leadPhone", webhook.dadosLead.leadPhone);
```

⚠ Regra obrigatória:

-   Nome + Telefone  
    ou
    
-   Nome + Email
    

* * *

## 💾 Salvar dados

```javascript
await session.setAdditionalValue("apelido", webhook.dadosLead.leadName);
```

* * *

## 🔁 Código completo

```javascript
const webhook = await session.datasources["Api-request-1"];

await session.setValue("leadName", webhook.dadosLead.leadname);
await session.setValue("leadPhone", webhook.dadosLead.leadPhone);

await session.setAdditionalValue("apelido", webhook.dadosLead.leadName);

return {
  nomeLead: await session.getValue("leadName"),
  phoneLead: await session.getValue("leadPhone"),
  businessId: await session.getValue("businessId")
};
```

* * *

## 🔍 Explicação rápida

-   `datasources` → lê dados do webhook
    
-   `setValue` → identifica o lead
    
-   `setAdditionalValue` → salva dados
    
-   `return` → retorna JSON
    

* * *

## 📊 Parâmetros disponíveis

⚠ Dependem de condicionamento no fluxo

### IDs

leadId, businessId, stageId, instanceId, attendantId, productId, conversationId, threadId

### Lead

leadName, leadFirstName, leadEmail, leadPhone, leadCompany, leadCity, leadState, leadZip, leadAddress, leadComplement, leadBlock, leadSite, leadTaxId, leadSource, leadSourceId, leadSourceUrl, leadCtwaId, leadNotes, birthDate

### Business

businessTotal, businessCode, businessExternalId, JSONbusinessProduct

### Product

productName, productSku, productPrice

### Attendant

leadAttendant, businessAttendant, ticketAttendant

### Workspace

currentDate, companyName, companyEmail

### Conversations

threadData, chatAttendant, department, threadCode

### Outros

additionalFields, datasourceJsonPath

### Instagram

instagramCommentId, instagramMediaId, instagramCommentDate, instagramName

### Messenger

facebookCommentId, facebookMediaId, facebookCommentDate, facebookName

### AI

lastAiText, aiConsumedTokens

* * *

## 📤 Regras JSON

✔ Use corretamente:

-   string → texto
    
-   number → números
    
-   boolean → true/false
    
-   null → ausência
    

❌ Evite:

-   `"10"` (número como string)
    
-   `"true"`
    
-   `""` como vazio
    
-   `undefined`
    
-   `NaN` / `Infinity`
    

* * *

## 🔢 Decimais

✔ Correto:

```javascript
10.5
```

❌ Errado:

```javascript
10,5
"10.5"
```

* * *

## 💰 Valores monetários

### ✔ Recomendado

```javascript
{ "priceCents": 1050 }
```

### ✔ Alternativo

```javascript
{ "amount": 10.5, "currency": "BRL" }
```

* * *

## ⚡ Boas práticas

-   Sempre use `await`
    
-   Valide dados antes de usar
    
-   Nomeie variáveis claramente
    
-   Use comentários
    
-   Nunca retorne JSON inválido
