Skip to content

Feature/tsp 976 update triggers docs#485

Merged
alexrelevanceai merged 6 commits intomainfrom
feature/tsp-976-update-triggers-docs
Mar 10, 2026
Merged

Feature/tsp 976 update triggers docs#485
alexrelevanceai merged 6 commits intomainfrom
feature/tsp-976-update-triggers-docs

Conversation

@jordanc-relevanceai
Copy link
Collaborator

Summary
This PR restructures and cleans up the Agent Trigger documentation to make it clearer, more consistent, and easier to navigate.

What changed:

  • Triggers overview page (triggers.mdx): Slimmed down to a hub page with setup steps, trigger type cards linking to sub-pages, a “Choosing the right Trigger” comparison table, and general FAQs
  • Scheduled Triggers (scheduled-triggers.mdx): Extracted from the parent triggers page into its own doc. Consolidated redundant “Why Use X” and “Making the Most of X” sections into a single intro. Covers recurring schedules (including cron expressions) and scheduled messages
  • SDK & API Triggers (sdk-and-api-triggers.mdx): Merged the separate API and SDK pages into one doc, with SDK positioned first as the recommended approach. Includes full code examples for cURL, JS, and Python
  • Webhook Triggers (custom-webhook.mdx): Rewrote to cut the fluff — removed “key features” that just restated how webhooks work and folded the useful config details (message templates, thread ID mapping, deduping) into the setup steps
  • Tools as Triggers (tools-as-triggers.mdx): Removed the beta tag and disclaimer (feature has been live since June 2025). Added full setup walkthrough, deduping explanation, use cases, and FAQ about static inputs
  • Integration Triggers (integrations.mdx): Restored as its own page covering 1,000+ integrations, premium triggers, and external triggers like Zapier
  • Sidebar restructure: Renamed “Agent Triggers” folder to “Trigger Types” in the nav. Cleaned up the hierarchy so it reads clearly under the Agents section
  • Deleted pages: Removed standalone Zapier page (now mentioned as an external trigger in the integrations doc) and separate SDK/API pages (merged into one)
  • Consistency pass: Sentence case headings across all edited docs, standardised FAQ sections with accordion format, proper capitalisation for product terms (Agent, Triggers, Tools)
    Redirects: Added redirects for deleted pages so existing links don’t break

Why:
The trigger docs had grown organically — duplicate content between pages, a Zapier doc that was a copy-paste of the webhook doc, a Tools as Triggers page sitting in beta with one paragraph for 9 months, and inconsistent formatting throughout. This brings it all into a structure where each trigger type has a focused page and the overview actually helps users find the right one.

jordanc-relevanceai and others added 4 commits March 10, 2026 15:20
- Slim down triggers.mdx to an overview page linking to sub-pages
- Merge API + SDK into single "SDK & API Triggers" page (SDK first)
- Rewrite Zapier as mention under Integration Triggers (external trigger)
- Extract recurring schedules + scheduled messages into standalone page
- Restore Integration Triggers as its own page with premium cards
- Convert all FAQ sections to accordion format for consistency
- Remove duplicate content between zapier and webhook pages
- Add redirects for removed pages (zapier, api, sdk)
- Update sidebar nav to "Trigger Types" group with cleaner hierarchy

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
…, clean up webhook page

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
…ences

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@linear
Copy link

linear bot commented Mar 10, 2026

The old standalone Zapier page was a direct copy of the webhook doc with
no Zapier-specific content. Since Zapier setup is managed entirely within
Zapier's platform, it doesn't need its own doc — just a mention as a
trigger type. Added under "Types of Triggers" in the Workforce triggers
page where it belongs, alongside manual, integration, and scheduled.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@jordanc-relevanceai
Copy link
Collaborator Author

The old standalone Zapier page was a direct copy of the webhook doc with
no Zapier-specific content. Since Zapier setup is managed entirely within
Zapier's platform, it shouldn't need its own doc — just a mention as a
trigger type. Added under "Types of Triggers" in the Workforce triggers
page.

…tion

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Copy link
Member

@alexrelevanceai alexrelevanceai left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

yallah

@alexrelevanceai alexrelevanceai merged commit 905e717 into main Mar 10, 2026
8 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants