Skip to content

Commit e97f917

Browse files
committed
fix(docs): preserve integration search details and event limits
1 parent 70f61cd commit e97f917

9 files changed

Lines changed: 21 additions & 18 deletions

File tree

‎apps/docs/INTEGRATIONS_AUDIT.md‎

Lines changed: 5 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -34,6 +34,7 @@ This is exhaustive page and static-copy coverage, with targeted primary-source v
3434
| Google Groups | Settings actions require the Groups Settings API scope, which the current connection does not request. Directory actions remain distinct; both the reference and service-account guide explain the gap. [Provider authorization](https://developers.google.com/workspace/admin/groups-settings/auth). |
3535
| Zoom | The service-account guide distinguishes deleting one recording file from deleting all meeting recordings and includes both required admin scopes. Existing tool `requiredScopes` metadata declares only the single-file branch; no runtime scope change. [Provider granular scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-granular/). |
3636
| Google Custom Search and CloudTrail Lake | Provider availability/deprecation restrictions are stated before setup, with official links on the pages. Existing access is distinguished from new-customer availability. |
37+
| Microsoft Teams | Chat creation and update notifications share a seven-day subscription/message deduplication key. An edit may not start a separate workflow after an earlier notification ran. Copy distinguishes provider subscriptions from independent workflow runs. |
3738
| Airtable | Record creations, updates, and deletions can start workflows. The normalized `airtableChanges` array currently covers creations/updates; deletion IDs remain in raw `payloads`/`latestPayload`. Runtime consolidated cell values use `changedFields` despite a pre-existing `cellValuesByFieldId` declaration. Copy explains the raw-payload path; no schema or runtime changes. |
3839
| Destructive and asynchronous actions | Brex writes, Jupyter session/kernel shutdown, conditional Azure Data Explorer recovery, Entra recovery restrictions, and other consequential operations retain their prerequisites and outcome limits. A queued request is not described as completed work. |
3940

@@ -43,7 +44,7 @@ These existing implementation/provider discrepancies need separate runtime work
4344

4445
Cross-review of every changed authored region/guide and canonical prose diff found and corrected these remaining ambiguities: unauthenticated A2A discovery and per-request discovery timeouts; an Excel sentence fragment; read-only Fathom and LaunchDarkly resources; an unsupported universal PitchBook credit claim; Textract's multi-page S3 requirement; Dropcontact's polling-wait budget; Confluence Legacy's supported content; missing Zoho Desk connector/picker scopes; Google Groups settings scope coverage; Google service-account compatibility wording; and Zoom's all-recordings deletion scope. These corrections preserve the original procedures and reference contracts. No unresolved useful-information loss was identified in that independent review.
4546

46-
PR review checked the capability boundaries again against each operation. Corrections distinguish Affinity searches from opportunity/saved-view reads; Teams chat creation/updates from channel webhook mentions; Gong reads from uploads, flow assignments, and background erasure; legacy Logs snapshots from raw log details; and Managed Agent session-specific outputs. PostHog project, organization, and recording reads, Knowledge tag listing/assignment, Pipedrive's supported resources, Airtable's creation/update/deletion triggers, Dropbox trash behavior, Quartr's AI-generated summaries and event types, ServiceNow's dedicated versus generic operations, and Intercom ticket updates are explicit. Dub already supports link-preview titles and descriptions; the copy names those fields rather than implying arbitrary metadata. Databricks Genie wording is clearer without changing its capabilities. Matching authored introductions were updated where needed.
47+
PR review checked the capability boundaries again against each operation. Corrections distinguish Affinity searches from opportunity/saved-view reads; Teams chat notification subscriptions and their shared seven-day deduplication window from channel webhook mentions; Gong reads from uploads, flow assignments, and background erasure; legacy Logs snapshots from raw log details; and Managed Agent session-specific outputs. PostHog project, organization, and recording reads, Knowledge tag listing/assignment, Pipedrive's supported resources, Airtable's creation/update/deletion triggers, Dropbox trash behavior, Quartr's AI-generated summaries and event types, ServiceNow's dedicated versus generic operations, and Intercom ticket updates are explicit. Dub already supports link-preview titles and descriptions; the copy names those fields rather than implying arbitrary metadata. Databricks Genie wording is clearer without changing its capabilities. Matching authored introductions were updated where needed.
4748

4849
## Validation
4950

@@ -70,7 +71,7 @@ These checks prove copy preservation, generation, delivery, and rendered contain
7071
| Page | Disposition | Before/after assessment and preservation | Primary sources |
7172
| --- | --- | --- | --- |
7273
| [a2a](content/docs/integrations/a2a.mdx) | authored copy rewritten | Replaced repeated protocol promotion with supported calls and X-API-Key authentication. Corrected authored data parameter type to json from canonical a2a_send_message. Preserved all four action tables and task states; added verified 10 MiB response, 30-second discovery, 300-second RPC limits and timeout reconciliation. | Canonical implementation; no new external claim. |
73-
| [affinity](content/docs/integrations/affinity.mdx) | authored introduction clarified; improve canonical generated reference copy | Replaced the repetitive integration preamble with a direct capability overview in the canonical block description. Final canonical overview: Read companies, people, opportunities, lists, and saved views; search companies, people, list entries, notes, and files. Read or update field values and notes; list or create reminders; retrieve interactions and transcripts; discover relationship paths; and follow field changes for incremental synchronization. Access depends on the API key holder’s permissions. | [Source 1](https://developer.affinity.co/), [Source 2](https://api-docs.affinity.co/) |
74+
| [affinity](content/docs/integrations/affinity.mdx) | authored introduction clarified; improve canonical generated reference copy | Restored the complete capability overview with scoped search, Semantic Search, paged list/view rows, batches of up to 100 field writes on one target, note replies, interaction types, possible introduction paths, and incremental field-change sync. Final canonical overview: Read companies, people, opportunities, lists, and saved views; search companies, people, and list entries. Page through the rows of a list or saved view. Read field values and update them individually or in batches of up to 100 on one company, person, or list entry. Read, create, update, delete, and reply to notes; list or create reminders; retrieve logged calls, emails, chat messages, meetings, and transcripts. Search notes and files by keyword, find companies from a plain-language description with Semantic Search, discover possible introduction paths through shared work and investment history, and follow the field-value change feed for incremental synchronization. Access depends on the API key holder’s permissions. | [Source 1](https://developer.affinity.co/), [Source 2](https://api-docs.affinity.co/) |
7475
| [agentmail](content/docs/integrations/agentmail.mdx) | revised_canonical_generated_prose_retained_authored_copy | Retained draft-update-send review sequence and API-key setup because it adds a concrete workflow pattern beyond the action list. | Canonical implementation; no new external claim. |
7576
| [agentphone](content/docs/integrations/agentphone.mdx) | retain authored regions; improve canonical generated reference copy | Replaced the repetitive integration preamble with a direct capability overview in the canonical block description. Final canonical overview: Provision SMS- and voice-enabled numbers, send messages and tapback reactions, place outbound calls, manage conversations and contacts, and inspect usage with an AgentPhone API key. | Canonical implementation; no new external claim. |
7677
| [agiloft](content/docs/integrations/agiloft.mdx) | already concise; retained | Retained concise existing introduction: its scope matches action/trigger summaries and useful field detail remains in generated references. | Canonical implementation; no new external claim. |
@@ -133,7 +134,7 @@ These checks prove copy preservation, generation, delivery, and rendered contain
133134
| [discord](content/docs/integrations/discord.mdx) | authored copy rewritten | Removed broad platform promotion and account/bot ambiguity; retained bot setup and token/permissions prerequisites. Qualified Message Content intent with documented exceptions and verified-app approval requirement. Canonical description strings revised at their source; root regeneration is required. | [Source 1](https://docs.discord.com/developers/events/gateway#message-content-intent) |
134135
| [docusign](content/docs/integrations/docusign.mdx) | retained_already_clear | Retained envelope/template/status/recipient/download and void-with-reason distinctions. | Canonical implementation; no new external claim. |
135136
| [downdetector](content/docs/integrations/downdetector.mdx) | authored copy rewritten | Removed repeated platform/benefit prose and kept the supported operation scope with concrete setup or behavior guidance. | Canonical implementation; no new external claim. |
136-
| [dropbox](content/docs/integrations/dropbox.mdx) | rewritten_authored_copy | Removed repeated service marketing and workflow benefit paragraphs while preserving supported operations, setup, syntax, defaults, limits, and failure/recovery facts in authored copy. Reference field/type/required/value rows retained exhaustively. | Canonical implementation; no new external claim. |
137+
| [dropbox](content/docs/integrations/dropbox.mdx) | rewritten_authored_copy | Preserved upload/download, folder-content listing, file and folder search, shared links, move/rename, trash deletion, and credential/path guidance. Clarified file and folder search against the unfiltered search_v2 response while retaining the Search Files UI label. Reference field/type/required/value rows retained exhaustively. | [Official SDK search reference](https://dropbox.github.io/dropbox-sdk-js/Dropbox.html#filesSearchV2), [Dropbox search guide](https://dropbox.tech/developers/search-files-using-the-dropbox-api) |
137138
| [dropcontact](content/docs/integrations/dropcontact.mdx) | rewritten_authored_copy | Removed repeated service marketing and workflow benefit paragraphs while preserving supported operations, setup, syntax, defaults, limits, and failure/recovery facts in authored copy. Reference field/type/required/value rows retained exhaustively. | [Source 1](https://developer.dropcontact.com/), [Source 2](https://www.dropcontact.com/help/how-subscription-works) |
138139
| [dspy](content/docs/integrations/dspy.mdx) | authored copy rewritten | Removed repeated platform/benefit prose and kept the supported operation scope with concrete setup or behavior guidance. | Canonical implementation; no new external claim. |
139140
| [dub](content/docs/integrations/dub.mdx) | rewrite manual regions; update canonical reference descriptions where needed | Preserved links, domains, slugs, external IDs, tags/folders, analytics and conversions plus management operations. Removed repeated promotional benefits and retained concrete capabilities. | Canonical implementation; no new external claim. |
@@ -238,7 +239,7 @@ These checks prove copy preservation, generation, delivery, and rendered contain
238239
| [microsoft_dynamics_365](content/docs/integrations/microsoft_dynamics_365.mdx) | retained_already_clear | Retained single-environment credential binding, owner candidates/security privileges, explicit owner binding, and public-cloud limitation. | Canonical implementation; no new external claim. |
239240
| [microsoft_excel](content/docs/integrations/microsoft_excel.mdx) | canonical prose rewritten; authored copy retained | Canonical description strings revised at their source; root regeneration is required. | Canonical implementation; no new external claim. |
240241
| [microsoft_planner](content/docs/integrations/microsoft_planner.mdx) | retain authored regions; improve canonical generated reference copy | Replaced the repetitive integration preamble with a direct capability overview in the canonical block description. Final canonical overview: Manage tasks, plans, buckets, and task details including checklists and references. | Canonical implementation; no new external claim. |
241-
| [microsoft_teams](content/docs/integrations/microsoft_teams.mdx) | authored copy rewritten | Removed generic platform benefits and focused on message/thread/reaction/member operations and literal mention syntax. Canonical description strings revised at their source; root regeneration is required. | Canonical implementation; no new external claim. |
242+
| [microsoft_teams](content/docs/integrations/microsoft_teams.mdx) | authored copy rewritten | Focused on message, thread, reaction, and member operations and literal mention syntax. Channel trigger requires an @mention of the outgoing webhook. Chat subscriptions request creation/update notifications, but the subscription/message key shares a seven-day deduplication window, so later edits may not start a separate run. Canonical block and chat trigger descriptions own matching generated docs and catalog copy. | Canonical implementation; no new external claim. |
242243
| [microsoft_word](content/docs/integrations/microsoft_word.mdx) | rewrite manual regions; update canonical reference descriptions where needed | Preserved OneDrive/SharePoint driveId context, document/template/edit/PDF actions and placeholder/formatting behavior. Corrected setup scopes to include the actual Files.Read.All and Files.ReadWrite.All in addition to per-user file scopes. | [Source 1](https://learn.microsoft.com/en-us/graph/permissions-reference) |
243244
| [millionverifier](content/docs/integrations/millionverifier.mdx) | already concise; retained | Retained concise existing introduction: its scope matches action/trigger summaries and useful field detail remains in generated references. | Canonical implementation; no new external claim. |
244245
| [mintlify](content/docs/integrations/mintlify.mdx) | authored copy rewritten | Preserved operation-specific admin/assistant key prefixes and operation sets, Project ID and Domain setup. Verified plan boundary from current pricing and qualified API availability instead of a blanket all-REST entitlement claim. Canonical description strings revised at their source; root regeneration is required. | [Source 1](https://www.mintlify.com/pricing), [Source 2](https://mintlify.com/docs/api-reference/chat/create-assistant-message) |

‎apps/docs/content/docs/integrations/affinity.mdx‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -28,7 +28,7 @@ Some Affinity endpoints are still marked BETA — company, person, and list-entr
2828

2929
## Use the block [#usage-instructions]
3030

31-
Read companies, people, opportunities, lists, and saved views; search companies, people, list entries, notes, and files. Read or update field values and notes; list or create reminders; retrieve interactions and transcripts; discover relationship paths; and follow field changes for incremental synchronization. Access depends on the API key holder’s permissions.
31+
Read companies, people, opportunities, lists, and saved views; search companies, people, and list entries. Page through the rows of a list or saved view. Read field values and update them individually or in batches of up to 100 on one company, person, or list entry. Read, create, update, delete, and reply to notes; list or create reminders; retrieve logged calls, emails, chat messages, meetings, and transcripts. Search notes and files by keyword, find companies from a plain-language description with Semantic Search, discover possible introduction paths through shared work and investment history, and follow the field-value change feed for incremental synchronization. Access depends on the API key holder’s permissions.
3232

3333
## Actions
3434

‎apps/docs/content/docs/integrations/dropbox.mdx‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,7 @@ import { BlockInfoCard } from "@/components/ui/block-info-card"
1111
/>
1212

1313
{/* MANUAL-CONTENT-START:intro */}
14-
Use [Dropbox](https://dropbox.com/) to upload and download files, list folders, search content, create folders, and manage shared links. The actions also move or rename files and folders. Delete File/Folder moves them to the trash. Select a connected Dropbox credential and the path or item identifier required by the action.
14+
Use [Dropbox](https://dropbox.com/) to upload and download files, list folder contents, search files and folders, create folders, and manage shared links. The actions also move or rename files and folders. Delete File/Folder moves them to the trash. Select a connected Dropbox credential and the path or item identifier required by the action.
1515
{/* MANUAL-CONTENT-END */}
1616

1717

@@ -36,7 +36,7 @@ Sim requests these scopes when someone connects a Dropbox account. For a self-ho
3636

3737
## Use the block [#usage-instructions]
3838

39-
Upload and download files, list and search folders, create folders, manage shared links, and move items between folders or to the trash.
39+
Upload and download files, list folder contents, search files and folders, create folders, manage shared links, and move items between folders or to the trash.
4040

4141
## Actions
4242

‎apps/docs/content/docs/integrations/microsoft_teams.mdx‎

Lines changed: 5 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,9 @@ import { BlockInfoCard } from "@/components/ui/block-info-card"
1313
{/* MANUAL-CONTENT-START:intro */}
1414
Use [Microsoft Teams](https://teams.microsoft.com) to read, send, update, or delete chat and channel messages, reply to threads, and add reactions. List teams, chats, channels, and their members to resolve destinations.
1515

16-
Switch to trigger mode to start a workflow from new or updated messages in a selected chat, or when the outgoing webhook is @mentioned in a channel. To mention a user, wrap the name in `<at>` tags, such as `<at>userName</at>`, and supply the mention details required by the action.
16+
Switch to trigger mode to start a workflow from message notifications in a selected chat, or when the outgoing webhook is @mentioned in a channel. To mention a user, wrap the name in `<at>` tags, such as `<at>userName</at>`, and supply the mention details required by the action.
17+
18+
Chat subscriptions request creation and update notifications, but Sim deduplicates them by subscription and message ID within a seven-day window. Later edits may not start a separate workflow run.
1719
{/* MANUAL-CONTENT-END */}
1820

1921

@@ -51,7 +53,7 @@ Sim requests these scopes when someone connects a Microsoft Teams account. For a
5153

5254
## Use the block [#usage-instructions]
5355

54-
Read, write, update, and delete chat and channel messages. Reply to messages, add reactions, and list teams, chats, channels, and their members. Use trigger mode to start a workflow from new or updated messages in a selected chat, or an @mention of the outgoing webhook in a channel. To mention users in messages, wrap their name in `<at>` tags: `<at>userName</at>`
56+
Read, write, update, and delete chat and channel messages. Reply to messages, add reactions, and list teams, chats, channels, and their members. Use trigger mode for message notifications in a selected chat, or an @mention of the outgoing webhook in a channel. Chat subscriptions request creation and update notifications, but Sim deduplicates them by subscription and message ID within a seven-day window. Later edits may not start a separate run. To mention users in messages, wrap their name in `<at>` tags: `<at>userName</at>`
5557

5658
## Actions
5759

@@ -502,7 +504,7 @@ Trigger workflows when the outgoing webhook is @mentioned in a Microsoft Teams c
502504

503505
### Microsoft Teams Chat
504506

505-
Trigger workflows from new or updated messages in a Microsoft Teams chat via Microsoft Graph subscriptions.
507+
Trigger workflows from Microsoft Teams chat message notifications via Microsoft Graph subscriptions. Notifications share a seven-day deduplication window keyed by subscription and message ID, so later edits may not start a separate run.
506508

507509
#### Configuration
508510

0 commit comments

Comments
 (0)