Skip to main content

​
What is a job?

A job is a saved, repeatable version of an agent run. Instead of opening the chat and typing the same question each week, you define the question once as a job — and Interact runs it automatically for you. Jobs can be triggered in three ways:

Scheduled

Runs automatically on a cron schedule — daily, weekly, monthly, or any custom interval.

Manual

Run at any time with a single click from the Interact interface.

API

Triggered by an external system — for example, after a data pipeline finishes loading.

​
Generating PDF reports

One of the most powerful uses of jobs is having your agent produce a formatted, PDF-exportable report on a schedule — no manual effort required. When you include the create_report instruction in your job prompt, the agent structures its output as a branded report with sections, tables, charts, and highlights. The report appears in a dedicated panel alongside the chat and can be exported to PDF with one click. Example job prompt:
“Analyse paid search performance for the past 7 days. Create a report with an executive summary, a table of top campaigns by ROAS, a breakdown by market, and key recommendations. Highlight any campaigns where CPA exceeded the target.”
Each scheduled run produces a fresh report, automatically stored in the job’s history. Share the report with stakeholders, export it as PDF, or use it as a recurring Monday morning briefing.
Writing the prompt once for a recurring report is one of the fastest time-saves Interact offers. Set it up once, and a polished report is waiting in your inbox every week.

​
Creating a job

1

Open an agent

From the sidebar, click Agents and select the agent you want to schedule.
2

Go to the Jobs tab

Inside the agent, click the Jobs tab and then Create job.
3

Give the job a name

Use something descriptive, like “Weekly Campaign Performance Report”.
4

Write the job prompt

This is the question the agent will answer each time the job runs. Write it as you would in the chat:
“Analyse campaign performance for the past 7 days. Include impressions, clicks, spend, conversions, and ROAS by campaign. Highlight any campaigns where ROAS dropped below 2.”
5

Set visibility

Choose who can see the job’s results:
  • Private — only you
  • Organisation — all members of your workspace

​
Scheduling a job

To enable automatic scheduling, toggle Enable schedule in the job settings.

​
Cron expressions

Interact uses standard cron syntax. The format is:
ExpressionMeaning
0 8 * * 1Every Monday at 8:00 AM
0 9 * * 1-5Weekdays at 9:00 AM
0 8 1 * *First day of every month at 8:00 AM
@first-weekdayFirst business day of every month
Not familiar with cron syntax? Use crontab.guru to build and test cron expressions in plain language.

​
Timezone

Jobs run relative to your organisation’s configured timezone. Check Settings → Organisation to confirm or update this.

​
Running a job manually

You can run any job at any time from the Jobs tab, regardless of its schedule. Click Run now next to the job. This is useful for:
  • Testing a job before putting it on schedule
  • Running the analysis on demand for a stakeholder presentation
  • Re-running a job that failed due to a temporary issue

​
Triggering jobs via the API

To trigger a job from an external system, use the REST API: 
curl -X POST https://interact.turntwo.com/api/agents/jobs/{job_id}/trigger \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "X-Organization-Id: YOUR_ORG_ID"
You can find your job_id in the job settings page URL. API keys are created in Settings → API. Full API reference →

​
Parameterised runs

Jobs can accept parameters that change what the job analyses without changing the job definition itself. For example, a job that analyses a specific market can take market as a parameter:
ParameterValues
marketNL, BE, DE
When you run such a job, you can provide one value (single run) or multiple values at once (fan-out run). A fan-out creates one parallel chat result per value — you’d get three separate results, one per market.

​
Preventing duplicate runs

If a scheduled job is still running when the next scheduled time arrives, Interact skips the new run and logs a warning. This prevents duplicate results and conflicting resource usage.

​
Job history and results

Every job run creates a chat — a full record of the questions asked, queries run, and results returned. Browse run history from the Jobs tab by clicking on any job. From there, you can:
  • View any past result
  • See which runs succeeded or failed
  • Re-run any previous run manually

​
Notifications on job completion

Set up a notification channel to receive an alert when a job completes — or when it fails. Supported channels: email, Slack, and Microsoft Teams. Set up notifications →