Context - Jelou AI Docs

The ctx object is the second parameter of every handler. It contains info about the company, bot, user, trigger type, and provides access to secrets, messaging, memory, and logging.

handler: async (input, ctx, request) => {
  ctx.log("Request received", {
    company: ctx.company.name,
    bot: ctx.bot.channel,
    user: ctx.user.id,
    trigger: ctx.trigger.type,
  });
}

Reference

Property	Type	Description
`ctx.functionSlug`	`string`	Function slug
`ctx.company`	`{ id, name }`	Company of the request
`ctx.bot`	`{ id, name, channel }`	Bot that originated the request
`ctx.user`	`{ id, names?, roomId? }`	Conversation user
`ctx.conversation`	`{ id?, ... }`	Conversation data
`ctx.operator`	`{ id?, ... }`	Assigned operator
`ctx.trigger`	`TriggerInfo`	Trigger type (http, cron, event)
`ctx.env`	`EnvAccessor`	Access to secrets
`ctx.params`	`Record<string, string>`	Route parameters
`ctx.query`	`Record<string, string>`	Query string params
`ctx.jelou`	`JelouSDK`	WhatsApp messaging client
`ctx.memory`	`MemorySDK`	Key-value session memory
`ctx.method`	`string`	HTTP method (GET, POST, etc.)
`ctx.path`	`string`	Request path
`ctx.requestId`	`string`	Unique request UUID
`ctx.isCron`	`boolean`	`true` if cron trigger
`ctx.isEvent`	`boolean`	`true` if event trigger
`ctx.isHttp`	`boolean`	`true` if HTTP request
`ctx.skillId`	`string \| null`	Brain Studio workflow ID
`ctx.executionId`	`string \| null`	Brain Studio execution ID
`ctx.log()`	`(...args) => void`	Structured logger

Identity

handler: async (input, ctx) => {
  ctx.company.id;    // 42
  ctx.company.name;  // "Shop ABC"
  ctx.bot.id;        // "bot-123"
  ctx.bot.channel;   // "whatsapp"
  ctx.user.id;       // 99
  ctx.user.names;    // "Maria Garcia" (optional)
}

Trigger

HTTP
Cron
Event

if (ctx.isHttp) {
  ctx.trigger; // { type: "http" }
}

if (ctx.isCron) {
  ctx.trigger.cron;     // "0 9 * * *"
  ctx.trigger.cronName; // "daily-reminder" (optional)
}

if (ctx.isEvent) {
  ctx.trigger.event; // "payment.completed"
}

Request

export default define({
  config: { path: "/users/:id" },
  handler: async (input, ctx) => {
    ctx.method;      // "GET"
    ctx.path;        // "/users/42"
    ctx.params.id;   // "42"
    ctx.query.format // "json" (from ?format=json)
    ctx.requestId;   // "a1b2c3d4-..."
  },
});

Environment (secrets)

const apiKey = ctx.env.get("CRM_API_KEY"); // string | undefined
ctx.env.has("WEBHOOK_SECRET");              // boolean
ctx.env.toObject();                         // Record<string, string>

Internal variables with __FN_ prefix are blocked — ctx.env.get("__FN_COMPANY_ID") returns undefined.

Messaging (`ctx.jelou`)

if (ctx.jelou.available) {
  await ctx.jelou.send({ type: "text", to: "+593987654321", text: "Hello" });
}

Messaging guide

14 message types, HSM templates, and error handling.

Memory (`ctx.memory`)

if (ctx.memory.available) {
  const step = await ctx.memory.get("step", "start");
  await ctx.memory.set("step", "confirm", 3600);
}

Memory guide

Primitives, JSON, TTL, limits, and common patterns.

Logging

ctx.log() writes structured JSON with automatic metadata:

ctx.log("Processing order", { phone: input.phone });
// stdout: { "requestId": "...", "function": "my-fn", "company": 42, "timestamp": "...", "args": [...] }

Messaging

Send WhatsApp with ctx.jelou.

Memory

Persist data with ctx.memory.

Secrets

Encrypted environment variables.

Authentication

Runtime tokens and public functions.

​Reference

​Identity

​Trigger

​Request

​Environment (secrets)

​Messaging (ctx.jelou)

Messaging guide

​Memory (ctx.memory)

Memory guide

​Logging

Messaging

Memory

Secrets

Authentication

Reference

Identity

Trigger

Request

Environment (secrets)

Messaging (`ctx.jelou`)

Memory (`ctx.memory`)

Logging