• Any user can create a Trigger for a Public or Chat-only Agent.
• No limit exists on the number of Triggers that can be set up.
• Other users will see both the Trigger setup and the output of that Trigger in the Conversation History.

Available Trigger Types

1. Time Based Triggers- Schedule your Agent to execute on a Daily or Weekly Schedule.
2. Incoming Webhook Triggers- Kicks your Agent off when a particular event occurs in an external app

Configuring Time Based Triggers

• Schedule

  • Daily – The Agent runs its task every day at the specified time.
  • Weekly – The Agent runs on one or multiple selected days per week at the specified time.
  • Timezone – The schedule follows the timezone set in your NinjaCat Organization Settings.

• Status

  • On – The Trigger is active and runs according to the schedule.
  • Paused – The Trigger is inactive but can be re-enabled later.

• Message (Trigger Command)
  The message field is what gets sent to the Agent at the scheduled time, instructing it to execute its task.
  
  
  Example Messages:

  • “Do your thing, but only for these two accounts: Athleta and Nike.”
  • “Do your thing, but only for accounts owned by Julie Brown.”
  • (Default message if left blank: “Go!” — The Agent will follow its configured prompt as-is.)

• Notifications (Optional)
  Enable this feature if you would like an email notification to be sent to one or more recipients, notifying them that the Agent has finished its task.

Configuring Webhook Triggers

• Name - A name for the Webhook Trigger. This will also appear in the Output listing in the Conversation History
• URL - The URL to send the webhook to. Please copy and save this in a secure location (and add it to the external source that supports outbound webhooks)
  • Note: Not all sources / apps support outbound webhooks, so you'll need to confirm this with their documentation and customer service support before going down this path.
• Instructions - Write instructions that the trigger will use to kick off the agent. If the prompt is already sufficient then just type in "Go!" The body of your webhook POST request will be appended to the end of the prompt.

Viewing Trigger Outputs

Once a Trigger has executed, its Triggered Run will appear in the Agent’s Conversation History, including the date and time it ran. The Conversation History can be filtered to show only Triggered Runs, only your Conversations or All. Upon clicking into a Triggered Run, the output of that run will appear in the conversation space to be reviewed.

If Notifications have been enabled, then an email is sent to those recipients notifying them that the Agent has finished its task. That email notification contains a button that directs the user back to the output in the Conversation History to review.