Use o ChatGPT já com a base de conhecimento → 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

🧠 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:

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:

obj?.campo

Exemplo:

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:

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:

fetch()
Date()
JSON

Não permitido:

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

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

Erro

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

📌 Funções Disponíveis

Campos do CRM

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

Campos adicionais

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

Datasources

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

// ##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

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

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

// Isso é um comentário

✔ Bloco

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

⚠ Erro comum

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

📦 Variáveis

Guardam valores que podem mudar:

let fruta = 'maçã';

Array (lista)

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

🔒 Constantes

Não podem ser alteradas:

const nomeLead = "Tiger Allan";

❌ Erro:

Identificador 'nomeLead' já foi declarado

🧱 Objetos

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

Acesso:

dadosLead.leadName

Uso:

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

📚 Arrays

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

Índices:

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

Exemplo:

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

Alteração:

frutas[1] = "abacaxi";

🌐 GET vs POST

Método

Uso

🔌 Webhook (entrada de dados)

Exemplo JSON:

{
  "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

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

🎯 Identificar Lead

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

⚠ Regra obrigatória:

• Nome + Telefone
  ou

• Nome + Email

💾 Salvar dados

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

🔁 Código completo

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:

10.5

❌ Errado:

10,5
"10.5"

💰 Valores monetários

✔ Recomendado

{ "priceCents": 1050 }

✔ Alternativo

{ "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