Context - Jelou AI Docs

O objeto ctx é o segundo parâmetro de todo handler. Contém informações da empresa, bot, usuário, tipo de trigger, e dá acesso a secrets, mensagens, memória e logging.

handler: async (input, ctx, request) => {
  ctx.log("Requisição recebida", {
    company: ctx.company.name,
    bot: ctx.bot.channel,
    user: ctx.user.id,
  });
}

Referência

Propriedade	Tipo	Descrição
`ctx.functionSlug`	`string`	Slug da função
`ctx.company`	`{ id, name }`	Empresa da requisição
`ctx.bot`	`{ id, name, channel }`	Bot que originou a requisição
`ctx.user`	`{ id, names?, roomId? }`	Usuário da conversa
`ctx.trigger`	`TriggerInfo`	Tipo de trigger (http, cron, event)
`ctx.env`	`EnvAccessor`	Acesso a secrets
`ctx.params`	`Record<string, string>`	Parâmetros de rota
`ctx.query`	`Record<string, string>`	Query string params
`ctx.jelou`	`JelouSDK`	Cliente de mensagens WhatsApp
`ctx.memory`	`MemorySDK`	Memória de sessão key-value
`ctx.method`	`string`	Método HTTP
`ctx.path`	`string`	Path da requisição
`ctx.requestId`	`string`	UUID único
`ctx.isCron`	`boolean`	`true` se trigger cron
`ctx.isEvent`	`boolean`	`true` se trigger event
`ctx.isHttp`	`boolean`	`true` se requisição HTTP
`ctx.skillId`	`string \| null`	ID do fluxo do Brain Studio
`ctx.executionId`	`string \| null`	ID de execução do Brain Studio
`ctx.log()`	`(...args) => void`	Logger estruturado

Identidade

ctx.company.id;    // 42
ctx.company.name;  // "Loja ABC"
ctx.bot.id;        // "bot-123"
ctx.bot.channel;   // "whatsapp"
ctx.user.id;       // 99

Trigger

HTTP
Cron
Event

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

if (ctx.isCron) {
  ctx.trigger.cron; // "0 9 * * *"
}

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

Request

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

Ambiente (secrets)

const apiKey = ctx.env.get("CRM_API_KEY");
ctx.env.has("WEBHOOK_SECRET");

Variáveis internas com prefixo __FN_ são bloqueadas.

Logging

ctx.log("Processando pedido", { telefone: input.telefone });
// stdout: { "requestId": "...", "function": "...", "timestamp": "...", "args": [...] }

Mensagens

Enviar WhatsApp com ctx.jelou.

Memória

Persistir dados com ctx.memory.

​Referência

​Identidade

​Trigger

​Request

​Ambiente (secrets)

​Logging

Mensagens

Memória

Referência

Identidade

Trigger

Request

Ambiente (secrets)

Logging