Response Object (res)¶

The res instance sends custom HTTP responses from webhook and Webapp commands.

It lets your bot behave like an HTTP API or web endpoint. You can return JSON, HTML, XML, plain text, redirects, and rendered templates (EJS).

Once a response is sent with res, command execution ends.

Response Methods¶

set(key, value)¶

Sets HTTP headers on the response.

res.set("Content-Type", "application/json")
   .set("X-Custom-Header", "my-value")

Headers can be chained.

status(code)¶

Sets the HTTP response status code.

res.status(200)
res.status(404)
res.status(500)

You can chain this with other methods.

send(body)¶

Sends a response with any content type.

res.send("Hello World")
res.send({ message: "Success", data: { id: 1 } })
res.status(201).send("Resource created")

The content type is auto-detected.

json(obj)¶

Sends a JSON response with application/json content type.

res.json({
  status: "success",
  user: user.name,
  data: processedData
})

This is the most common method for API-style responses.

html(content)¶

Sends an HTML response.

If EJS tags are detected, the content is automatically rendered.

res.html("<h1>Welcome</h1><p>Hello World</p>")

With EJS rendering:

res.html(`
  <h1>Welcome <%= user.first_name %></h1>
  <p>Your ID: <%= user.id %></p>
  <% if (user.premium) { %>
    <div class='premium'>Premium User</div>
  <% } %>
`)

xml(content)¶

Sends an XML response with application/xml content type.

res.xml('<?xml version="1.0"?><response><status>success</status></response>')

text(content)¶

Sends a plain text response.

EJS templates are auto-rendered if detected.

res.text("This is plain text")

const textTemplate = "Hello <%= name %>, welcome!"
res.text(textTemplate)

redirect(url)¶

Redirects the request to another URL or command.

res.redirect("https://example.com/success")
res.redirect("/another-command")

Redirect responses are sent immediately.

render(commandPath, options)¶

Renders another command's output as the response.

Content type is detected automatically based on the target.

res.render("user-profile")

With options:

res.render("api-data.json", {
  data: { user: { name: "John", age: 30 } }
})

Rendering an HTML command:

res.render("dashboard.html", {
  data: {
    user: user,
    stats: userStats,
    params: params
  }
})

For advanced res.render() usage, see the res.render() Guide.

Notes¶

• Sending a response ends execution
• Headers, status, and body can be chained
• EJS rendering works automatically for HTML and text
• If no response is sent, a default 2xx response is returned
• The user object in templates is available in user-based webhooks, not in public Webapp URLs