Engagements

An engagement is an inbound interaction — a comment, mention, or DM — that needs triage. The inbox is where engagements, decisions, and pending drafts all converge into a single "needs attention" queue. Engagement rules can scope automatic responses.

Use in the UI

Open the Inbox (/inbox). The notification bell in the top bar shows the same open-work count.

  • Triage incoming engagements: respond or ignore.
  • The inbox unifies engagements, decisions, and pending drafts.

Use with AI

  • engagements_list, engagements_create, engagements_respond, engagements_ignore
  • Engagement rules: rules_list_rows, rules_create, rules_update, rules_delete — scoped auto-response policies.

The agent evaluates engagement rules to decide whether to auto-respond, then calls engagements_respond; otherwise it leaves the item for a human.

Use the API

curl -X POST https://<host>/api/invoke/engagements.respond \
  -H "Authorization: Bearer $NIHMBUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "id": "eng_123", "message": "Thanks for reaching out!" }'

Reference

Engagements · Engagement Rules · Decisions / Audit.