<>JavaScript Block + KB For AI Agent

JavaScript Block (Datacrazy)

KnowledgeBase (KB, Knowledge Base) of the JavaScript Block your AI Agents help you.

Access ChatGPT directly at this link → https://chatgpt.com/share/69d47b77-a718-83e9-8628-e85bfe0e15aa

PDF for Claude Code → https://drive.google.com/file/d/1F7oSbACzdzzf7QS6QG9GjEkFgXzyW-XD/view?usp=sharing

The <> JavaScript block is one of the, if not the most powerful of the blocks, given its broad and massive usefulness, letting you use programming for validations and configurations of different data outputs.

This feature assumes prior knowledge of programming.
Support does not cover introductory questions about logic or code.

Technical questions about how the block works can be sent to support as usual.

Recommendation: Learn the basics of JavaScript — this will be a milestone in your use of Datacrazy.

What you’re going to learn

• Comments

• Parameters

• Variables and Constants

• Objects and Arrays

• GET / POST

• Webhook

• Lead and Deal data

• Data saving

• JSON return

• Best practices

Comments

Comments are ignored by the system.

Single line

// Isso é um comentário

Block

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

Common mistake

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

Variables

They store values that can change:

let fruta = 'maçã';

Array (list)

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

Constants

They can't be changed:

const nomeLead = "Tiger Allan";

Error:

Identificador 'nomeLead' já foi declarado

Objects

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

Access:

dadosLead.leadName

Usage:

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

Arrays

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

Indexes:

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

Example:

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

Change:

frutas[1] = "abacaxi";

GET vs POST

Method

Use

Webhook (data input)

JSON example:

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

Capture data

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

Identify Lead

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

⚠️ Mandatory rule:

• Name + Phone
  or

• Name + Email

Save data

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

🔁 Full code

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")
};

🔍 Quick explanation

• datasources → reads webhook data

• setValue → identifies the lead

• setAdditionalValue → saves data

• return → returns JSON

Available parameters

They depend on conditioning in the flow

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

Others

additionalFields, datasourceJsonPath

Instagram

instagramCommentId, instagramMediaId, instagramCommentDate, instagramName

Messenger

facebookCommentId, facebookMediaId, facebookCommentDate, facebookName

AI

lastAiText, aiConsumedTokens

JSON rules

Use correctly:

• string → text

• number → numbers

• boolean → true/false

• null → absence

Avoid:

• "10" (number as string)

• "true"

• "" as empty

• undefined

• NaN / Infinity

Decimals

Correct:

10.5

Wrong:

10,5
"10.5"

Monetary values

Recommended

{ "priceCents": 1050 }

✔️ Alternative

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

⚡ Best practices

• Always use await

• Validate data before using it

• Name variables clearly

• Use comments

• Never return invalid JSON