How to run an agent team a set time before or after a date on a record
Learn how to run an agent team a set time before or after a date on a record.
Learn how to run an agent team a set time before or after a date on a record.
Overview
Agent Teams in GTM One lets you build a team of steps, some of them AI agents, that a trigger starts. The same teams also appear in GoToMarket Studio. A trigger starts an agent team without anyone pressing run. The Based on a date field trigger waits for a date on a record (e.g., a deal's close date or a meeting's start) and runs the agent team at the time you choose. Its description in the trigger list reads "Runs a set time before or after a date on a record". For example, run an agent team 30 days before each opportunity's close date, or two hours before each meeting.
You set the trigger in the agent team builder, which you open from Agent Teams in the left navigation. The objects you can watch are account, contact, meeting and opportunity.
Each record runs once for its date. If the date on the record changes, the record runs again at the new time.
Before you start
- You can edit the agent team. If you can open the agent team but its controls are turned off, your role does not allow editing. Adding a trigger needs the permission to create and edit agent teams, and activating needs the permission to run them. A ZoomInfo admin assigns both. See Overview of permissions in GTM One.
- The trigger is available to your organization. Based on a date field is in the Time-based triggers category of the trigger list, beside On a schedule. If it is not there, or the Object list says "No objects are available for this trigger", it is not turned on for your organization. Ask your ZoomInfo admin.
- The agent team has at least one action. An agent team needs a trigger and at least one action before it can be activated.
- Automatic runs spend credits. Each automatic run uses AI credits from your organization's balance, charged to the user the run runs as: the agent team's owner or the user chosen to run it. Activating shows the estimated cost before it turns the trigger on. An agent team can also have a monthly credit budget in its Settings tab, and a run that would pass it does not start. See Overview of credits in GTM One.
- Runs are real. Once the trigger is on, every run sends its emails, posts its messages and changes the records its steps are set to change.
Set the trigger
- In the left navigation, click Agent Teams, open the agent team you want to change, and click the Steps tab.
- Click Add trigger. If the agent team already has a trigger and you want to replace it, open that trigger and choose another one. GTM One asks you to confirm with Proceed, because changing the trigger resets its configuration.
- In the trigger list, open Time-based triggers and click Based on a date field.
- On the trigger's Filters tab, under Object, choose the kind of record to watch (e.g., Opportunity). The list shows the objects the trigger supports.
- Under Date field, choose the date to count from (e.g., the close date). The list shows only the date fields of the object you chose. Choose the object first. Until you do, the field shows "Choose an object first".
- Under Offset, type a whole number greater than 0 in the amount box, choose the unit (minutes, hours, days or weeks), and choose before or after. For example, 30, days, before.
- Read the sentence under the controls. It states the setting in words, e.g., "Runs 30 days before each opportunity's close date."
- Optional: under Filters, add conditions so that only matching records run the trigger (e.g., only opportunities in a certain stage). Records that do not match are skipped.
- Click Save changes in the bar at the bottom of the Steps tab, then click Activate if the agent team is not active yet. Activate checks the agent team's connections, shows the estimated credit cost per automatic run, and turns the trigger on.
Every change you make in the panel is applied to the trigger straight away, but it is part of the agent team's saved version only once you save the agent team. After you activate, the agent team shows as active, and it runs for each record when its date, moved by your offset, arrives. Deactivate stops automatic runs.
Things to know about the offset
- A before offset must be at least 1 hour. A smaller one shows "A "before" offset must be at least 1 hour".
- When you choose before, a note says that when the trigger is turned on, records already inside the window are skipped. The trigger runs for records that reach the window from then on.
- Changing the object clears the saved filters, because they name fields of the old object. The offset and direction stay.
Limit how often it runs
A date-based trigger can also be limited so that the same record or company does not run too often. Open the trigger's Throttling tab and see How to limit how often an agent team trigger runs in GTM One. For a date-based trigger the options are the record's own ID (e.g., CRM Opportunity ID), ZoomInfo Company ID and, for contacts, meetings and opportunities, CRM Account ID. A new date-based trigger starts with the record's own ID.
If you see an error
- "Couldn't load the objects and date fields for this trigger." The list of objects and date fields did not load. Click Try again.
- "No objects are available for this trigger" Your organization has no object this trigger can watch yet. Ask your ZoomInfo admin.
- "This object has no date fields" The object you chose has no date to count from. Choose another object.
- "Enter a whole number greater than 0" The offset amount is empty, has a decimal or is 0. Type a whole number such as 30.
- "Choose an object" and "Choose a date field" The trigger is missing one of them. Fill in the field named in the message.
- "Choose an object, a date field and an offset for this trigger" The trigger is not complete, so it cannot be activated. Fill in Object, Date field and Offset, then activate again.
- "The saved date field is no longer available. Choose another one." The date field you saved is no longer offered. Choose another Date field.
- "is no longer available for this trigger. Choose another object; that clears the saved conditions." The object you saved is no longer offered. Choose another Object; its filters are cleared.
- "Add at least one trigger and one action to activate" The agent team is missing a trigger or an action. Add the one it lacks, then activate.