OmnaraInstall

Summary

Send a message to an Omnara agent and pause the workflow until a user response is received or a configured timeout elapses.

Inputs

• Agent Instance ID (required) — Unique identifier for this workflow run, consistent across all Omnara nodes in the workflow.
• Agent Type (required) — Name of the agent as configured on the Omnara dashboard, consistent across all Omnara nodes.
• Message (required) — The text question or request sent to the user, displayed in the Omnara app, pausing the workflow until answered.
• Options — Settings including sync mode for AI agents (waits for response synchronously), sync timeout, poll interval, and notification preferences (email, SMS, push).
• Limit Wait Time — Whether to impose a maximum wait duration for a user response.
• Limit Type — Specifies how to limit wait time: either an interval after sending or until a specific date and time.
• Resume After — Duration amount to wait before resuming (used if 'after time interval' limit type is selected).
• Unit — Time unit (minutes, hours, days) for the 'Resume After' duration.
• Max Date and Time — Specific date and time to stop waiting for the response if 'at specified time' limit type is selected.

Output shape

a single record

Returns an object containing success flag, agent instance ID, user response content, message IDs, and timestamps. In sync mode, it actively polls for response until timeout. If timeout occurs without response, outputs an error indicating timeout. If not in sync mode, uses a webhook to resume workflow when a response arrives, potentially waiting indefinitely or until the configured limit.

Examples

Example 1: Send an approval request message to a human agent and wait up to 2 hours for their reply. If the user responds, return their input and metadata. If no response arrives within 2 hours, return a timeout error.

Set Agent Instance ID and Agent Type uniquely for the workflow, enter the approval question in Message, enable Limit Wait Time with 'After Time Interval' set to 2 hours, and optionally configure notification options (email, push by default).