Skip to content

The open alternative to Salesforce, designed for AI.

feat(slack): render Twenty record links as work object previews (#24980)

Abdul Rahman63697228b533
diff --git a/packages/twenty-apps/public/slack/README.md b/packages/twenty-apps/public/slack/README.md
index cf954079113..c1f5ce90cbc 100644
--- a/packages/twenty-apps/public/slack/README.md
+++ b/packages/twenty-apps/public/slack/README.md
@@ -8,6 +8,7 @@
- **Follow-ups without re-mentioning** — once it has replied in a thread you can keep talking to it, for 24 hours in a channel and indefinitely in a DM
- **It acts as whoever tagged it** — Slack accounts are matched to workspace members, so the bot can never do more than the person asking
- **Slack steps for your workflows** — post, update or delete messages, send ephemerals, add reactions, list channels
+- **Record link previews** — paste a link to a person, company, opportunity, note or task and Slack shows a card with the record's key fields, rendered only when the poster maps to a workspace member; expanding a card shows the full details, again only to viewers who map to a workspace member
## 🤖 The assistant
diff --git a/packages/twenty-apps/public/slack/SETUP.md b/packages/twenty-apps/public/slack/SETUP.md
index 65e2032ce4e..7b320f8fbe1 100644
--- a/packages/twenty-apps/public/slack/SETUP.md
+++ b/packages/twenty-apps/public/slack/SETUP.md
@@ -26,9 +26,10 @@ Use a dedicated Slack app — do not reuse one across Twenty apps.
Create it at [api.slack.com/apps](https://api.slack.com/apps) → **Create New App
→ From a manifest**, pasting [`slack-app-manifest.json`](./slack-app-manifest.json)
with the `https://<your-twenty-host>` placeholders replaced by your deployment's
-server origin. The manifest is the source of truth for scopes, event
-subscriptions and the agent surface, so an app created from it only needs its
-credentials copied out (below).
+server origin, and `<your-twenty-front-host>` under `unfurl_domains` set to the
+domain your workspace URLs use (see Record link previews). The manifest is the
+source of truth for scopes, event subscriptions and the agent surface, so an app
+created from it only needs its credentials copied out (below).
The manifest enables `agent_view`, Slack's Agent messaging experience: the app
is listed as an agent in Slack's UI, shows clickable suggested prompts at the
@@ -57,6 +58,8 @@ there, since Slack validates the set:
| `groups:history` | assistant: thread follow-ups in private channels |
| `im:history` | assistant: direct messages |
| `im:read` | assistant: confirm with Slack that a conversation really is a direct message |
+| `links:read` | record link previews: receive `link_shared` events for the registered unfurl domain |
+| `links:write` | record link previews: attach the preview with `chat.unfurl` |
| `users:read` | list the Slack roster for the email sweep, and look up a requester's display name |
| `users:read.email` | match a Slack account to a workspace member by confirmed email |
| `assistant:write` | agent surface: `assistant.threads.*` (statuses, titles, suggested prompts) |
@@ -133,6 +136,8 @@ Under **Subscribe to bot events**, add:
- `app_home_opened` — a user opened the bot's Messages tab; sets the suggested prompts
- `app_mention` — mentions of the bot in a channel
+- `link_shared` — a Twenty record link was pasted or posted; renders the record link preview (see Record link previews)
+- `entity_details_requested` — a user expanded a record link preview; fills the side panel with the record's details
- `message.im` — direct messages to the bot
- `message.channels` — replies in public-channel threads, for un-mentioned follow-ups
- `message.groups` — same, for private channels the bot is in
@@ -152,6 +157,11 @@ mentions and DMs, at the cost of un-mentioned thread follow-ups.
> Upgrading from any version before 0.4.1 adds `app_uninstalled` and
> `tokens_revoked`; without them the team claim survives a Slack-side removal.
> No new scopes are involved, so the connection itself needs no re-authorization.
+> Upgrading from any version before 0.7.0 adds `link_shared` and
+> `entity_details_requested` plus the `links:read` / `links:write` scopes for the
+> record link previews; that one does need a reconnect, and on an app created
+> from an older manifest the Work Object Previews toggle has to be enabled by
+> hand as well (see Record link previews).
### Interactivity
@@ -270,6 +280,57 @@ and says whether linking activates immediately or asks the person first. An
a workspace that connected before the sweep existed (connect hooks do not
re-fire) and people who joined Slack after connection.
+## Record link previews (work objects)
+
+Pasting a link to a Twenty person, company, opportunity, note or task renders it
+as a [work object](https://docs.slack.dev/messaging/work-objects) preview: a card
+carrying the record's name and a few key fields. The card appears as soon as the
+link is pasted into the composer, before the message is sent. Optional — skip
+this section and links stay plain text.
+
+Register the domain of your Twenty **front** URL under **Event Subscriptions →
+App unfurl domains**: the workspace URL members open, without the scheme, for
+example `crm.example.com`. Apps created from the manifest have
+`<your-twenty-front-host>` preconfigured; replace it before pasting. Slack only
+sends `link_shared` events for registered domains.
+
+A workspace on a custom domain still serves its subdomain host, and links get
+copied from either, so register **both**: `crm.example.com` and
+`acme.twenty.com`. Previews resolve a link from either host and point the card
+back at the custom one; a host you leave unregistered simply never unfurls.
+
+The previews also need the `links:read` and `links:write` scopes and the
+`link_shared` and `entity_details_requested` subscriptions from the lists above.
+On an existing install, add them and reconnect (disconnect, then **Add
+connection** again) so the token picks up the scopes.
+
+The manifest turns the previews themselves on, through `features.rich_previews`
+with the `slack#/entities/item` entity type they use. On an app created by hand,
+or from a manifest older than 0.7.0, open **Work Object Previews** in the app
+settings, enable the toggle and select the **Item** entity type. Without it Slack
+ignores the unfurl metadata and no card ever renders, with nothing in the logs to
+say why.
+
+Slack stamps your Slack app's icon on the corner of every record card for
+attribution, and an app without one gets Slack's generic placeholder. Upload the
+Twenty logo (or your own) under **Basic Information → Display Information → App
+icon**; icons cannot be set from a manifest.
+
+Previews are rendered only when the person who posted the link maps to a
+workspace member, by the same matching described above. The card is visible to
+everyone in the channel, so it stays to a handful of headline fields. Expanding
+it opens a side panel with the full field set; anyone who can see the card can
+open it, external users in Slack Connect channels included, so the panel is
+likewise filled only for viewers who map to a workspace member, and everyone else
+gets a short notice instead.
+
+Record links the bot itself posts (assistant answers, workflow message steps)
+carry the preview too. Slack never sends `link_shared` for an app's own messages,
+so those previews are attached as the message is posted; the member gate does not
+apply there, since what the bot says is already decided upstream — the assistant
+runs with the requester's permissions, and workflow steps post what their author
+configured.
+
## Behaviour notes
- **Suggested prompts.** With `app_home_opened` subscribed and the Agents
diff --git a/packages/twenty-apps/public/slack/package.json b/packages/twenty-apps/public/slack/package.json
index 941cb11d411..39269a9e8d6 100644
--- a/packages/twenty-apps/public/slack/package.json
+++ b/packages/twenty-apps/public/slack/package.json
@@ -1,6 +1,6 @@
{
"name": "@twentyhq/slack",
- "version": "0.6.1",
+ "version": "0.7.0",
"description": "Slack assistant and workflow steps for Twenty",
"license": "MIT",
"engines": {
diff --git a/packages/twenty-apps/public/slack/slack-app-manifest.json b/packages/twenty-apps/public/slack/slack-app-manifest.json
index 74096632ff8..5e2277b979e 100644
--- a/packages/twenty-apps/public/slack/slack-app-manifest.json
+++ b/packages/twenty-apps/public/slack/slack-app-manifest.json
@@ -15,6 +15,11 @@
},
"agent_view": {
"agent_description": "Ask about your CRM: look up people, companies and opportunities, create and update records, and capture notes and tasks."
+ },
+ "unfurl_domains": ["<your-twenty-front-host>"],
+ "rich_previews": {
+ "is_active": true,
+ "entity_types": ["slack#/entities/item"]
}
},
"oauth_config": {
@@ -32,6 +37,8 @@
"groups:history",
"im:history",
"im:read",
+ "links:read",
+ "links:write",
"users:read",
"users:read.email",
"assistant:write"
@@ -49,6 +56,8 @@
"app_home_opened",
"app_mention",
"app_uninstalled",
+ "entity_details_requested",
+ "link_shared",
"member_joined_channel",
"message.channels",
"message.groups",
diff --git a/packages/twenty-apps/public/slack/src/connection-providers/slack-connection.ts b/packages/twenty-apps/public/slack/src/connection-providers/slack-connection.ts
index 562d5b99fe9..17ec95b541b 100644
--- a/packages/twenty-apps/public/slack/src/connection-providers/slack-connection.ts
+++ b/packages/twenty-apps/public/slack/src/connection-providers/slack-connection.ts
@@ -28,7 +28,6 @@ export default defineConnectionProvider({
'im:write',
'groups:read',
'reactions:write',
- // Only used by the conversational assistant
'app_mentions:read',
'channels:history',
'groups:history',
@@ -37,6 +36,8 @@ export default defineConnectionProvider({
'users:read',
'users:read.email',
'assistant:write',
+ 'links:read',
+ 'links:write',
],
clientIdVariable: 'SLACK_CLIENT_ID',
clientSecretVariable: 'SLACK_CLIENT_SECRET',
diff --git a/packages/twenty-apps/public/slack/src/constants/universal-identifiers.ts b/packages/twenty-apps/public/slack/src/constants/universal-identifiers.ts
index 3844a083c61..f0dcc3394c6 100644
--- a/packages/twenty-apps/public/slack/src/constants/universal-identifiers.ts
+++ b/packages/twenty-apps/public/slack/src/constants/universal-identifiers.ts
@@ -55,6 +55,12 @@ export const SLACK_HOME_OPENED_UNIVERSAL_IDENTIFIER =
export const SLACK_ASSISTANT_WORKER_UNIVERSAL_IDENTIFIER =
'4b92a49f-d674-46ea-a3d9-e8d658ae3a17';
+export const SLACK_LINK_UNFURL_UNIVERSAL_IDENTIFIER =
+ 'b9126247-b6f3-4c1f-a4c5-1c7b28d4beea';
+
+export const SLACK_ENTITY_DETAILS_UNIVERSAL_IDENTIFIER =
+ '39bd7fee-7c98-45aa-8ac7-e996e77bc229';
+
export const SLACK_REGISTER_CONNECTION_UNIVERSAL_IDENTIFIER =
'a29ae15d-dd16-4b99-bb6c-079842da55ab';
diff --git a/packages/twenty-apps/public/slack/src/logic-functions/__tests__/slack-events-resolver.test.ts b/packages/twenty-apps/public/slack/src/logic-functions/__tests__/slack-events-resolver.test.ts
index 63eeefa9bb8..b64f11bc735 100644
--- a/packages/twenty-apps/public/slack/src/logic-functions/__tests__/slack-events-resolver.test.ts
+++ b/packages/twenty-apps/public/slack/src/logic-functions/__tests__/slack-events-resolver.test.ts
@@ -1,8 +1,10 @@
import { beforeEach, describe, expect, it, vi } from 'vitest';
import {
+ SLACK_ENTITY_DETAILS_UNIVERSAL_IDENTIFIER,
SLACK_EVENTS_ENQUEUE_UNIVERSAL_IDENTIFIER,
SLACK_INSTALL_REVOKED_LOGIC_FUNCTION_UNIVERSAL_IDENTIFIER,
+ SLACK_LINK_UNFURL_UNIVERSAL_IDENTIFIER,
} from 'src/constants/universal-identifiers';
import { slackEventsResolverHandler } from 'src/logic-functions/slack-events-resolver';
import { type SlackEventsRequestBody } from 'src/logic-functions/types/slack-events-request-body.type';
@@ -156,6 +158,55 @@ describe('slackEventsResolverHandler', () => {
).rejects.toThrow('No workspace has claimed Slack team T123');
});
+ it('should route link_shared to the link unfurl function', async () => {
+ resolveWorkspaceMock.mockResolvedValue('workspace-1');
+
+ const body: SlackEventsRequestBody = {
+ type: 'event_callback',
+ team_id: 'T123',
+ event: {
+ type: 'link_shared',
+ channel: 'C123',
+ message_ts: '1700000000.000100',
+ user: 'U123',
+ links: [{ url: 'https://crm.example.com/object/person/uuid' }],
+ },
+ };
+
+ const result = await slackEventsResolverHandler(buildRoutePayload(body));
+
+ expect(result).toEqual({
+ workspaceId: 'workspace-1',
+ targetLogicFunctionUniversalIdentifier:
+ SLACK_LINK_UNFURL_UNIVERSAL_IDENTIFIER,
+ payload: body,
+ });
+ });
+
+ it('should route entity_details_requested to the entity details function', async () => {
+ resolveWorkspaceMock.mockResolvedValue('workspace-1');
+
+ const body: SlackEventsRequestBody = {
+ type: 'event_callback',
+ team_id: 'T123',
+ event: {
+ type: 'entity_details_requested',
+ user: 'U123',
+ trigger_id: 'trigger-1',
+ external_ref: { id: 'uuid', type: 'person' },
+ },
+ };
+
+ const result = await slackEventsResolverHandler(buildRoutePayload(body));
+
+ expect(result).toEqual({
+ workspaceId: 'workspace-1',
+ targetLogicFunctionUniversalIdentifier:
+ SLACK_ENTITY_DETAILS_UNIVERSAL_IDENTIFIER,
+ payload: body,
+ });
+ });
+
it('should route other events unchanged', async () => {
resolveWorkspaceMock.mockResolvedValue('workspace-1');
diff --git a/packages/twenty-apps/public/slack/src/logic-functions/constants/slack-entity-field-type.ts b/packages/twenty-apps/public/slack/src/logic-functions/constants/slack-entity-field-type.ts
new file mode 100644
index 00000000000..a1168706d8e
--- /dev/null
+++ b/packages/twenty-apps/public/slack/src/logic-functions/constants/slack-entity-field-type.ts
@@ -0,0 +1,7 @@
+export const SLACK_ENTITY_FIELD_TYPE = {
+ STRING: 'string',
+ TIMESTAMP: 'slack#/types/timestamp',
+ LINK: 'slack#/types/link',
+ EMAIL: 'slack#/types/email',
+ ENTITY_REF: 'slack#/types/entity_ref',
+} as const;
diff --git a/packages/twenty-apps/public/slack/src/logic-functions/constants/slack-unfurl-max-entities.ts b/packages/twenty-apps/public/slack/src/logic-functions/constants/slack-unfurl-max-entities.ts
new file mode 100644
index 00000000000..bc385c9ef6a
--- /dev/null
+++ b/packages/twenty-apps/public/slack/src/logic-functions/constants/slack-unfurl-max-entities.ts
@@ -0,0 +1 @@
+export const SLACK_UNFURL_MAX_ENTITIES = 3;
diff --git a/packages/twenty-apps/public/slack/src/logic-functions/constants/slack-unfurl-object-names.ts b/packages/twenty-apps/public/slack/src/logic-functions/constants/slack-unfurl-object-names.ts
new file mode 100644
index 00000000000..fc18d637841
--- /dev/null
+++ b/packages/twenty-apps/public/slack/src/logic-functions/constants/slack-unfurl-object-names.ts
@@ -0,0 +1,7 @@
+export const SLACK_UNFURL_OBJECT_NAMES = [
+ 'person',
+ 'company',
+ 'opportunity',
+ 'note',
+ 'task',
+] as const;
diff --git a/packages/twenty-apps/public/slack/src/logic-functions/data/find-slack-unfurl-record.ts b/packages/twenty-apps/public/slack/src/logic-functions/data/find-slack-unfurl-record.ts
new file mode 100644
index 00000000000..e0cfea44811
--- /dev/null
+++ b/packages/twenty-apps/public/slack/src/logic-functions/data/find-slack-unfurl-record.ts
@@ -0,0 +1,104 @@
+import { type CoreApiClient } from 'twenty-client-sdk/core';
+
+import { type SlackUnfurlObjectName } from 'src/logic-functions/types/slack-unfurl-object-name.type';
+import { asRecord } from 'src/logic-functions/utils/as-record.util';
+
+type SlackUnfurlRecordSelection = {
+ queryField: 'people' | 'companies' | 'opportunities' | 'notes' | 'tasks';
+ node: Record<string, unknown>;
+};
+
+const RECORD_SELECTIONS: Record<
+ SlackUnfurlObjectName,
+ SlackUnfurlRecordSelection
+> = {
+ person: {
+ queryField: 'people',
+ node: {
+ id: true,
+ name: { firstName: true, lastName: true },
+ jobTitle: true,
+ avatarUrl: true,
+ emails: { primaryEmail: true },
+ phones: { primaryPhoneNumber: true, primaryPhoneCallingCode: true },
+ linkedinLink: { primaryLinkUrl: true },
+ company: { id: true, name: true, domainName: { primaryLinkUrl: true } },
+ createdAt: true,
+ updatedAt: true,
+ },
+ },
+ company: {
+ queryField: 'companies',
+ node: {
+ id: true,
+ name: true,
+ domainName: { primaryLinkUrl: true },
+ linkedinLink: { primaryLinkUrl: true },
+ annualRevenue: { amountMicros: true, currencyCode: true },
+ address: { addressCity: true, addressCountry: true },
+ accountOwner: { id: true, name: { firstName: true, lastName: true } },
+ createdAt: true,
+ updatedAt: true,
+ },
+ },
+ opportunity: {
+ queryField: 'opportunities',
+ node: {
+ id: true,
+ name: true,
+ stage: true,
+ amount: { amountMicros: true, currencyCode: true },
+ closeDate: true,
+ company: { id: true, name: true, domainName: { primaryLinkUrl: true } },
+ pointOfContact: { id: true, name: { firstName: true, lastName: true } },
+ createdAt: true,
+ updatedAt: true,
+ },
+ },
+ note: {
+ queryField: 'notes',
+ node: {
+ id: true,
+ title: true,
+ bodyV2: { markdown: true },
+ createdAt: true,
+ updatedAt: true,
+ },
+ },
+ task: {
+ queryField: 'tasks',
+ node: {
+ id: true,
+ title: true,
+ status: true,
+ dueAt: true,
+ bodyV2: { markdown: true },
+ assignee: { id: true, name: { firstName: true, lastName: true } },
+ createdAt: true,
+ updatedAt: true,
+ },
+ },
+};
+
+export const findSlackUnfurlRecord = async ({
+ client,
+ objectNameSingular,
+ recordId,
+}: {
+ client: CoreApiClient;
+ objectNameSingular: SlackUnfurlObjectName;
+ recordId: string;
+}): Promise<Record<string, unknown> | undefined> => {
+ const { queryField, node } = RECORD_SELECTIONS[objectNameSingular];
+
+ const queryResult = await client.query({
+ [queryField]: {
+ __args: { filter: { id: { eq: recordId } }, first: 1 },
+ edges: { node },
+ },
+ });
+
+ const record = queryResult?.[queryField]?.edges?.[0]?.node;
+
+ return asRecord(record);
+};
diff --git a/packages/twenty-apps/public/slack/src/logic-functions/slack-assistant-worker.ts b/packages/twenty-apps/public/slack/src/logic-functions/slack-assistant-worker.ts
index 29bf129ff64..238e8d2e096 100644
--- a/packages/twenty-apps/public/slack/src/logic-functions/slack-assistant-worker.ts
+++ b/packages/twenty-apps/public/slack/src/logic-functions/slack-assistant-worker.ts
@@ -21,7 +21,7 @@ import { buildSlackAssistantMessages } from 'src/logic-functions/utils/build-sla
import { buildSlackAssistantRequestName } from 'src/logic-functions/utils/build-slack-assistant-request-name';
import { extractAgentResponseText } from 'src/logic-functions/utils/extract-agent-response-text';
import { fetchSlackAssistantContext } from 'src/logic-functions/utils/fetch-slack-assistant-context';
-import { fetchWorkspaceBaseUrl } from 'src/logic-functions/utils/fetch-workspace-base-url';
+import { fetchWorkspaceBaseUrls } from 'src/logic-functions/utils/fetch-workspace-base-urls';
import { finishSlackAssistantRequestWithFailure } from 'src/logic-functions/utils/finish-slack-assistant-request-with-failure';
import { getSlackAssistantParentMessageTimestamp } from 'src/logic-functions/utils/get-slack-assistant-parent-message-timestamp';
import { resolveSlackRunAsForRequest } from 'src/logic-functions/utils/resolve-slack-run-as-for-request';
@@ -89,7 +89,7 @@ export const slackAssistantWorkerHandler = async (
assistantBotUserId,
isDirectMessage,
},
- workspaceBaseUrl,
+ workspaceBaseUrls,
] = await Promise.all([
fetchSlackAssistantContext({
slackChannelId,
@@ -97,7 +97,7 @@ export const slackAssistantWorkerHandler = async (
slackMessageTimestamp,
slackUserId: record.slackUserId,
}),
- fetchWorkspaceBaseUrl(),
+ fetchWorkspaceBaseUrls(),
]);
const runAsWorkspaceMemberId = await resolveSlackRunAsForRequest({
@@ -128,7 +128,7 @@ export const slackAssistantWorkerHandler = async (
conversationMessages,
runAsWorkspaceMemberId,
timeoutSeconds: SLACK_ASSISTANT_WORKER_TIMEOUT_SECONDS,
- workspaceBaseUrl,
+ workspaceBaseUrl: workspaceBaseUrls[0],
}),
slackChannelId,
threadTimestamp: parentMessageTimestamp,
diff --git a/packages/twenty-apps/public/slack/src/logic-functions/slack-entity-details.ts b/packages/twenty-apps/public/slack/src/logic-functions/slack-entity-details.ts
new file mode 100644
index 00000000000..59505c28696
--- /dev/null
+++ b/packages/twenty-apps/public/slack/src/logic-functions/slack-entity-details.ts
@@ -0,0 +1,13 @@
+import { defineLogicFunction } from 'twenty-sdk/define';
+
+import { SLACK_ENTITY_DETAILS_UNIVERSAL_IDENTIFIER } from 'src/constants/universal-identifiers';
+import { presentSlackRecordDetails } from 'src/logic-functions/utils/present-slack-record-details';
+
+export default defineLogicFunction({
+ universalIdentifier: SLACK_ENTITY_DETAILS_UNIVERSAL_IDENTIFIER,
+ name: 'slack-entity-details',
+ description:
+ "Runs in the resolved workspace: answers Slack's entity_details_requested with the record's work object metadata, filling the flexpane a user opens from a record link preview.",
+ timeoutSeconds: 15,
+ handler: presentSlackRecordDetails,
+});
diff --git a/packages/twenty-apps/public/slack/src/logic-functions/slack-events-resolver.ts b/packages/twenty-apps/public/slack/src/logic-functions/slack-events-resolver.ts
index 4b11e883e1d..c6577234a50 100644
--- a/packages/twenty-apps/public/slack/src/logic-functions/slack-events-resolver.ts
+++ b/packages/twenty-apps/public/slack/src/logic-functions/slack-events-resolver.ts
@@ -5,10 +5,12 @@ import { isDefined } from 'twenty-sdk/utils';
import {
SLACK_CHANNEL_WELCOME_UNIVERSAL_IDENTIFIER,
+ SLACK_ENTITY_DETAILS_UNIVERSAL_IDENTIFIER,
SLACK_EVENTS_ENQUEUE_UNIVERSAL_IDENTIFIER,
SLACK_EVENTS_ROUTE_UNIVERSAL_IDENTIFIER,
SLACK_HOME_OPENED_UNIVERSAL_IDENTIFIER,
SLACK_INSTALL_REVOKED_LOGIC_FUNCTION_UNIVERSAL_IDENTIFIER,
+ SLACK_LINK_UNFURL_UNIVERSAL_IDENTIFIER,
} from 'src/constants/universal-identifiers';
import { type SlackEventsRequestBody } from 'src/logic-functions/types/slack-events-request-body.type';
import { findClaimedWorkspaceId } from 'src/logic-functions/utils/find-claimed-workspace-id';
@@ -82,6 +84,10 @@ const resolveTargetLogicFunctionUniversalIdentifier = (
return SLACK_CHANNEL_WELCOME_UNIVERSAL_IDENTIFIER;
case 'app_home_opened':
return SLACK_HOME_OPENED_UNIVERSAL_IDENTIFIER;
+ case 'link_shared':
+ return SLACK_LINK_UNFURL_UNIVERSAL_IDENTIFIER;
+ case 'entity_details_requested':
+ return SLACK_ENTITY_DETAILS_UNIVERSAL_IDENTIFIER;
case 'app_uninstalled':
case 'tokens_revoked':
return SLACK_INSTALL_REVOKED_LOGIC_FUNCTION_UNIVERSAL_IDENTIFIER;
@@ -94,7 +100,7 @@ export default defineLogicFunction({
universalIdentifier: SLACK_EVENTS_ROUTE_UNIVERSAL_IDENTIFIER,
name: 'slack-events-resolver',
description:
- 'Receives Slack Events API callbacks, verifies the request signature in the owner workspace, answers the url_verification handshake, and resolves the target workspace plus the function that handles the event (assistant enqueue, the channel welcome on member_joined_channel, the suggested prompts on app_home_opened, or the team release on app_uninstalled and tokens_revoked).',
+ 'Receives Slack Events API callbacks, verifies the request signature in the owner workspace, answers the url_verification handshake, and resolves the target workspace plus the function that handles the event (assistant enqueue, the channel welcome on member_joined_channel, the suggested prompts on app_home_opened, the record link previews on link_shared and entity_details_requested, or the team release on app_uninstalled and tokens_revoked).',
timeoutSeconds: 15,
handler: slackEventsResolverHandler,
serverRouteTriggerSettings: {
diff --git a/packages/twenty-apps/public/slack/src/logic-functions/slack-link-unfurl.ts b/packages/twenty-apps/public/slack/src/logic-functions/slack-link-unfurl.ts
new file mode 100644
index 00000000000..6357b4c8b2f
--- /dev/null
+++ b/packages/twenty-apps/public/slack/src/logic-functions/slack-link-unfurl.ts
@@ -0,0 +1,13 @@
+import { defineLogicFunction } from 'twenty-sdk/define';
+
+import { SLACK_LINK_UNFURL_UNIVERSAL_IDENTIFIER } from 'src/constants/universal-identifiers';
+import { unfurlSlackRecordLinks } from 'src/logic-functions/utils/unfurl-slack-record-links';
+
+export default defineLogicFunction({
+ universalIdentifier: SLACK_LINK_UNFURL_UNIVERSAL_IDENTIFIER,
+ name: 'slack-link-unfurl',
+ description:
+ 'Runs in the resolved workspace: renders Twenty record links shared in Slack as work object previews, when the poster maps to a workspace member.',
+ timeoutSeconds: 15,
+ handler: unfurlSlackRecordLinks,
+});
diff --git a/packages/twenty-apps/public/slack/src/logic-functions/types/slack-events-request-body.type.ts b/packages/twenty-apps/public/slack/src/logic-functions/types/slack-events-request-body.type.ts
index 1f457502dd7..7163030b7df 100644
--- a/packages/twenty-apps/public/slack/src/logic-functions/types/slack-events-request-body.type.ts
+++ b/packages/twenty-apps/public/slack/src/logic-functions/types/slack-events-request-body.type.ts
@@ -8,6 +8,11 @@ type SlackRevokedTokens = {
bot?: string[];
};
+type SlackSharedLink = {
+ url?: string;
+ domain?: string;
+};
+
type SlackInboundEvent = {
type?: string;
subtype?: string;
@@ -20,6 +25,14 @@ type SlackInboundEvent = {
channel?: string;
tab?: string;
tokens?: SlackRevokedTokens;
+ message_ts?: string;
+ unfurl_id?: string;
+ source?: string;
+ links?: SlackSharedLink[];
+ trigger_id?: string;
+ external_ref?: { id?: string; type?: string };
+ link?: SlackSharedLink;
+ entity_url?: string;
};
export type SlackEventsRequestBody = {
diff --git a/packages/twenty-apps/public/slack/src/logic-functions/types/slack-record-link.type.ts b/packages/twenty-apps/public/slack/src/logic-functions/types/slack-record-link.type.ts
new file mode 100644
index 00000000000..5faed9ac75a
--- /dev/null
+++ b/packages/twenty-apps/public/slack/src/logic-functions/types/slack-record-link.type.ts
@@ -0,0 +1,8 @@
+import { type SlackUnfurlObjectName } from 'src/logic-functions/types/slack-unfurl-object-name.type';
+
+export type SlackRecordLink = {
+ sharedUrl: string;
+ canonicalUrl: string;
+ objectNameSingular: SlackUnfurlObjectName;
+ recordId: string;
+};
diff --git a/packages/twenty-apps/public/slack/src/logic-functions/types/slack-unfurl-object-name.type.ts b/packages/twenty-apps/public/slack/src/logic-functions/types/slack-unfurl-object-name.type.ts
new file mode 100644
index 00000000000..fe148a59650
--- /dev/null
+++ b/packages/twenty-apps/public/slack/src/logic-functions/types/slack-unfurl-object-name.type.ts
@@ -0,0 +1,3 @@
+import { type SLACK_UNFURL_OBJECT_NAMES } from 'src/logic-functions/constants/slack-unfurl-object-names';
+
+export type SlackUnfurlObjectName = (typeof SLACK_UNFURL_OBJECT_NAMES)[number];
diff --git a/packages/twenty-apps/public/slack/src/logic-functions/utils/__tests__/build-slack-record-unfurl-entity.test.ts b/packages/twenty-apps/public/slack/src/logic-functions/utils/__tests__/build-slack-record-unfurl-entity.test.ts
new file mode 100644
index 00000000000..a71b7701d7d
--- /dev/null
+++ b/packages/twenty-apps/public/slack/src/logic-functions/utils/__tests__/build-slack-record-unfurl-entity.test.ts
@@ -0,0 +1,221 @@
+import { describe, expect, it } from 'vitest';
+
+import { buildSlackRecordUnfurlEntity } from 'src/logic-functions/utils/build-slack-record-unfurl-entity';
+
+const WORKSPACE_BASE_URL = 'https://acme.twenty.com';
+const PERSON_ID = '20202020-0713-4b29-8f43-1111e2f6a4b1';
+const COMPANY_ID = '20202020-0713-4b29-8f43-2222e2f6a4b2';
+
+const buildPersonRecordLink = () => ({
+ sharedUrl: `${WORKSPACE_BASE_URL}/object/person/${PERSON_ID}`,
+ canonicalUrl: `${WORKSPACE_BASE_URL}/object/person/${PERSON_ID}`,
+ objectNameSingular: 'person' as const,
+ recordId: PERSON_ID,
+});
+
+const buildPersonRecord = () => ({
+ id: PERSON_ID,
+ name: { firstName: 'Ada', lastName: 'Lovelace' },
+ jobTitle: 'CTO',
+ emails: { primaryEmail: '[email protected]' },
+ phones: { primaryPhoneNumber: '5551234', primaryPhoneCallingCode: '+1' },
+ linkedinLink: { primaryLinkUrl: 'https://linkedin.com/in/ada' },
+ company: {
+ id: COMPANY_ID,
+ name: 'ACME',
+ domainName: { primaryLinkUrl: 'acme.dev' },
+ },
+ createdAt: '2026-01-01T00:00:00.000Z',
+ updatedAt: '2026-02-01T00:00:00.000Z',
+});
+
+const OPPORTUNITY_ID = '20202020-0713-4b29-8f43-3333e2f6a4b3';
+
+const buildOpportunityRecordLink = () => ({
+ sharedUrl: `${WORKSPACE_BASE_URL}/object/opportunity/${OPPORTUNITY_ID}`,
+ canonicalUrl: `${WORKSPACE_BASE_URL}/object/opportunity/${OPPORTUNITY_ID}`,
+ objectNameSingular: 'opportunity' as const,
+ recordId: OPPORTUNITY_ID,
+});
+
+const buildOpportunityRecord = () => ({
+ id: OPPORTUNITY_ID,
+ name: 'ACME renewal',
+ stage: 'NEW_CUSTOMER',
+ amount: { amountMicros: 1_500_000_000, currencyCode: 'USD' },
+ closeDate: '2026-03-01T00:00:00.000Z',
+ company: {
+ id: COMPANY_ID,
+ name: 'ACME',
+ domainName: { primaryLinkUrl: 'acme.dev' },
+ },
+ createdAt: '2026-01-01T00:00:00.000Z',
+ updatedAt: '2026-02-01T00:00:00.000Z',
+});
+
+describe('buildSlackRecordUnfurlEntity', () => {
+ it('should build an item entity for a person card', () => {
+ const entity = buildSlackRecordUnfurlEntity({
+ recordLink: buildPersonRecordLink(),
+ record: buildPersonRecord(),
+ workspaceBaseUrls: [WORKSPACE_BASE_URL],
+ });
+
+ expect(entity).toMatchObject({
+ entity_type: 'slack#/entities/item',
+ external_ref: { id: PERSON_ID, type: 'person' },
+ url: `${WORKSPACE_BASE_URL}/object/person/${PERSON_ID}`,
+ app_unfurl_url: `${WORKSPACE_BASE_URL}/object/person/${PERSON_ID}`,
+ entity_payload: {
+ attributes: {
+ title: { text: 'Ada Lovelace' },
+ display_type: 'Person',
+ product_name: 'Twenty',
+ metadata_last_modified: Math.floor(
+ Date.parse('2026-02-01T00:00:00.000Z') / 1000,
+ ),
+ },
+ },
+ });
+ });
+
+ it('should keep the in-channel card to headline fields', () => {
+ const entity = buildSlackRecordUnfurlEntity({
+ recordLink: buildPersonRecordLink(),
+ record: buildPersonRecord(),
+ workspaceBaseUrls: [WORKSPACE_BASE_URL],
+ });
+
+ expect(
+ entity?.entity_payload.custom_fields?.map((field) => field.key),
+ ).toEqual(['company', 'jobTitle']);
+ });
+
+ it('should keep contact details off the channel-visible card', () => {
+ const entity = buildSlackRecordUnfurlEntity({
+ recordLink: buildPersonRecordLink(),
+ record: buildPersonRecord(),
+ workspaceBaseUrls: [WORKSPACE_BASE_URL],
+ });
+
+ expect(
+ entity?.entity_payload.custom_fields?.map((field) => field.key),
+ ).not.toContain('email');
+ expect(
+ entity?.entity_payload.custom_fields?.map((field) => field.key),
+ ).not.toContain('phone');
+ });
+
+ it('should add the detail fields for the flexpane', () => {
+ const entity = buildSlackRecordUnfurlEntity({
+ recordLink: buildPersonRecordLink(),
+ record: buildPersonRecord(),
+ workspaceBaseUrls: [WORKSPACE_BASE_URL],
+ includeDetails: true,
+ });
+
+ expect(
+ entity?.entity_payload.custom_fields?.map((field) => field.key),
+ ).toEqual([
+ 'company',
+ 'jobTitle',
+ 'email',
+ 'phone',
+ 'linkedin',
+ 'createdAt',
+ 'updatedAt',
+ ]);
+ });
+
+ it('should link the company as an entity ref with its logo', () => {
+ const entity = buildSlackRecordUnfurlEntity({
+ recordLink: buildPersonRecordLink(),
+ record: buildPersonRecord(),
+ workspaceBaseUrls: [WORKSPACE_BASE_URL],
+ });
+
+ expect(entity?.entity_payload.custom_fields?.[0]).toEqual({
+ key: 'company',
+ label: 'Company',
+ type: 'slack#/types/entity_ref',
+ entity_ref: {
+ entity_url: `${WORKSPACE_BASE_URL}/object/company/${COMPANY_ID}`,
+ external_ref: { id: COMPANY_ID, type: 'company' },
+ title: 'ACME',
+ icon: { alt_text: 'ACME', url: 'https://twenty-icons.com/acme.dev' },
+ },
+ });
+ });
+
+ it('should absolutize a bare company domain so Slack accepts the link field', () => {
+ const entity = buildSlackRecordUnfurlEntity({
+ recordLink: {
+ sharedUrl: `${WORKSPACE_BASE_URL}/object/company/${COMPANY_ID}`,
+ canonicalUrl: `${WORKSPACE_BASE_URL}/object/company/${COMPANY_ID}`,
+ objectNameSingular: 'company',
+ recordId: COMPANY_ID,
+ },
+ record: { name: 'ACME', domainName: { primaryLinkUrl: 'acme.dev' } },
+ workspaceBaseUrls: [WORKSPACE_BASE_URL],
+ });
+
+ expect(entity?.entity_payload.custom_fields).toContainEqual({
+ key: 'domain',
+ label: 'Domain',
+ type: 'slack#/types/link',
+ value: 'https://acme.dev/',
+ });
+ });
+
+ it('should fall back to the Twenty mark when the record has no icon', () => {
+ const entity = buildSlackRecordUnfurlEntity({
+ recordLink: {
+ sharedUrl: `${WORKSPACE_BASE_URL}/object/note/${PERSON_ID}`,
+ canonicalUrl: `${WORKSPACE_BASE_URL}/object/note/${PERSON_ID}`,
+ objectNameSingular: 'note',
+ recordId: PERSON_ID,
+ },
+ record: { title: 'Kickoff notes' },
+ workspaceBaseUrls: [WORKSPACE_BASE_URL],
+ });
+
+ expect(
+ entity?.entity_payload.attributes.product_icon,
+ ).toMatchObject({ alt_text: 'Twenty' });
+ });
+
+ it('should return undefined when the record has no title', () => {
+ expect(
+ buildSlackRecordUnfurlEntity({
+ recordLink: buildPersonRecordLink(),
+ record: { name: {} },
+ workspaceBaseUrls: [WORKSPACE_BASE_URL],
+ }),
+ ).toBeUndefined();
+ });
+
+ it('should keep the deal amount off the channel-visible card', () => {
+ const entity = buildSlackRecordUnfurlEntity({
+ recordLink: buildOpportunityRecordLink(),
+ record: buildOpportunityRecord(),
+ workspaceBaseUrls: [WORKSPACE_BASE_URL],
+ });
+
+ expect(
+ entity?.entity_payload.custom_fields?.map((field) => field.key),
+ ).toEqual(['company', 'stage', 'closeDate']);
+ });
+
+ it('should add the deal amount to the flexpane', () => {
+ const entity = buildSlackRecordUnfurlEntity({
+ recordLink: buildOpportunityRecordLink(),
+ record: buildOpportunityRecord(),
+ workspaceBaseUrls: [WORKSPACE_BASE_URL],
+ includeDetails: true,
+ });
+
+ expect(
+ entity?.entity_payload.custom_fields?.map((field) => field.key),
+ ).toContain('amount');
+ });
+});
diff --git a/packages/twenty-apps/public/slack/src/logic-functions/utils/__tests__/extract-http-urls.test.ts b/packages/twenty-apps/public/slack/src/logic-functions/utils/__tests__/extract-http-urls.test.ts
new file mode 100644
index 00000000000..dabc57781c5
--- /dev/null
+++ b/packages/twenty-apps/public/slack/src/logic-functions/utils/__tests__/extract-http-urls.test.ts
@@ -0,0 +1,54 @@
+import { describe, expect, it } from 'vitest';
+
+import { extractHttpUrls } from 'src/logic-functions/utils/extract-http-urls';
+
+describe('extractHttpUrls', () => {
+ it('should extract bare URLs and drop trailing punctuation', () => {
+ expect(
+ extractHttpUrls('See https://acme.dev/a, then https://acme.dev/b.'),
+ ).toEqual(['https://acme.dev/a', 'https://acme.dev/b']);
+ });
+
+ it('should extract the URL from markdown links', () => {
+ expect(extractHttpUrls('[ACME](https://acme.dev/about)')).toEqual([
+ 'https://acme.dev/about',
+ ]);
+ });
+
+ it('should extract the URL from Slack mrkdwn links', () => {
+ expect(extractHttpUrls('<https://acme.dev/about|ACME>')).toEqual([
+ 'https://acme.dev/about',
+ ]);
+ });
+
+ it('should keep query punctuation that belongs to the URL', () => {
+ expect(extractHttpUrls('https://acme.dev/a?q=hi!')).toEqual([
+ 'https://acme.dev/a?q=hi!',
+ ]);
+ });
+
+ it('should trim sentence punctuation from a URL with no query', () => {
+ expect(extractHttpUrls('See https://acme.dev/object/company/x!')).toEqual([
+ 'https://acme.dev/object/company/x',
+ ]);
+ expect(extractHttpUrls('Really https://acme.dev/a?')).toEqual([
+ 'https://acme.dev/a',
+ ]);
+ });
+
+ it('should not keep wrapping delimiters', () => {
+ expect(extractHttpUrls('"https://acme.dev/a"')).toEqual([
+ 'https://acme.dev/a',
+ ]);
+ expect(extractHttpUrls('*https://acme.dev/a*')).toEqual([
+ 'https://acme.dev/a',
+ ]);
+ expect(extractHttpUrls('(https://acme.dev/a)')).toEqual([
+ 'https://acme.dev/a',
+ ]);
+ });
+
+ it('should return an empty list when there is no URL', () => {
+ expect(extractHttpUrls('no links here')).toEqual([]);
+ });
+});
diff --git a/packages/twenty-apps/public/slack/src/logic-functions/utils/__tests__/format-amount.test.ts b/packages/twenty-apps/public/slack/src/logic-functions/utils/__tests__/format-amount.test.ts
new file mode 100644
index 00000000000..c2e83367d3d
--- /dev/null
+++ b/packages/twenty-apps/public/slack/src/logic-functions/utils/__tests__/format-amount.test.ts
@@ -0,0 +1,27 @@
+import { describe, expect, it } from 'vitest';
+
+import { formatAmount } from 'src/logic-functions/utils/format-amount';
+
+describe('formatAmount', () => {
+ it('should format micros as a currency amount', () => {
+ expect(
+ formatAmount({ amountMicros: 1_500_000_000, currencyCode: 'USD' }),
+ ).toBe('$1,500.00');
+ });
+
+ it('should fall back to a plain number for an unknown currency code', () => {
+ expect(
+ formatAmount({ amountMicros: 1_500_000_000, currencyCode: 'NOPE' }),
+ ).toBe('1,500');
+ });
+
+ it('should format without a currency code', () => {
+ expect(formatAmount({ amountMicros: 2_000_000 })).toBe('2');
+ });
+
+ it('should return undefined without a numeric amount', () => {
+ expect(formatAmount(undefined)).toBeUndefined();
+ expect(formatAmount({ currencyCode: 'USD' })).toBeUndefined();
+ expect(formatAmount({ amountMicros: 'high' })).toBeUndefined();
+ });
+});
diff --git a/packages/twenty-apps/public/slack/src/logic-functions/utils/__tests__/get-company-logo-url.test.ts b/packages/twenty-apps/public/slack/src/logic-functions/utils/__tests__/get-company-logo-url.test.ts
new file mode 100644
index 00000000000..55bc0c1d477
--- /dev/null
+++ b/packages/twenty-apps/public/slack/src/logic-functions/utils/__tests__/get-company-logo-url.test.ts
@@ -0,0 +1,32 @@
+import { describe, expect, it } from 'vitest';
+
+import { getCompanyLogoUrl } from 'src/logic-functions/utils/get-company-logo-url';
+
+describe('getCompanyLogoUrl', () => {
+ it('should build a twenty-icons URL from a bare domain', () => {
+ expect(getCompanyLogoUrl('acme.dev')).toBe(
+ 'https://twenty-icons.com/acme.dev',
+ );
+ });
+
+ it('should strip the scheme, path and www prefix', () => {
+ expect(getCompanyLogoUrl('https://www.acme.dev/about')).toBe(
+ 'https://twenty-icons.com/acme.dev',
+ );
+ });
+
+ it('should handle an upper-case scheme', () => {
+ expect(getCompanyLogoUrl('HTTP://acme.dev')).toBe(
+ 'https://twenty-icons.com/acme.dev',
+ );
+ });
+
+ it('should return undefined for empty or missing input', () => {
+ expect(getCompanyLogoUrl(undefined)).toBeUndefined();
+ expect(getCompanyLogoUrl(' ')).toBeUndefined();
+ });
+
+ it('should return undefined for an unparsable domain', () => {
+ expect(getCompanyLogoUrl('https://')).toBeUndefined();
+ });
+});
diff --git a/packages/twenty-apps/public/slack/src/logic-functions/utils/__tests__/get-public-avatar-url.test.ts b/packages/twenty-apps/public/slack/src/logic-functions/utils/__tests__/get-public-avatar-url.test.ts
new file mode 100644
index 00000000000..2c756cfc93f
--- /dev/null
+++ b/packages/twenty-apps/public/slack/src/logic-functions/utils/__tests__/get-public-avatar-url.test.ts
@@ -0,0 +1,49 @@
+import { describe, expect, it } from 'vitest';
+
+import { getPublicAvatarUrl } from 'src/logic-functions/utils/get-public-avatar-url';
+
+const WORKSPACE_BASE_URL = 'https://acme.twenty.com';
+
+describe('getPublicAvatarUrl', () => {
+ it('should keep a public absolute avatar URL', () => {
+ expect(
+ getPublicAvatarUrl({
+ avatarUrl: 'https://cdn.example.com/ada.png',
+ workspaceBaseUrls: [WORKSPACE_BASE_URL],
+ }),
+ ).toBe('https://cdn.example.com/ada.png');
+ });
+
+ it('should drop instance-hosted avatars Slack cannot fetch', () => {
+ expect(
+ getPublicAvatarUrl({
+ avatarUrl: `${WORKSPACE_BASE_URL}/files/avatar.png`,
+ workspaceBaseUrls: [WORKSPACE_BASE_URL],
+ }),
+ ).toBeUndefined();
+ });
+
+ it('should drop an instance-hosted avatar served from the other workspace host', () => {
+ expect(
+ getPublicAvatarUrl({
+ avatarUrl: 'https://acme.twenty.com/files/avatar.png',
+ workspaceBaseUrls: ['https://crm.acme.com', 'https://acme.twenty.com'],
+ }),
+ ).toBeUndefined();
+ });
+
+ it('should drop relative paths and non-string values', () => {
+ expect(
+ getPublicAvatarUrl({
+ avatarUrl: '/files/avatar.png',
+ workspaceBaseUrls: [WORKSPACE_BASE_URL],
+ }),
+ ).toBeUndefined();
+ expect(
+ getPublicAvatarUrl({
+ avatarUrl: null,
+ workspaceBaseUrls: [WORKSPACE_BASE_URL],
+ }),
+ ).toBeUndefined();
+ });
+});
diff --git a/packages/twenty-apps/public/slack/src/logic-functions/utils/__tests__/parse-slack-entity-details-event.test.ts b/packages/twenty-apps/public/slack/src/logic-functions/utils/__tests__/parse-slack-entity-details-event.test.ts
new file mode 100644
index 00000000000..475d32cdcab
--- /dev/null
+++ b/packages/twenty-apps/public/slack/src/logic-functions/utils/__tests__/parse-slack-entity-details-event.test.ts
@@ -0,0 +1,81 @@
+import { describe, expect, it } from 'vitest';
+
+import { parseSlackEntityDetailsEvent } from 'src/logic-functions/utils/parse-slack-entity-details-event';
+
+const buildEntityDetailsBody = ({
+ eventOverrides = {},
+}: { eventOverrides?: Record<string, unknown> } = {}) => ({
+ type: 'event_callback',
+ event: {
+ type: 'entity_details_requested',
+ trigger_id: 'Tr123',
+ user: 'U123',
+ link: {
+ url: 'https://acme.twenty.com/object/person/abc',
+ domain: 'acme.twenty.com',
+ },
+ entity_url: 'https://acme.twenty.com/object/person/abc',
+ external_ref: { id: 'abc', type: 'person' },
+ ...eventOverrides,
+ },
+});
+
+describe('parseSlackEntityDetailsEvent', () => {
+ it('should parse an entity_details_requested event', () => {
+ expect(parseSlackEntityDetailsEvent(buildEntityDetailsBody())).toEqual({
+ detailsRequest: {
+ triggerId: 'Tr123',
+ slackUserId: 'U123',
+ entityUrl: 'https://acme.twenty.com/object/person/abc',
+ externalRef: { id: 'abc', type: 'person' },
+ },
+ });
+ });
+
+ it('should fall back to entity_url when the link is missing', () => {
+ const result = parseSlackEntityDetailsEvent(
+ buildEntityDetailsBody({ eventOverrides: { link: undefined } }),
+ );
+
+ expect(result.detailsRequest?.entityUrl).toBe(
+ 'https://acme.twenty.com/object/person/abc',
+ );
+ });
+
+ it('should keep the external_ref without a type', () => {
+ const result = parseSlackEntityDetailsEvent(
+ buildEntityDetailsBody({
+ eventOverrides: { external_ref: { id: 'abc' } },
+ }),
+ );
+
+ expect(result.detailsRequest?.externalRef).toEqual({
+ id: 'abc',
+ type: undefined,
+ });
+ });
+
+ it('should skip an event with no trigger_id', () => {
+ const result = parseSlackEntityDetailsEvent(
+ buildEntityDetailsBody({ eventOverrides: { trigger_id: undefined } }),
+ );
+
+ expect(result.detailsRequest).toBeNull();
+ });
+
+ it('should skip an event with no user, since the viewer gate needs one', () => {
+ const result = parseSlackEntityDetailsEvent(
+ buildEntityDetailsBody({ eventOverrides: { user: undefined } }),
+ );
+
+ expect(result.detailsRequest).toBeNull();
+ });
+
+ it('should skip other event types', () => {
+ const result = parseSlackEntityDetailsEvent(
+ buildEntityDetailsBody({ eventOverrides: { type: 'link_shared' } }),
+ );
+
+ expect(result.detailsRequest).toBeNull();
+ });
+});
diff --git a/packages/twenty-apps/public/slack/src/logic-functions/utils/__tests__/parse-slack-link-shared-event.test.ts b/packages/twenty-apps/public/slack/src/logic-functions/utils/__tests__/parse-slack-link-shared-event.test.ts
new file mode 100644
index 00000000000..89637dd5c08
--- /dev/null
+++ b/packages/twenty-apps/public/slack/src/logic-functions/utils/__tests__/parse-slack-link-shared-event.test.ts
@@ -0,0 +1,103 @@
+import { describe, expect, it } from 'vitest';
+
+import { parseSlackLinkSharedEvent } from 'src/logic-functions/utils/parse-slack-link-shared-event';
+
+const buildLinkSharedBody = ({
+ eventOverrides = {},
+}: { eventOverrides?: Record<string, unknown> } = {}) => ({
+ type: 'event_callback',
+ event: {
+ type: 'link_shared',
+ channel: 'C123',
+ message_ts: '1700000000.000100',
+ user: 'U123',
+ links: [
+ { url: 'https://acme.twenty.com/object/person/abc', domain: 'acme.twenty.com' },
+ ],
+ ...eventOverrides,
+ },
+});
+
+const buildComposerLinkSharedBody = ({
+ eventOverrides = {},
+}: { eventOverrides?: Record<string, unknown> } = {}) =>
+ buildLinkSharedBody({
+ eventOverrides: {
+ channel: undefined,
+ channel_id: 'COMPOSER',
+ source: 'composer',
+ unfurl_id: 'gryl3kb80b3wm49ihzoo35fyqoq08n2y',
+ message_ts: 'gryl3kb80b3wm49ihzoo35fyqoq08n2y',
+ ...eventOverrides,
+ },
+ });
+
+describe('parseSlackLinkSharedEvent', () => {
+ it('should parse a link_shared event', () => {
+ expect(parseSlackLinkSharedEvent(buildLinkSharedBody())).toEqual({
+ linkShared: {
+ unfurlTarget: {
+ source: 'conversations_history',
+ slackChannelId: 'C123',
+ messageTimestamp: '1700000000.000100',
+ },
+ slackUserId: 'U123',
+ urls: ['https://acme.twenty.com/object/person/abc'],
+ },
+ });
+ });
+
+ it('should parse a composer link_shared event', () => {
+ expect(parseSlackLinkSharedEvent(buildComposerLinkSharedBody())).toEqual({
+ linkShared: {
+ unfurlTarget: {
+ source: 'composer',
+ unfurlId: 'gryl3kb80b3wm49ihzoo35fyqoq08n2y',
+ },
+ slackUserId: 'U123',
+ urls: ['https://acme.twenty.com/object/person/abc'],
+ },
+ });
+ });
+
+ it('should skip a composer event missing its unfurl id', () => {
+ const result = parseSlackLinkSharedEvent(
+ buildComposerLinkSharedBody({ eventOverrides: { unfurl_id: undefined } }),
+ );
+
+ expect(result.linkShared).toBeNull();
+ });
+
+ it('should skip other body types', () => {
+ const result = parseSlackLinkSharedEvent({ type: 'url_verification' });
+
+ expect(result.linkShared).toBeNull();
+ });
+
+ it('should skip other event types', () => {
+ const result = parseSlackLinkSharedEvent(
+ buildLinkSharedBody({ eventOverrides: { type: 'app_mention' } }),
+ );
+
+ expect(result.linkShared).toBeNull();
+ });
+
+ it.each(['channel', 'message_ts', 'user'])(
+ 'should skip an event missing %s',
+ (missingField) => {
+ const result = parseSlackLinkSharedEvent(
+ buildLinkSharedBody({ eventOverrides: { [missingField]: undefined } }),
+ );
+
+ expect(result.linkShared).toBeNull();
+ },
+ );
+
+ it('should skip an event with no usable link URLs', () => {
+ const result = parseSlackLinkSharedEvent(
+ buildLinkSharedBody({ eventOverrides: { links: [{ domain: 'a.com' }] } }),
+ );
+
+ expect(result.linkShared).toBeNull();
+ });
+});
diff --git a/packages/twenty-apps/public/slack/src/logic-functions/utils/__tests__/parse-twenty-record-links.test.ts b/packages/twenty-apps/public/slack/src/logic-functions/utils/__tests__/parse-twenty-record-links.test.ts
new file mode 100644
index 00000000000..87d499cde89
--- /dev/null
+++ b/packages/twenty-apps/public/slack/src/logic-functions/utils/__tests__/parse-twenty-record-links.test.ts
@@ -0,0 +1,156 @@
+import { describe, expect, it } from 'vitest';
+
+import { parseTwentyRecordLinks } from 'src/logic-functions/utils/parse-twenty-record-links';
+
+const WORKSPACE_BASE_URL = 'https://acme.twenty.com';
+const RECORD_ID = '20202020-0713-4b29-8f43-1111e2f6a4b1';
+
+describe('parseTwentyRecordLinks', () => {
+ it('should match a link on any workspace host and canonicalize it to the first', () => {
+ const subdomainUrl = 'https://acme.twenty.com';
+ const customUrl = 'https://crm.acme.com';
+ const sharedUrl = `${subdomainUrl}/object/person/${RECORD_ID}`;
+
+ const [recordLink] = parseTwentyRecordLinks({
+ workspaceBaseUrls: [customUrl, subdomainUrl],
+ urls: [sharedUrl],
+ });
+
+ expect(recordLink).toEqual({
+ sharedUrl,
+ canonicalUrl: `${customUrl}/object/person/${RECORD_ID}`,
+ objectNameSingular: 'person',
+ recordId: RECORD_ID,
+ });
+ });
+
+ it('should deduplicate a record shared from two different workspace hosts', () => {
+ const subdomainUrl = 'https://acme.twenty.com';
+ const customUrl = 'https://crm.acme.com';
+
+ const recordLinks = parseTwentyRecordLinks({
+ workspaceBaseUrls: [customUrl, subdomainUrl],
+ urls: [
+ `${customUrl}/object/person/${RECORD_ID}`,
+ `${subdomainUrl}/object/person/${RECORD_ID}`,
+ ],
+ });
+
+ expect(recordLinks).toHaveLength(1);
+ });
+
+ it('should parse a record link for every supported object', () => {
+ const urls = ['person', 'company', 'opportunity', 'note', 'task'].map(
+ (objectNameSingular) =>
+ `${WORKSPACE_BASE_URL}/object/${objectNameSingular}/${RECORD_ID}`,
+ );
+
+ const recordLinks = parseTwentyRecordLinks({
+ workspaceBaseUrls: [WORKSPACE_BASE_URL],
+ urls,
+ });
+
+ expect(recordLinks.map((recordLink) => recordLink.objectNameSingular)).toEqual([
+ 'person',
+ 'company',
+ 'opportunity',
+ 'note',
+ 'task',
+ ]);
+ expect(recordLinks[0]).toEqual({
+ sharedUrl: urls[0],
+ canonicalUrl: urls[0],
+ objectNameSingular: 'person',
+ recordId: RECORD_ID,
+ });
+ });
+
+ it.each([
+ ['a query param', `${WORKSPACE_BASE_URL}/object/person/${RECORD_ID}?view=table`],
+ ['a fragment', `${WORKSPACE_BASE_URL}/object/person/${RECORD_ID}#section`],
+ ['a trailing slash', `${WORKSPACE_BASE_URL}/object/person/${RECORD_ID}/`],
+ ])('should keep %s off the parsed record id', (_label, url) => {
+ expect(
+ parseTwentyRecordLinks({
+ workspaceBaseUrls: [WORKSPACE_BASE_URL],
+ urls: [url],
+ }).map((recordLink) => recordLink.recordId),
+ ).toEqual([RECORD_ID]);
+ });
+
+ it('should normalize the HTML-escaped ampersands Slack sends', () => {
+ const recordLinks = parseTwentyRecordLinks({
+ workspaceBaseUrls: [WORKSPACE_BASE_URL],
+ urls: [`${WORKSPACE_BASE_URL}/object/person/${RECORD_ID}?a=1&amp;b=2`],
+ });
+
+ expect(recordLinks).toHaveLength(1);
+ });
+
+ it('should deduplicate repeated URLs', () => {
+ const url = `${WORKSPACE_BASE_URL}/object/company/${RECORD_ID}`;
+
+ expect(
+ parseTwentyRecordLinks({
+ workspaceBaseUrls: [WORKSPACE_BASE_URL],
+ urls: [url, url, url],
+ }),
+ ).toHaveLength(1);
+ });
+
+ it('should deduplicate URL spellings that point at the same record', () => {
+ expect(
+ parseTwentyRecordLinks({
+ workspaceBaseUrls: [WORKSPACE_BASE_URL],
+ urls: [
+ `${WORKSPACE_BASE_URL}/object/company/${RECORD_ID}`,
+ `${WORKSPACE_BASE_URL}/object/company/${RECORD_ID}/`,
+ `${WORKSPACE_BASE_URL}/object/company/${RECORD_ID}?a=1&b=2`,
+ `${WORKSPACE_BASE_URL}/object/company/${RECORD_ID}?a=1&amp;b=2`,
+ ],
+ }),
+ ).toHaveLength(1);
+ });
+
+ it('should keep the shared URL for matching and a canonical URL for the link', () => {
+ const sharedUrl = `${WORKSPACE_BASE_URL}/object/person/${RECORD_ID}?view=table#top`;
+
+ expect(
+ parseTwentyRecordLinks({
+ workspaceBaseUrls: [WORKSPACE_BASE_URL],
+ urls: [sharedUrl],
+ })[0],
+ ).toEqual({
+ sharedUrl,
+ canonicalUrl: `${WORKSPACE_BASE_URL}/object/person/${RECORD_ID}`,
+ objectNameSingular: 'person',
+ recordId: RECORD_ID,
+ });
+ });
+
+ it('should skip links from another host', () => {
+ expect(
+ parseTwentyRecordLinks({
+ workspaceBaseUrls: [WORKSPACE_BASE_URL],
+ urls: [
+ `https://other.twenty.com/object/person/${RECORD_ID}`,
+ `https://acme.twenty.com.evil.com/object/person/${RECORD_ID}`,
+ ],
+ }),
+ ).toEqual([]);
+ });
+
+ it('should skip unsupported objects, non-record paths and invalid ids', () => {
+ expect(
+ parseTwentyRecordLinks({
+ workspaceBaseUrls: [WORKSPACE_BASE_URL],
+ urls: [
+ `${WORKSPACE_BASE_URL}/object/rocket/${RECORD_ID}`,
+ `${WORKSPACE_BASE_URL}/settings/members`,
+ `${WORKSPACE_BASE_URL}/object/person/not-a-uuid`,
+ `${WORKSPACE_BASE_URL}/object/person/${RECORD_ID}/extra`,
+ ],
+ }),
+ ).toEqual([]);
+ });
+});
diff --git a/packages/twenty-apps/public/slack/src/logic-functions/utils/__tests__/to-absolute-http-url.test.ts b/packages/twenty-apps/public/slack/src/logic-functions/utils/__tests__/to-absolute-http-url.test.ts
new file mode 100644
index 00000000000..fa1e42229a0
--- /dev/null
+++ b/packages/twenty-apps/public/slack/src/logic-functions/utils/__tests__/to-absolute-http-url.test.ts
@@ -0,0 +1,21 @@
+import { describe, expect, it } from 'vitest';
+
+import { toAbsoluteHttpUrl } from 'src/logic-functions/utils/to-absolute-http-url';
+
+describe('toAbsoluteHttpUrl', () => {
+ it('should reject values whose scheme is not http(s)', () => {
+ expect(toAbsoluteHttpUrl('mailto:[email protected]')).toBeUndefined();
+ expect(toAbsoluteHttpUrl('ftp://acme.dev/x')).toBeUndefined();
+ });
+
+ it('should treat a colon before digits as a port, not a scheme', () => {
+ expect(toAbsoluteHttpUrl('acme.dev:8080/x')).toBe(
+ 'https://acme.dev:8080/x',
+ );
+ });
+
+ it('should prefix a bare domain and keep an absolute URL as is', () => {
+ expect(toAbsoluteHttpUrl('acme.dev')).toBe('https://acme.dev/');
+ expect(toAbsoluteHttpUrl('https://acme.dev/a')).toBe('https://acme.dev/a');
+ });
+});
diff --git a/packages/twenty-apps/public/slack/src/logic-functions/utils/build-full-name.ts b/packages/twenty-apps/public/slack/src/logic-functions/utils/build-full-name.ts
new file mode 100644
index 00000000000..299df31b987
--- /dev/null
+++ b/packages/twenty-apps/public/slack/src/logic-functions/utils/build-full-name.ts
@@ -0,0 +1,17 @@
+import { isNonEmptyString } from '@sniptt/guards';
+import { isDefined } from 'twenty-sdk/utils';
+
+import { asRecord } from 'src/logic-functions/utils/as-record.util';
+import { readOptionalString } from 'src/logic-functions/utils/read-optional-string.util';
+
+export const buildFullName = (nameValue: unknown): string | undefined => {
+ const name = asRecord(nameValue);
+ const fullName = [
+ readOptionalString(name?.firstName),
+ readOptionalString(name?.lastName),
+ ]
+ .filter(isDefined)
+ .join(' ');
+
+ return isNonEmptyString(fullName) ? fullName : undefined;
+};
diff --git a/packages/twenty-apps/public/slack/src/logic-functions/utils/build-slack-body-preview-field.ts b/packages/twenty-apps/public/slack/src/logic-functions/utils/build-slack-body-preview-field.ts
new file mode 100644
index 00000000000..7d26a1ee1b4
--- /dev/null
+++ b/packages/twenty-apps/public/slack/src/logic-functions/utils/build-slack-body-preview-field.ts
@@ -0,0 +1,33 @@
+import { type EntityCustomField } from '@slack/web-api';
+import { isNonEmptyString } from '@sniptt/guards';
+
+import { SLACK_ENTITY_FIELD_TYPE } from 'src/logic-functions/constants/slack-entity-field-type';
+import { asRecord } from 'src/logic-functions/utils/as-record.util';
+import { readOptionalString } from 'src/logic-functions/utils/read-optional-string.util';
+
+const BODY_PREVIEW_MAX_LENGTH = 300;
+
+export const buildSlackBodyPreviewField = (
+ bodyValue: unknown,
+): EntityCustomField | undefined => {
+ const markdown = readOptionalString(asRecord(bodyValue)?.markdown)?.trim();
+
+ if (!isNonEmptyString(markdown)) {
+ return undefined;
+ }
+
+ const codePoints = [...markdown];
+
+ const preview =
+ codePoints.length > BODY_PREVIEW_MAX_LENGTH
+ ? `${codePoints.slice(0, BODY_PREVIEW_MAX_LENGTH).join('')}…`
+ : markdown;
+
+ return {
+ key: 'body',
+ label: 'Body',
+ type: SLACK_ENTITY_FIELD_TYPE.STRING,
+ value: preview,
+ long: true,
+ };
+};
diff --git a/packages/twenty-apps/public/slack/src/logic-functions/utils/build-slack-company-ref-field.ts b/packages/twenty-apps/public/slack/src/logic-functions/utils/build-slack-company-ref-field.ts
new file mode 100644
index 00000000000..7296d2ad987
--- /dev/null
+++ b/packages/twenty-apps/public/slack/src/logic-functions/utils/build-slack-company-ref-field.ts
@@ -0,0 +1,34 @@
+import { type EntityCustomField } from '@slack/web-api';
+import { isDefined } from 'twenty-sdk/utils';
+
+import { asRecord } from 'src/logic-functions/utils/as-record.util';
+import { buildSlackRecordRefField } from 'src/logic-functions/utils/build-slack-record-ref-field';
+import { getCompanyLogoUrl } from 'src/logic-functions/utils/get-company-logo-url';
+import { readOptionalString } from 'src/logic-functions/utils/read-optional-string.util';
+
+export const buildSlackCompanyRefField = ({
+ company,
+ workspaceBaseUrl,
+}: {
+ company: Record<string, unknown> | undefined;
+ workspaceBaseUrl: string;
+}): EntityCustomField | undefined => {
+ const companyId = readOptionalString(company?.id);
+ const companyName = readOptionalString(company?.name);
+
+ if (!isDefined(companyId) || !isDefined(companyName)) {
+ return undefined;
+ }
+
+ return buildSlackRecordRefField({
+ key: 'company',
+ label: 'Company',
+ objectNameSingular: 'company',
+ recordId: companyId,
+ title: companyName,
+ iconUrl: getCompanyLogoUrl(
+ readOptionalString(asRecord(company?.domainName)?.primaryLinkUrl),
+ ),
+ workspaceBaseUrl,
+ });
+};
diff --git a/packages/twenty-apps/public/slack/src/logic-functions/utils/build-slack-linkedin-field.ts b/packages/twenty-apps/public/slack/src/logic-functions/utils/build-slack-linkedin-field.ts
new file mode 100644
index 00000000000..b786f166b84
--- /dev/null
+++ b/packages/twenty-apps/public/slack/src/logic-functions/utils/build-slack-linkedin-field.ts
@@ -0,0 +1,19 @@
+import { type EntityCustomField } from '@slack/web-api';
+
+import { SLACK_ENTITY_FIELD_TYPE } from 'src/logic-functions/constants/slack-entity-field-type';
+import { asRecord } from 'src/logic-functions/utils/as-record.util';
+import { buildSlackStringField } from 'src/logic-functions/utils/build-slack-string-field';
+import { readOptionalString } from 'src/logic-functions/utils/read-optional-string.util';
+import { toAbsoluteHttpUrl } from 'src/logic-functions/utils/to-absolute-http-url';
+
+export const buildSlackLinkedinField = (
+ record: Record<string, unknown>,
+): EntityCustomField | undefined =>
+ buildSlackStringField({
+ key: 'linkedin',
+ label: 'LinkedIn',
+ value: toAbsoluteHttpUrl(
+ readOptionalString(asRecord(record.linkedinLink)?.primaryLinkUrl),
+ ),
+ type: SLACK_ENTITY_FIELD_TYPE.LINK,
+ });
diff --git a/packages/twenty-apps/public/slack/src/logic-functions/utils/build-slack-record-content.ts b/packages/twenty-apps/public/slack/src/logic-functions/utils/build-slack-record-content.ts
new file mode 100644
index 00000000000..85cf62ace5c
--- /dev/null
+++ b/packages/twenty-apps/public/slack/src/logic-functions/utils/build-slack-record-content.ts
@@ -0,0 +1,253 @@
+import { type EntityCustomField } from '@slack/web-api';
+import { isDefined } from 'twenty-sdk/utils';
+
+import { SLACK_ENTITY_FIELD_TYPE } from 'src/logic-functions/constants/slack-entity-field-type';
+import { type SlackUnfurlObjectName } from 'src/logic-functions/types/slack-unfurl-object-name.type';
+import { asRecord } from 'src/logic-functions/utils/as-record.util';
+import { buildFullName } from 'src/logic-functions/utils/build-full-name';
+import { buildSlackBodyPreviewField } from 'src/logic-functions/utils/build-slack-body-preview-field';
+import { buildSlackCompanyRefField } from 'src/logic-functions/utils/build-slack-company-ref-field';
+import { buildSlackLinkedinField } from 'src/logic-functions/utils/build-slack-linkedin-field';
+import { buildSlackRecordRefField } from 'src/logic-functions/utils/build-slack-record-ref-field';
+import { buildSlackStringField } from 'src/logic-functions/utils/build-slack-string-field';
+import { buildSlackTimestampDetailFields } from 'src/logic-functions/utils/build-slack-timestamp-detail-fields';
+import { buildSlackTimestampField } from 'src/logic-functions/utils/build-slack-timestamp-field';
+import { formatAmount } from 'src/logic-functions/utils/format-amount';
+import { getCompanyLogoUrl } from 'src/logic-functions/utils/get-company-logo-url';
+import { getPublicAvatarUrl } from 'src/logic-functions/utils/get-public-avatar-url';
+import { humanizeSelectValue } from 'src/logic-functions/utils/humanize-select-value';
+import { readOptionalString } from 'src/logic-functions/utils/read-optional-string.util';
+import { toAbsoluteHttpUrl } from 'src/logic-functions/utils/to-absolute-http-url';
+
+type SlackUnfurlContentArgs = {
+ record: Record<string, unknown>;
+ workspaceBaseUrls: string[];
+ includeDetails: boolean;
+};
+
+type SlackUnfurlContent = {
+ title: string;
+ customFields: (EntityCustomField | undefined)[];
+ iconUrl?: string;
+};
+
+const buildPersonContent = ({
+ record,
+ workspaceBaseUrls,
+ includeDetails,
+}: SlackUnfurlContentArgs): SlackUnfurlContent => {
+ const phones = asRecord(record.phones);
+ const phoneNumber = readOptionalString(phones?.primaryPhoneNumber);
+ const phoneCallingCode = readOptionalString(phones?.primaryPhoneCallingCode);
+ const phone = isDefined(phoneNumber)
+ ? [phoneCallingCode, phoneNumber].filter(isDefined).join(' ')
+ : undefined;
+
+ return {
+ title: buildFullName(record.name) ?? '',
+ iconUrl: getPublicAvatarUrl({
+ avatarUrl: record.avatarUrl,
+ workspaceBaseUrls,
+ }),
+ customFields: [
+ buildSlackCompanyRefField({
+ company: asRecord(record.company),
+ workspaceBaseUrl: workspaceBaseUrls[0],
+ }),
+ buildSlackStringField({
+ key: 'jobTitle',
+ label: 'Job title',
+ value: readOptionalString(record.jobTitle),
+ }),
+ // the card is visible to everyone in the channel, Slack Connect guests
+ // included, so contact details stay in the member-gated flexpane
+ ...(includeDetails
+ ? [
+ buildSlackStringField({
+ key: 'email',
+ label: 'Email',
+ value: readOptionalString(asRecord(record.emails)?.primaryEmail),
+ type: SLACK_ENTITY_FIELD_TYPE.EMAIL,
+ }),
+ buildSlackStringField({
+ key: 'phone',
+ label: 'Phone',
+ value: phone,
+ }),
+ buildSlackLinkedinField(record),
+ ...buildSlackTimestampDetailFields(record),
+ ]
+ : []),
+ ],
+ };
+};
+
+const buildCompanyContent = ({
+ record,
+ includeDetails,
+}: SlackUnfurlContentArgs): SlackUnfurlContent => {
+ const domainUrl = readOptionalString(
+ asRecord(record.domainName)?.primaryLinkUrl,
+ );
+ const address = asRecord(record.address);
+
+ return {
+ title: readOptionalString(record.name) ?? '',
+ iconUrl: getCompanyLogoUrl(domainUrl),
+ customFields: [
+ buildSlackStringField({
+ key: 'domain',
+ label: 'Domain',
+ value: toAbsoluteHttpUrl(domainUrl),
+ type: SLACK_ENTITY_FIELD_TYPE.LINK,
+ }),
+ buildSlackStringField({
+ key: 'city',
+ label: 'City',
+ value: readOptionalString(address?.addressCity),
+ }),
+ ...(includeDetails
+ ? [
+ buildSlackStringField({
+ key: 'country',
+ label: 'Country',
+ value: readOptionalString(address?.addressCountry),
+ }),
+ buildSlackStringField({
+ key: 'annualRevenue',
+ label: 'Annual revenue',
+ value: formatAmount(asRecord(record.annualRevenue)),
+ }),
+ buildSlackStringField({
+ key: 'accountOwner',
+ label: 'Account owner',
+ value: buildFullName(asRecord(record.accountOwner)?.name),
+ }),
+ buildSlackLinkedinField(record),
+ ...buildSlackTimestampDetailFields(record),
+ ]
+ : []),
+ ],
+ };
+};
+
+const buildOpportunityContent = ({
+ record,
+ workspaceBaseUrls,
+ includeDetails,
+}: SlackUnfurlContentArgs): SlackUnfurlContent => {
+ const stage = readOptionalString(record.stage);
+ const company = asRecord(record.company);
+ const pointOfContact = asRecord(record.pointOfContact);
+ const pointOfContactId = readOptionalString(pointOfContact?.id);
+ const pointOfContactName = buildFullName(pointOfContact?.name);
+
+ return {
+ title: readOptionalString(record.name) ?? '',
+ iconUrl: getCompanyLogoUrl(
+ readOptionalString(asRecord(company?.domainName)?.primaryLinkUrl),
+ ),
+ customFields: [
+ buildSlackCompanyRefField({
+ company,
+ workspaceBaseUrl: workspaceBaseUrls[0],
+ }),
+ buildSlackStringField({
+ key: 'stage',
+ label: 'Stage',
+ value: isDefined(stage) ? humanizeSelectValue(stage) : undefined,
+ }),
+ buildSlackTimestampField({
+ key: 'closeDate',
+ label: 'Close date',
+ value: record.closeDate,
+ }),
+ ...(includeDetails
+ ? [
+ // deal value is as sensitive as a person's contact details, and the
+ // card reaches Slack Connect guests, so it stays in the flexpane
+ buildSlackStringField({
+ key: 'amount',
+ label: 'Amount',
+ value: formatAmount(asRecord(record.amount)),
+ }),
+ isDefined(pointOfContactId) && isDefined(pointOfContactName)
+ ? buildSlackRecordRefField({
+ key: 'pointOfContact',
+ label: 'Point of contact',
+ objectNameSingular: 'person',
+ recordId: pointOfContactId,
+ title: pointOfContactName,
+ workspaceBaseUrl: workspaceBaseUrls[0],
+ })
+ : undefined,
+ ...buildSlackTimestampDetailFields(record),
+ ]
+ : []),
+ ],
+ };
+};
+
+const buildNoteContent = ({
+ record,
+ includeDetails,
+}: SlackUnfurlContentArgs): SlackUnfurlContent => ({
+ title: readOptionalString(record.title) ?? '',
+ customFields: includeDetails
+ ? [
+ buildSlackBodyPreviewField(record.bodyV2),
+ ...buildSlackTimestampDetailFields(record),
+ ]
+ : [
+ buildSlackTimestampField({
+ key: 'createdAt',
+ label: 'Created',
+ value: record.createdAt,
+ }),
+ ],
+});
+
+const buildTaskContent = ({
+ record,
+ includeDetails,
+}: SlackUnfurlContentArgs): SlackUnfurlContent => {
+ const status = readOptionalString(record.status);
+
+ return {
+ title: readOptionalString(record.title) ?? '',
+ customFields: [
+ buildSlackStringField({
+ key: 'status',
+ label: 'Status',
+ value: isDefined(status) ? humanizeSelectValue(status) : undefined,
+ }),
+ buildSlackTimestampField({
+ key: 'dueAt',
+ label: 'Due date',
+ value: record.dueAt,
+ }),
+ ...(includeDetails
+ ? [
+ buildSlackStringField({
+ key: 'assignee',
+ label: 'Assignee',
+ value: buildFullName(asRecord(record.assignee)?.name),
+ }),
+ buildSlackBodyPreviewField(record.bodyV2),
+ ...buildSlackTimestampDetailFields(record),
+ ]
+ : []),
+ ],
+ };
+};
+
+export const SLACK_RECORD_CONTENT_BUILDERS: Record<
+ SlackUnfurlObjectName,
+ (args: SlackUnfurlContentArgs) => SlackUnfurlContent
+> = {
+ person: buildPersonContent,
+ company: buildCompanyContent,
+ opportunity: buildOpportunityContent,
+ note: buildNoteContent,
+ task: buildTaskContent,
+};
diff --git a/packages/twenty-apps/public/slack/src/logic-functions/utils/build-slack-record-entities-for-message.ts b/packages/twenty-apps/public/slack/src/logic-functions/utils/build-slack-record-entities-for-message.ts
new file mode 100644
index 00000000000..3cb8014f335
--- /dev/null
+++ b/packages/twenty-apps/public/slack/src/logic-functions/utils/build-slack-record-entities-for-message.ts
@@ -0,0 +1,51 @@
+import { type EntityMetadata } from '@slack/web-api';
+import { CoreApiClient } from 'twenty-client-sdk/core';
+
+import { SLACK_UNFURL_MAX_ENTITIES } from 'src/logic-functions/constants/slack-unfurl-max-entities';
+import { extractHttpUrls } from 'src/logic-functions/utils/extract-http-urls';
+import { fetchSlackRecordEntities } from 'src/logic-functions/utils/fetch-slack-record-entities';
+import { fetchWorkspaceBaseUrls } from 'src/logic-functions/utils/fetch-workspace-base-urls';
+import { parseTwentyRecordLinks } from 'src/logic-functions/utils/parse-twenty-record-links';
+
+export const buildSlackRecordEntitiesForMessage = async (
+ messageText: string,
+): Promise<EntityMetadata[]> => {
+ try {
+ const urls = extractHttpUrls(messageText);
+
+ // every record link carries this segment, so checking it first keeps the
+ // workspace URL query off the post path for unrelated links
+ const recordUrls = urls.filter((url) => url.includes('/object/'));
+
+ if (recordUrls.length === 0) {
+ return [];
+ }
+
+ const workspaceBaseUrls = await fetchWorkspaceBaseUrls();
+
+ if (workspaceBaseUrls.length === 0) {
+ return [];
+ }
+
+ const recordLinks = parseTwentyRecordLinks({
+ workspaceBaseUrls,
+ urls: recordUrls,
+ }).slice(0, SLACK_UNFURL_MAX_ENTITIES);
+
+ if (recordLinks.length === 0) {
+ return [];
+ }
+
+ return await fetchSlackRecordEntities({
+ client: new CoreApiClient(),
+ recordLinks,
+ workspaceBaseUrls,
+ });
+ } catch (error) {
+ console.warn(
+ `[slack] building record previews for an outgoing message failed: ${error instanceof Error ? error.message : String(error)}`,
+ );
+
+ return [];
+ }
+};
diff --git a/packages/twenty-apps/public/slack/src/logic-functions/utils/build-slack-record-ref-field.ts b/packages/twenty-apps/public/slack/src/logic-functions/utils/build-slack-record-ref-field.ts
new file mode 100644
index 00000000000..5e5999dd860
--- /dev/null
+++ b/packages/twenty-apps/public/slack/src/logic-functions/utils/build-slack-record-ref-field.ts
@@ -0,0 +1,33 @@
+import { type EntityCustomField } from '@slack/web-api';
+import { isDefined } from 'twenty-sdk/utils';
+
+import { SLACK_ENTITY_FIELD_TYPE } from 'src/logic-functions/constants/slack-entity-field-type';
+import { type SlackUnfurlObjectName } from 'src/logic-functions/types/slack-unfurl-object-name.type';
+
+export const buildSlackRecordRefField = ({
+ key,
+ label,
+ objectNameSingular,
+ recordId,
+ title,
+ iconUrl,
+ workspaceBaseUrl,
+}: {
+ key: string;
+ label: string;
+ objectNameSingular: SlackUnfurlObjectName;
+ recordId: string;
+ title: string;
+ iconUrl?: string;
+ workspaceBaseUrl: string;
+}): EntityCustomField => ({
+ key,
+ label,
+ type: SLACK_ENTITY_FIELD_TYPE.ENTITY_REF,
+ entity_ref: {
+ entity_url: `${workspaceBaseUrl}/object/${objectNameSingular}/${recordId}`,
+ external_ref: { id: recordId, type: objectNameSingular },
+ title,
+ ...(isDefined(iconUrl) ? { icon: { alt_text: title, url: iconUrl } } : {}),
+ },
+});
diff --git a/packages/twenty-apps/public/slack/src/logic-functions/utils/build-slack-record-unfurl-entity.ts b/packages/twenty-apps/public/slack/src/logic-functions/utils/build-slack-record-unfurl-entity.ts
new file mode 100644
index 00000000000..0221a2fed19
--- /dev/null
+++ b/packages/twenty-apps/public/slack/src/logic-functions/utils/build-slack-record-unfurl-entity.ts
@@ -0,0 +1,70 @@
+import { type EntityMetadata } from '@slack/web-api';
+import { isNonEmptyString } from '@sniptt/guards';
+import { isDefined } from 'twenty-sdk/utils';
+
+import { type SlackUnfurlObjectName } from 'src/logic-functions/types/slack-unfurl-object-name.type';
+import { type SlackRecordLink } from 'src/logic-functions/types/slack-record-link.type';
+import { SLACK_RECORD_CONTENT_BUILDERS } from 'src/logic-functions/utils/build-slack-record-content';
+import { toEpochSeconds } from 'src/logic-functions/utils/to-epoch-seconds';
+
+const ITEM_ENTITY_TYPE = 'slack#/entities/item';
+
+const TWENTY_PRODUCT_ICON_URL =
+ 'https://raw.githubusercontent.com/twentyhq/twenty/main/packages/twenty-front/public/images/icons/ios/192.png';
+
+const DISPLAY_TYPE_BY_OBJECT: Record<SlackUnfurlObjectName, string> = {
+ person: 'Person',
+ company: 'Company',
+ opportunity: 'Opportunity',
+ note: 'Note',
+ task: 'Task',
+};
+
+export const buildSlackRecordUnfurlEntity = ({
+ recordLink,
+ record,
+ workspaceBaseUrls,
+ includeDetails = false,
+}: {
+ recordLink: SlackRecordLink;
+ record: Record<string, unknown>;
+ workspaceBaseUrls: string[];
+ includeDetails?: boolean;
+}): EntityMetadata | undefined => {
+ const { title, customFields, iconUrl } = SLACK_RECORD_CONTENT_BUILDERS[
+ recordLink.objectNameSingular
+ ]({ record, workspaceBaseUrls, includeDetails });
+
+ if (!isNonEmptyString(title)) {
+ return undefined;
+ }
+
+ const definedCustomFields = customFields.filter(isDefined);
+ const metadataLastModified = toEpochSeconds(record.updatedAt);
+
+ return {
+ entity_type: ITEM_ENTITY_TYPE,
+ entity_payload: {
+ attributes: {
+ title: { text: title },
+ display_type: DISPLAY_TYPE_BY_OBJECT[recordLink.objectNameSingular],
+ product_name: 'Twenty',
+ product_icon: isDefined(iconUrl)
+ ? { alt_text: title, url: iconUrl }
+ : { alt_text: 'Twenty', url: TWENTY_PRODUCT_ICON_URL },
+ ...(isDefined(metadataLastModified)
+ ? { metadata_last_modified: metadataLastModified }
+ : {}),
+ },
+ ...(definedCustomFields.length > 0
+ ? { custom_fields: definedCustomFields }
+ : {}),
+ },
+ external_ref: {
+ id: recordLink.recordId,
+ type: recordLink.objectNameSingular,
+ },
+ url: recordLink.canonicalUrl,
+ app_unfurl_url: recordLink.sharedUrl,
+ };
+};
diff --git a/packages/twenty-apps/public/slack/src/logic-functions/utils/build-slack-string-field.ts b/packages/twenty-apps/public/slack/src/logic-functions/utils/build-slack-string-field.ts
new file mode 100644
index 00000000000..9375be4e817
--- /dev/null
+++ b/packages/twenty-apps/public/slack/src/logic-functions/utils/build-slack-string-field.ts
@@ -0,0 +1,17 @@
+import { type EntityCustomField } from '@slack/web-api';
+import { isDefined } from 'twenty-sdk/utils';
+
+import { SLACK_ENTITY_FIELD_TYPE } from 'src/logic-functions/constants/slack-entity-field-type';
+
+export const buildSlackStringField = ({
+ key,
+ label,
+ value,
+ type = SLACK_ENTITY_FIELD_TYPE.STRING,
+}: {
+ key: string;
+ label: string;
+ value: string | undefined;
+ type?: string;
+}): EntityCustomField | undefined =>
+ isDefined(value) ? { key, label, type, value } : undefined;
diff --git a/packages/twenty-apps/public/slack/src/logic-functions/utils/build-slack-timestamp-detail-fields.ts b/packages/twenty-apps/public/slack/src/logic-functions/utils/build-slack-timestamp-detail-fields.ts
new file mode 100644
index 00000000000..3d6e080a359
--- /dev/null
+++ b/packages/twenty-apps/public/slack/src/logic-functions/utils/build-slack-timestamp-detail-fields.ts
@@ -0,0 +1,18 @@
+import { type EntityCustomField } from '@slack/web-api';
+
+import { buildSlackTimestampField } from 'src/logic-functions/utils/build-slack-timestamp-field';
+
+export const buildSlackTimestampDetailFields = (
+ record: Record<string, unknown>,
+): (EntityCustomField | undefined)[] => [
+ buildSlackTimestampField({
+ key: 'createdAt',
+ label: 'Created',
+ value: record.createdAt,
+ }),
+ buildSlackTimestampField({
+ key: 'updatedAt',
+ label: 'Updated',
+ value: record.updatedAt,
+ }),
+];
diff --git a/packages/twenty-apps/public/slack/src/logic-functions/utils/build-slack-timestamp-field.ts b/packages/twenty-apps/public/slack/src/logic-functions/utils/build-slack-timestamp-field.ts
new file mode 100644
index 00000000000..43e8c1f74b5
--- /dev/null
+++ b/packages/twenty-apps/public/slack/src/logic-functions/utils/build-slack-timestamp-field.ts
@@ -0,0 +1,26 @@
+import { type EntityCustomField } from '@slack/web-api';
+import { isDefined } from 'twenty-sdk/utils';
+
+import { SLACK_ENTITY_FIELD_TYPE } from 'src/logic-functions/constants/slack-entity-field-type';
+import { toEpochSeconds } from 'src/logic-functions/utils/to-epoch-seconds';
+
+export const buildSlackTimestampField = ({
+ key,
+ label,
+ value,
+}: {
+ key: string;
+ label: string;
+ value: unknown;
+}): EntityCustomField | undefined => {
+ const epochSeconds = toEpochSeconds(value);
+
+ return isDefined(epochSeconds)
+ ? {
+ key,
+ label,
+ type: SLACK_ENTITY_FIELD_TYPE.TIMESTAMP,
+ value: epochSeconds,
+ }
+ : undefined;
+};
diff --git a/packages/twenty-apps/public/slack/src/logic-functions/utils/extract-http-urls.ts b/packages/twenty-apps/public/slack/src/logic-functions/utils/extract-http-urls.ts
new file mode 100644
index 00000000000..a41e2064bfd
--- /dev/null
+++ b/packages/twenty-apps/public/slack/src/logic-functions/utils/extract-http-urls.ts
@@ -0,0 +1,10 @@
+export const extractHttpUrls = (text: string): string[] =>
+ [...text.matchAll(/https?:\/\/[^\s<>|()[\]"'`*]+/g)].map((match) => {
+ const url = match[0];
+
+ // ? and ! are only real URL characters inside a query or fragment, so
+ // they are trimmed as sentence punctuation when there is none
+ return /[?#]./.test(url)
+ ? url.replace(/[.,;:]+$/, '')
+ : url.replace(/[.,;:!?]+$/, '');
+ });
diff --git a/packages/twenty-apps/public/slack/src/logic-functions/utils/fetch-slack-record-entities.ts b/packages/twenty-apps/public/slack/src/logic-functions/utils/fetch-slack-record-entities.ts
new file mode 100644
index 00000000000..15ed0ea9b76
--- /dev/null
+++ b/packages/twenty-apps/public/slack/src/logic-functions/utils/fetch-slack-record-entities.ts
@@ -0,0 +1,43 @@
+import { type EntityMetadata } from '@slack/web-api';
+import { type CoreApiClient } from 'twenty-client-sdk/core';
+import { isDefined } from 'twenty-sdk/utils';
+
+import { findSlackUnfurlRecord } from 'src/logic-functions/data/find-slack-unfurl-record';
+import { type SlackRecordLink } from 'src/logic-functions/types/slack-record-link.type';
+import { buildSlackRecordUnfurlEntity } from 'src/logic-functions/utils/build-slack-record-unfurl-entity';
+
+export const fetchSlackRecordEntities = async ({
+ client,
+ recordLinks,
+ workspaceBaseUrls,
+}: {
+ client: CoreApiClient;
+ recordLinks: SlackRecordLink[];
+ workspaceBaseUrls: string[];
+}): Promise<EntityMetadata[]> => {
+ const entities = await Promise.all(
+ recordLinks.map(async (recordLink) => {
+ const record = await findSlackUnfurlRecord({
+ client,
+ objectNameSingular: recordLink.objectNameSingular,
+ recordId: recordLink.recordId,
+ }).catch((error) => {
+ console.warn(
+ `[slack] record fetch for preview failed (${recordLink.objectNameSingular} ${recordLink.recordId}): ${error instanceof Error ? error.message : String(error)}`,
+ );
+
+ return undefined;
+ });
+
+ return isDefined(record)
+ ? buildSlackRecordUnfurlEntity({
+ recordLink,
+ record,
+ workspaceBaseUrls,
+ })
+ : undefined;
+ }),
+ );
+
+ return entities.filter(isDefined);
+};
diff --git a/packages/twenty-apps/public/slack/src/logic-functions/utils/fetch-workspace-base-url.ts b/packages/twenty-apps/public/slack/src/logic-functions/utils/fetch-workspace-base-url.ts
deleted file mode 100644
index 91ddb7cd28e..00000000000
--- a/packages/twenty-apps/public/slack/src/logic-functions/utils/fetch-workspace-base-url.ts
+++ /dev/null
@@ -1,35 +0,0 @@
-import { isNonEmptyString } from '@sniptt/guards';
-import { MetadataApiClient } from 'twenty-client-sdk/metadata';
-
-const stripTrailingSlashes = (url: string): string => url.replace(/\/+$/, '');
-
-export const fetchWorkspaceBaseUrl = async (): Promise<string | undefined> => {
- try {
- const { currentWorkspace } = await new MetadataApiClient().query({
- currentWorkspace: {
- workspaceUrls: { customUrl: true, subdomainUrl: true },
- },
- });
-
- const customUrl = currentWorkspace?.workspaceUrls?.customUrl;
- const subdomainUrl = currentWorkspace?.workspaceUrls?.subdomainUrl;
-
- if (isNonEmptyString(customUrl)) {
- return stripTrailingSlashes(customUrl);
- }
-
- if (isNonEmptyString(subdomainUrl)) {
- return stripTrailingSlashes(subdomainUrl);
- }
-
- console.warn('[slack] workspace URL is missing, record links are disabled');
-
- return undefined;
- } catch (error) {
- console.warn(
- `[slack] failed to read the workspace URL, record links are disabled: ${error instanceof Error ? error.message : String(error)}`,
- );
-
- return undefined;
- }
-};
diff --git a/packages/twenty-apps/public/slack/src/logic-functions/utils/fetch-workspace-base-urls.ts b/packages/twenty-apps/public/slack/src/logic-functions/utils/fetch-workspace-base-urls.ts
new file mode 100644
index 00000000000..367ef787cee
--- /dev/null
+++ b/packages/twenty-apps/public/slack/src/logic-functions/utils/fetch-workspace-base-urls.ts
@@ -0,0 +1,37 @@
+import { isNonEmptyString } from '@sniptt/guards';
+import { MetadataApiClient } from 'twenty-client-sdk/metadata';
+
+const stripTrailingSlashes = (url: string): string => url.replace(/\/+$/, '');
+
+// a workspace on a custom domain still serves its subdomain host, and links get
+// copied from either, so both have to match; the first is the canonical one
+export const fetchWorkspaceBaseUrls = async (): Promise<string[]> => {
+ try {
+ const { currentWorkspace } = await new MetadataApiClient().query({
+ currentWorkspace: {
+ workspaceUrls: { customUrl: true, subdomainUrl: true },
+ },
+ });
+
+ const baseUrls = [
+ currentWorkspace?.workspaceUrls?.customUrl,
+ currentWorkspace?.workspaceUrls?.subdomainUrl,
+ ]
+ .filter(isNonEmptyString)
+ .map(stripTrailingSlashes);
+
+ if (baseUrls.length === 0) {
+ console.warn(
+ '[slack] workspace URL is missing, record links are disabled',
+ );
+ }
+
+ return baseUrls;
+ } catch (error) {
+ console.warn(
+ `[slack] failed to read the workspace URL, record links are disabled: ${error instanceof Error ? error.message : String(error)}`,
+ );
+
+ return [];
+ }
+};
diff --git a/packages/twenty-apps/public/slack/src/logic-functions/utils/format-amount.ts b/packages/twenty-apps/public/slack/src/logic-functions/utils/format-amount.ts
new file mode 100644
index 00000000000..84bd0b486d2
--- /dev/null
+++ b/packages/twenty-apps/public/slack/src/logic-functions/utils/format-amount.ts
@@ -0,0 +1,29 @@
+import { isNumber } from '@sniptt/guards';
+import { isDefined } from 'twenty-sdk/utils';
+
+import { readOptionalString } from 'src/logic-functions/utils/read-optional-string.util';
+
+export const formatAmount = (
+ amount: Record<string, unknown> | undefined,
+): string | undefined => {
+ const amountMicros = amount?.amountMicros;
+
+ if (!isNumber(amountMicros) || !Number.isFinite(amountMicros)) {
+ return undefined;
+ }
+
+ const value = amountMicros / 1_000_000;
+ const currencyCode = readOptionalString(amount?.currencyCode);
+
+ if (isDefined(currencyCode)) {
+ try {
+ return new Intl.NumberFormat('en-US', {
+ style: 'currency',
+ currency: currencyCode,
+ }).format(value);
+ } catch {
+ }
+ }
+
+ return new Intl.NumberFormat('en-US').format(value);
+};
diff --git a/packages/twenty-apps/public/slack/src/logic-functions/utils/get-company-logo-url.ts b/packages/twenty-apps/public/slack/src/logic-functions/utils/get-company-logo-url.ts
new file mode 100644
index 00000000000..b2bae4e2428
--- /dev/null
+++ b/packages/twenty-apps/public/slack/src/logic-functions/utils/get-company-logo-url.ts
@@ -0,0 +1,25 @@
+import { isNonEmptyString } from '@sniptt/guards';
+
+export const getCompanyLogoUrl = (
+ domainUrl: string | undefined,
+): string | undefined => {
+ const trimmed = (domainUrl ?? '').trim();
+
+ if (!isNonEmptyString(trimmed)) {
+ return undefined;
+ }
+
+ const normalized = /^https?:\/\//i.test(trimmed)
+ ? trimmed
+ : `https://${trimmed}`;
+
+ try {
+ const hostname = new URL(normalized).hostname.replace(/^www\./, '');
+
+ return isNonEmptyString(hostname)
+ ? `https://twenty-icons.com/${hostname}`
+ : undefined;
+ } catch {
+ return undefined;
+ }
+};
diff --git a/packages/twenty-apps/public/slack/src/logic-functions/utils/get-public-avatar-url.ts b/packages/twenty-apps/public/slack/src/logic-functions/utils/get-public-avatar-url.ts
new file mode 100644
index 00000000000..fd58a87f646
--- /dev/null
+++ b/packages/twenty-apps/public/slack/src/logic-functions/utils/get-public-avatar-url.ts
@@ -0,0 +1,21 @@
+import { isDefined } from 'twenty-sdk/utils';
+
+import { readOptionalString } from 'src/logic-functions/utils/read-optional-string.util';
+
+export const getPublicAvatarUrl = ({
+ avatarUrl,
+ workspaceBaseUrls,
+}: {
+ avatarUrl: unknown;
+ workspaceBaseUrls: string[];
+}): string | undefined => {
+ const url = readOptionalString(avatarUrl);
+
+ if (!isDefined(url) || !/^https?:\/\//i.test(url)) {
+ return undefined;
+ }
+
+ return workspaceBaseUrls.some((baseUrl) => url.startsWith(baseUrl))
+ ? undefined
+ : url;
+};
diff --git a/packages/twenty-apps/public/slack/src/logic-functions/utils/humanize-select-value.ts b/packages/twenty-apps/public/slack/src/logic-functions/utils/humanize-select-value.ts
new file mode 100644
index 00000000000..7f49095a691
--- /dev/null
+++ b/packages/twenty-apps/public/slack/src/logic-functions/utils/humanize-select-value.ts
@@ -0,0 +1,5 @@
+export const humanizeSelectValue = (value: string): string => {
+ const words = value.replace(/_/g, ' ').toLowerCase();
+
+ return words.charAt(0).toUpperCase() + words.slice(1);
+};
diff --git a/packages/twenty-apps/public/slack/src/logic-functions/utils/is-slack-metadata-error.ts b/packages/twenty-apps/public/slack/src/logic-functions/utils/is-slack-metadata-error.ts
new file mode 100644
index 00000000000..bbca9e13db5
--- /dev/null
+++ b/packages/twenty-apps/public/slack/src/logic-functions/utils/is-slack-metadata-error.ts
@@ -0,0 +1,6 @@
+import { isNonEmptyString } from '@sniptt/guards';
+
+// covers invalid_metadata_format, invalid_metadata_schema, metadata_too_large
+// and error_processing_metadata
+export const isSlackMetadataError = (errorCode: string | undefined): boolean =>
+ isNonEmptyString(errorCode) && errorCode.includes('metadata');
diff --git a/packages/twenty-apps/public/slack/src/logic-functions/utils/parse-slack-entity-details-event.ts b/packages/twenty-apps/public/slack/src/logic-functions/utils/parse-slack-entity-details-event.ts
new file mode 100644
index 00000000000..44e715a4b65
--- /dev/null
+++ b/packages/twenty-apps/public/slack/src/logic-functions/utils/parse-slack-entity-details-event.ts
@@ -0,0 +1,68 @@
+import { isNonEmptyString } from '@sniptt/guards';
+import { isDefined } from 'twenty-sdk/utils';
+
+import { type SlackEventsRequestBody } from 'src/logic-functions/types/slack-events-request-body.type';
+
+type ParsedSlackEntityDetailsEvent =
+ | {
+ detailsRequest: {
+ triggerId: string;
+ slackUserId: string;
+ entityUrl: string | undefined;
+ externalRef: { id: string; type: string | undefined } | undefined;
+ };
+ }
+ | { detailsRequest: null; skipReason: string };
+
+export const parseSlackEntityDetailsEvent = (
+ body: SlackEventsRequestBody,
+): ParsedSlackEntityDetailsEvent => {
+ if (body.type !== 'event_callback') {
+ return {
+ detailsRequest: null,
+ skipReason: `Unhandled body type: ${body.type}`,
+ };
+ }
+
+ const event = body.event;
+
+ if (!isDefined(event)) {
+ return { detailsRequest: null, skipReason: 'Missing event payload' };
+ }
+
+ if (event.type !== 'entity_details_requested') {
+ return {
+ detailsRequest: null,
+ skipReason: `Unhandled event type: ${event.type}`,
+ };
+ }
+
+ if (!isNonEmptyString(event.trigger_id)) {
+ return { detailsRequest: null, skipReason: 'Event has no trigger_id' };
+ }
+
+ if (!isNonEmptyString(event.user)) {
+ return { detailsRequest: null, skipReason: 'Event has no user' };
+ }
+
+ const entityUrl = [event.link?.url, event.entity_url].find(isNonEmptyString);
+
+ const externalRefId = event.external_ref?.id;
+ const externalRef = isNonEmptyString(externalRefId)
+ ? {
+ id: externalRefId,
+ type: isNonEmptyString(event.external_ref?.type)
+ ? event.external_ref.type
+ : undefined,
+ }
+ : undefined;
+
+ return {
+ detailsRequest: {
+ triggerId: event.trigger_id,
+ slackUserId: event.user,
+ entityUrl,
+ externalRef,
+ },
+ };
+};
diff --git a/packages/twenty-apps/public/slack/src/logic-functions/utils/parse-slack-link-shared-event.ts b/packages/twenty-apps/public/slack/src/logic-functions/utils/parse-slack-link-shared-event.ts
new file mode 100644
index 00000000000..14d8922bb69
--- /dev/null
+++ b/packages/twenty-apps/public/slack/src/logic-functions/utils/parse-slack-link-shared-event.ts
@@ -0,0 +1,95 @@
+import { isNonEmptyString } from '@sniptt/guards';
+import { isDefined } from 'twenty-sdk/utils';
+
+import { type SlackEventsRequestBody } from 'src/logic-functions/types/slack-events-request-body.type';
+import { asRecord } from 'src/logic-functions/utils/as-record.util';
+
+type SlackInboundEvent = NonNullable<SlackEventsRequestBody['event']>;
+
+type SlackUnfurlTarget =
+ | {
+ source: 'conversations_history';
+ slackChannelId: string;
+ messageTimestamp: string;
+ }
+ | { source: 'composer'; unfurlId: string };
+
+type ParsedSlackLinkSharedEvent =
+ | {
+ linkShared: {
+ unfurlTarget: SlackUnfurlTarget;
+ slackUserId: string;
+ urls: string[];
+ };
+ }
+ | { linkShared: null; skipReason: string };
+
+// Slack fires link_shared twice for the same link, naming which one it is in
+// `source`: once while it sits in the composer, where there is no channel yet
+// and only an unfurl id to answer against, and again once the message is posted
+const resolveSlackUnfurlTarget = (
+ event: SlackInboundEvent,
+): SlackUnfurlTarget | undefined => {
+ if (event.source === 'composer' && isNonEmptyString(event.unfurl_id)) {
+ return { source: 'composer', unfurlId: event.unfurl_id };
+ }
+
+ if (isNonEmptyString(event.channel) && isNonEmptyString(event.message_ts)) {
+ return {
+ source: 'conversations_history',
+ slackChannelId: event.channel,
+ messageTimestamp: event.message_ts,
+ };
+ }
+
+ return undefined;
+};
+
+export const parseSlackLinkSharedEvent = (
+ body: SlackEventsRequestBody,
+): ParsedSlackLinkSharedEvent => {
+ if (body.type !== 'event_callback') {
+ return {
+ linkShared: null,
+ skipReason: `Unhandled body type: ${body.type}`,
+ };
+ }
+
+ const event = body.event;
+
+ if (!isDefined(event)) {
+ return { linkShared: null, skipReason: 'Missing event payload' };
+ }
+
+ if (event.type !== 'link_shared') {
+ return {
+ linkShared: null,
+ skipReason: `Unhandled event type: ${event.type}`,
+ };
+ }
+
+ const unfurlTarget = resolveSlackUnfurlTarget(event);
+
+ if (!isDefined(unfurlTarget) || !isNonEmptyString(event.user)) {
+ return {
+ linkShared: null,
+ skipReason: 'Event is missing required fields',
+ };
+ }
+
+ const urls = (Array.isArray(event.links) ? event.links : [])
+ .map((link) => asRecord(link)?.url)
+ .filter(isNonEmptyString);
+
+ if (urls.length === 0) {
+ return { linkShared: null, skipReason: 'Event carries no link URLs' };
+ }
+
+ return {
+ linkShared: {
+ unfurlTarget,
+ slackUserId: event.user,
+ urls,
+ },
+ };
+};
diff --git a/packages/twenty-apps/public/slack/src/logic-functions/utils/parse-twenty-record-links.ts b/packages/twenty-apps/public/slack/src/logic-functions/utils/parse-twenty-record-links.ts
new file mode 100644
index 00000000000..c2e1dd26e3d
--- /dev/null
+++ b/packages/twenty-apps/public/slack/src/logic-functions/utils/parse-twenty-record-links.ts
@@ -0,0 +1,83 @@
+import { isDefined } from 'twenty-sdk/utils';
+
+import { SLACK_UNFURL_OBJECT_NAMES } from 'src/logic-functions/constants/slack-unfurl-object-names';
+import { type SlackRecordLink } from 'src/logic-functions/types/slack-record-link.type';
+
+const UUID_PATTERN =
+ /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+
+const isSupportedObjectName = (
+ value: string,
+): value is SlackRecordLink['objectNameSingular'] =>
+ SLACK_UNFURL_OBJECT_NAMES.some((objectName) => objectName === value);
+
+const parseRecordLink = ({
+ workspaceBaseUrls,
+ url,
+}: {
+ workspaceBaseUrls: string[];
+ url: string;
+}): SlackRecordLink | undefined => {
+ const normalizedUrl = url.replace(/&amp;/g, '&');
+
+ const matchedBaseUrl = workspaceBaseUrls.find((baseUrl) =>
+ normalizedUrl.startsWith(`${baseUrl}/`),
+ );
+
+ if (!isDefined(matchedBaseUrl)) {
+ return undefined;
+ }
+
+ const path = normalizedUrl.slice(matchedBaseUrl.length);
+ const match = path.match(/^\/object\/([^/]+)\/([^/?#]+)\/?(?:[?#]|$)/);
+
+ if (!match) {
+ return undefined;
+ }
+
+ const [, objectNameSingular, recordId] = match;
+
+ if (
+ !isSupportedObjectName(objectNameSingular) ||
+ !UUID_PATTERN.test(recordId)
+ ) {
+ return undefined;
+ }
+
+ return {
+ sharedUrl: url,
+ canonicalUrl: `${workspaceBaseUrls[0]}/object/${objectNameSingular}/${recordId}`,
+ objectNameSingular,
+ recordId,
+ };
+};
+
+export const parseTwentyRecordLinks = ({
+ workspaceBaseUrls,
+ urls,
+}: {
+ workspaceBaseUrls: string[];
+ urls: string[];
+}): SlackRecordLink[] => {
+ const seenRecords = new Set<string>();
+ const recordLinks: SlackRecordLink[] = [];
+
+ for (const url of urls) {
+ const recordLink = parseRecordLink({ workspaceBaseUrls, url });
+
+ if (!isDefined(recordLink)) {
+ continue;
+ }
+
+ const recordKey = `${recordLink.objectNameSingular}:${recordLink.recordId}`;
+
+ if (seenRecords.has(recordKey)) {
+ continue;
+ }
+
+ seenRecords.add(recordKey);
+ recordLinks.push(recordLink);
+ }
+
+ return recordLinks;
+};
diff --git a/packages/twenty-apps/public/slack/src/logic-functions/utils/post-slack-message.ts b/packages/twenty-apps/public/slack/src/logic-functions/utils/post-slack-message.ts
index a2ad0ceb515..f70d248bc59 100644
--- a/packages/twenty-apps/public/slack/src/logic-functions/utils/post-slack-message.ts
+++ b/packages/twenty-apps/public/slack/src/logic-functions/utils/post-slack-message.ts
@@ -1,8 +1,11 @@
-import { type WebClient } from '@slack/web-api';
+import { type EntityMetadata, type WebClient } from '@slack/web-api';
import { isDefined } from 'twenty-sdk/utils';
import { type SlackPostMessageInput } from 'src/logic-functions/types/slack-post-message-input.type';
import { type SlackToolResult } from 'src/logic-functions/types/slack-tool-result.type';
+import { buildSlackRecordEntitiesForMessage } from 'src/logic-functions/utils/build-slack-record-entities-for-message';
+import { getSlackApiErrorCode } from 'src/logic-functions/utils/get-slack-api-error-code';
+import { isSlackMetadataError } from 'src/logic-functions/utils/is-slack-metadata-error';
import { normalizeSlackParentMessageTimestamp } from 'src/logic-functions/utils/normalize-slack-parent-message-timestamp';
import { sendSlackMessageWithBodyFallbacks } from 'src/logic-functions/utils/send-slack-message-with-body-fallbacks';
@@ -14,34 +17,61 @@ export const postSlackMessage = async (
parameters.parentMessageTimestamp,
);
- return await sendSlackMessageWithBodyFallbacks({
- messageText: parameters.messageText,
- messageBody: {
- messageFormat: parameters.messageFormat,
- messageBlocks: parameters.messageBlocks,
- },
- failureMessage: 'Failed to post Slack message',
- sendMessage: async (bodyFields) => {
- const data = await client.chat.postMessage({
- channel: parameters.slackChannelId,
- thread_ts: parentTimestamp,
- ...(isDefined(parameters.unfurlLinks)
- ? { unfurl_links: parameters.unfurlLinks }
- : {}),
- ...(isDefined(parameters.unfurlMedia)
- ? { unfurl_media: parameters.unfurlMedia }
- : {}),
- ...bodyFields,
- });
-
- return {
- success: true,
- message: data.ts
- ? `Message posted to Slack (ts=${data.ts}).`
- : 'Message posted to Slack.',
- slackTs: data.ts,
- channel: data.channel,
- };
- },
- });
+ const recordEntities = await buildSlackRecordEntitiesForMessage(
+ parameters.messageText,
+ );
+
+ let lastErrorCode: string | undefined;
+
+ const post = async (entities: EntityMetadata[]): Promise<SlackToolResult> =>
+ await sendSlackMessageWithBodyFallbacks({
+ messageText: parameters.messageText,
+ messageBody: {
+ messageFormat: parameters.messageFormat,
+ messageBlocks: parameters.messageBlocks,
+ },
+ failureMessage: 'Failed to post Slack message',
+ sendMessage: async (bodyFields) => {
+ try {
+ const data = await client.chat.postMessage({
+ channel: parameters.slackChannelId,
+ thread_ts: parentTimestamp,
+ ...(isDefined(parameters.unfurlLinks)
+ ? { unfurl_links: parameters.unfurlLinks }
+ : {}),
+ ...(isDefined(parameters.unfurlMedia)
+ ? { unfurl_media: parameters.unfurlMedia }
+ : {}),
+ ...(entities.length > 0 ? { metadata: { entities } } : {}),
+ ...bodyFields,
+ });
+
+ return {
+ success: true,
+ message: data.ts
+ ? `Message posted to Slack (ts=${data.ts}).`
+ : 'Message posted to Slack.',
+ slackTs: data.ts,
+ channel: data.channel,
+ };
+ } catch (error) {
+ lastErrorCode = getSlackApiErrorCode(error);
+
+ throw error;
+ }
+ },
+ });
+
+ const result = await post(recordEntities);
+
+ if (
+ result.success ||
+ recordEntities.length === 0 ||
+ !isSlackMetadataError(lastErrorCode)
+ ) {
+ return result;
+ }
+
+ // a preview Slack refuses must cost the preview, never the message
+ return await post([]);
};
diff --git a/packages/twenty-apps/public/slack/src/logic-functions/utils/present-slack-record-details.ts b/packages/twenty-apps/public/slack/src/logic-functions/utils/present-slack-record-details.ts
new file mode 100644
index 00000000000..dd9e31c7601
--- /dev/null
+++ b/packages/twenty-apps/public/slack/src/logic-functions/utils/present-slack-record-details.ts
@@ -0,0 +1,185 @@
+import { type WebClient } from '@slack/web-api';
+import { isNonEmptyString } from '@sniptt/guards';
+import { CoreApiClient } from 'twenty-client-sdk/core';
+import { isDefined } from 'twenty-sdk/utils';
+
+import { findSlackUnfurlRecord } from 'src/logic-functions/data/find-slack-unfurl-record';
+import { type SlackEventsRequestBody } from 'src/logic-functions/types/slack-events-request-body.type';
+import { type SlackRecordLink } from 'src/logic-functions/types/slack-record-link.type';
+import { buildSlackRecordUnfurlEntity } from 'src/logic-functions/utils/build-slack-record-unfurl-entity';
+import { fetchSlackUserIdentity } from 'src/logic-functions/utils/fetch-slack-user-identity';
+import { fetchWorkspaceBaseUrls } from 'src/logic-functions/utils/fetch-workspace-base-urls';
+import { getSlackClient } from 'src/logic-functions/utils/get-slack-client';
+import { parseSlackEntityDetailsEvent } from 'src/logic-functions/utils/parse-slack-entity-details-event';
+import { parseTwentyRecordLinks } from 'src/logic-functions/utils/parse-twenty-record-links';
+import { resolveSlackRunAsWorkspaceMemberId } from 'src/logic-functions/utils/resolve-slack-run-as-workspace-member-id';
+
+type SlackRecordDetailsResult = {
+ ok: boolean;
+ skipped?: string;
+ error?: string;
+ presented?: boolean;
+};
+
+const presentDetailsError = async ({
+ slackClient,
+ triggerId,
+ message,
+}: {
+ slackClient: WebClient;
+ triggerId: string;
+ message: string;
+}): Promise<void> => {
+ try {
+ await slackClient.entity.presentDetails({
+ trigger_id: triggerId,
+ error: { status: 'custom', custom_message: message },
+ });
+ } catch (error) {
+ console.warn(
+ `[slack] entity.presentDetails error response failed: ${error instanceof Error ? error.message : String(error)}`,
+ );
+ }
+};
+
+const resolveRecordLink = ({
+ workspaceBaseUrls,
+ entityUrl,
+ externalRef,
+}: {
+ workspaceBaseUrls: string[];
+ entityUrl: string | undefined;
+ externalRef: { id: string; type: string | undefined } | undefined;
+}): SlackRecordLink | undefined => {
+ const candidateUrls = [
+ entityUrl,
+ isDefined(externalRef?.type)
+ ? `${workspaceBaseUrls[0]}/object/${externalRef.type}/${externalRef.id}`
+ : undefined,
+ ].filter(isDefined);
+
+ return parseTwentyRecordLinks({ workspaceBaseUrls, urls: candidateUrls })[0];
+};
+
+export const presentSlackRecordDetails = async (
+ body: SlackEventsRequestBody,
+): Promise<SlackRecordDetailsResult> => {
+ const parsed = parseSlackEntityDetailsEvent(body);
+
+ if (parsed.detailsRequest === null) {
+ return { ok: true, skipped: parsed.skipReason };
+ }
+
+ const { triggerId, slackUserId, entityUrl, externalRef } =
+ parsed.detailsRequest;
+
+ const slackClientResult = await getSlackClient();
+
+ if (!slackClientResult.success) {
+ return { ok: true, skipped: slackClientResult.error };
+ }
+
+ const slackClient = slackClientResult.client;
+ const client = new CoreApiClient();
+
+ const identity = await fetchSlackUserIdentity({
+ client: slackClient,
+ slackUserId,
+ });
+
+ const workspaceMemberId = await resolveSlackRunAsWorkspaceMemberId({
+ client,
+ slackClient,
+ identity,
+ });
+
+ if (!isNonEmptyString(workspaceMemberId)) {
+ await presentDetailsError({
+ slackClient,
+ triggerId,
+ message: 'Record details are only available to Twenty workspace members.',
+ });
+
+ return { ok: true, skipped: 'Viewer does not map to a workspace member' };
+ }
+
+ const workspaceBaseUrls = await fetchWorkspaceBaseUrls();
+
+ if (workspaceBaseUrls.length === 0) {
+ await presentDetailsError({
+ slackClient,
+ triggerId,
+ message: 'The Twenty workspace URL is not configured.',
+ });
+
+ return { ok: true, skipped: 'Workspace URL is unavailable' };
+ }
+
+ const recordLink = resolveRecordLink({
+ workspaceBaseUrls,
+ entityUrl,
+ externalRef,
+ });
+
+ if (!isDefined(recordLink)) {
+ console.warn(
+ `[slack] entity_details_requested carries no resolvable record: ${JSON.stringify(body.event)}`,
+ );
+
+ await presentDetailsError({
+ slackClient,
+ triggerId,
+ message: 'This preview does not point to a Twenty record.',
+ });
+
+ return { ok: true, skipped: 'No resolvable record in the event' };
+ }
+
+ const record = await findSlackUnfurlRecord({
+ client,
+ objectNameSingular: recordLink.objectNameSingular,
+ recordId: recordLink.recordId,
+ }).catch((error) => {
+ console.warn(
+ `[slack] record fetch for the flexpane failed (${recordLink.objectNameSingular} ${recordLink.recordId}): ${error instanceof Error ? error.message : String(error)}`,
+ );
+
+ return undefined;
+ });
+
+ const entity = isDefined(record)
+ ? buildSlackRecordUnfurlEntity({
+ recordLink,
+ record,
+ workspaceBaseUrls,
+ includeDetails: true,
+ })
+ : undefined;
+
+ if (!isDefined(entity)) {
+ await presentDetailsError({
+ slackClient,
+ triggerId,
+ message: isDefined(record)
+ ? 'This record has no name to show.'
+ : 'This record could not be found in Twenty.',
+ });
+
+ return { ok: true, skipped: 'Record is missing or unreadable' };
+ }
+
+ try {
+ await slackClient.entity.presentDetails({
+ trigger_id: triggerId,
+ metadata: entity,
+ });
+ } catch (error) {
+ console.warn(
+ `[slack] entity.presentDetails failed: ${error instanceof Error ? error.message : String(error)}`,
+ );
+
+ return { ok: false, error: 'entity.presentDetails failed' };
+ }
+
+ return { ok: true, presented: true };
+};
diff --git a/packages/twenty-apps/public/slack/src/logic-functions/utils/to-absolute-http-url.ts b/packages/twenty-apps/public/slack/src/logic-functions/utils/to-absolute-http-url.ts
new file mode 100644
index 00000000000..238f59d8545
--- /dev/null
+++ b/packages/twenty-apps/public/slack/src/logic-functions/utils/to-absolute-http-url.ts
@@ -0,0 +1,23 @@
+import { isDefined } from 'twenty-sdk/utils';
+
+export const toAbsoluteHttpUrl = (
+ value: string | undefined,
+): string | undefined => {
+ if (!isDefined(value)) {
+ return undefined;
+ }
+
+ // a colon followed by digits is a port, not a scheme (acme.dev:8080)
+ const hasScheme = /^[a-z][a-z0-9+.-]*:(?!\d)/i.test(value);
+ const candidate = hasScheme ? value : `https://${value}`;
+
+ try {
+ const url = new URL(candidate);
+
+ return url.protocol === 'http:' || url.protocol === 'https:'
+ ? url.toString()
+ : undefined;
+ } catch {
+ return undefined;
+ }
+};
diff --git a/packages/twenty-apps/public/slack/src/logic-functions/utils/to-epoch-seconds.ts b/packages/twenty-apps/public/slack/src/logic-functions/utils/to-epoch-seconds.ts
new file mode 100644
index 00000000000..8d03d63022c
--- /dev/null
+++ b/packages/twenty-apps/public/slack/src/logic-functions/utils/to-epoch-seconds.ts
@@ -0,0 +1,17 @@
+import { isDefined } from 'twenty-sdk/utils';
+
+import { readOptionalString } from 'src/logic-functions/utils/read-optional-string.util';
+
+export const toEpochSeconds = (value: unknown): number | undefined => {
+ const text = readOptionalString(value);
+
+ if (!isDefined(text)) {
+ return undefined;
+ }
+
+ const milliseconds = Date.parse(text);
+
+ return Number.isNaN(milliseconds)
+ ? undefined
+ : Math.floor(milliseconds / 1000);
+};
diff --git a/packages/twenty-apps/public/slack/src/logic-functions/utils/unfurl-slack-record-links.ts b/packages/twenty-apps/public/slack/src/logic-functions/utils/unfurl-slack-record-links.ts
new file mode 100644
index 00000000000..dc33d2b2ad5
--- /dev/null
+++ b/packages/twenty-apps/public/slack/src/logic-functions/utils/unfurl-slack-record-links.ts
@@ -0,0 +1,112 @@
+import { isNonEmptyString } from '@sniptt/guards';
+import { CoreApiClient } from 'twenty-client-sdk/core';
+
+import { SLACK_UNFURL_MAX_ENTITIES } from 'src/logic-functions/constants/slack-unfurl-max-entities';
+import { type SlackEventsRequestBody } from 'src/logic-functions/types/slack-events-request-body.type';
+import { fetchSlackRecordEntities } from 'src/logic-functions/utils/fetch-slack-record-entities';
+import { fetchSlackUserIdentity } from 'src/logic-functions/utils/fetch-slack-user-identity';
+import { fetchWorkspaceBaseUrls } from 'src/logic-functions/utils/fetch-workspace-base-urls';
+import { getSlackClient } from 'src/logic-functions/utils/get-slack-client';
+import { parseSlackLinkSharedEvent } from 'src/logic-functions/utils/parse-slack-link-shared-event';
+import { parseTwentyRecordLinks } from 'src/logic-functions/utils/parse-twenty-record-links';
+import { resolveSlackRunAsWorkspaceMemberId } from 'src/logic-functions/utils/resolve-slack-run-as-workspace-member-id';
+
+type SlackRecordUnfurlResult = {
+ ok: boolean;
+ skipped?: string;
+ error?: string;
+ unfurledCount?: number;
+};
+
+export const unfurlSlackRecordLinks = async (
+ body: SlackEventsRequestBody,
+): Promise<SlackRecordUnfurlResult> => {
+ const parsed = parseSlackLinkSharedEvent(body);
+
+ if (parsed.linkShared === null) {
+ return { ok: true, skipped: parsed.skipReason };
+ }
+
+ const { unfurlTarget, slackUserId, urls } = parsed.linkShared;
+
+ const workspaceBaseUrls = await fetchWorkspaceBaseUrls();
+
+ if (workspaceBaseUrls.length === 0) {
+ return { ok: true, skipped: 'Workspace URL is unavailable' };
+ }
+
+ const recordLinks = parseTwentyRecordLinks({ workspaceBaseUrls, urls }).slice(
+ 0,
+ SLACK_UNFURL_MAX_ENTITIES,
+ );
+
+ if (recordLinks.length === 0) {
+ return { ok: true, skipped: 'No Twenty record links in the message' };
+ }
+
+ const slackClientResult = await getSlackClient();
+
+ if (!slackClientResult.success) {
+ return { ok: true, skipped: slackClientResult.error };
+ }
+
+ const slackClient = slackClientResult.client;
+ const client = new CoreApiClient();
+
+ const identity = await fetchSlackUserIdentity({
+ client: slackClient,
+ slackUserId,
+ });
+
+ const workspaceMemberId = await resolveSlackRunAsWorkspaceMemberId({
+ client,
+ slackClient,
+ identity,
+ });
+
+ if (!isNonEmptyString(workspaceMemberId)) {
+ return {
+ ok: true,
+ skipped: 'Poster does not map to a workspace member',
+ };
+ }
+
+ const entities = await fetchSlackRecordEntities({
+ client,
+ recordLinks,
+ workspaceBaseUrls,
+ });
+
+ if (entities.length === 0) {
+ return { ok: true, skipped: 'No readable records to unfurl' };
+ }
+
+ try {
+ await slackClient.chat.unfurl(
+ unfurlTarget.source === 'composer'
+ ? {
+ source: unfurlTarget.source,
+ unfurl_id: unfurlTarget.unfurlId,
+ metadata: { entities },
+ }
+ : {
+ channel: unfurlTarget.slackChannelId,
+ ts: unfurlTarget.messageTimestamp,
+ metadata: { entities },
+ },
+ );
+ } catch (error) {
+ const targetLabel =
+ unfurlTarget.source === 'composer'
+ ? 'the message composer'
+ : `channel ${unfurlTarget.slackChannelId}`;
+
+ console.warn(
+ `[slack] chat.unfurl failed in ${targetLabel}: ${error instanceof Error ? error.message : String(error)}`,
+ );
+
+ return { ok: false, error: 'chat.unfurl failed' };
+ }
+
+ return { ok: true, unfurledCount: entities.length };
+};
diff --git a/packages/twenty-apps/public/slack/src/roles/default-function.role.ts b/packages/twenty-apps/public/slack/src/roles/default-function.role.ts
index 529f988538b..b51cdca5ba9 100644
--- a/packages/twenty-apps/public/slack/src/roles/default-function.role.ts
+++ b/packages/twenty-apps/public/slack/src/roles/default-function.role.ts
@@ -14,7 +14,7 @@ export default defineApplicationRole({
universalIdentifier: DEFAULT_ROLE_UNIVERSAL_IDENTIFIER,
label: 'Twenty Slack tools role',
description:
- 'Tools only forward requests to Slack using the configured connected account. Tracks assistant requests, links Slack accounts to workspace members (which needs read access on workspace members for the email match), and runs the assistant agent; wider CRM access is granted separately through the role assigned to the agent.',
+ 'Tools only forward requests to Slack using the configured connected account. Tracks assistant requests, links Slack accounts to workspace members (which needs read access on workspace members for the email match), reads CRM records to render record link previews in Slack, and runs the assistant agent; write access to the CRM is granted separately through the role assigned to the agent.',
canReadAllObjectRecords: false,
canUpdateAllObjectRecords: false,
canSoftDeleteAllObjectRecords: false,
@@ -48,6 +48,21 @@ export default defineApplicationRole({
canSoftDeleteObjectRecords: false,
canDestroyObjectRecords: false,
},
+ ...(
+ [
+ STANDARD_OBJECT_UNIVERSAL_IDENTIFIERS.person.universalIdentifier,
+ STANDARD_OBJECT_UNIVERSAL_IDENTIFIERS.company.universalIdentifier,
+ STANDARD_OBJECT_UNIVERSAL_IDENTIFIERS.opportunity.universalIdentifier,
+ STANDARD_OBJECT_UNIVERSAL_IDENTIFIERS.note.universalIdentifier,
+ STANDARD_OBJECT_UNIVERSAL_IDENTIFIERS.task.universalIdentifier,
+ ] as const
+ ).map((objectUniversalIdentifier) => ({
+ objectUniversalIdentifier,
+ canReadObjectRecords: true,
+ canUpdateObjectRecords: false,
+ canSoftDeleteObjectRecords: false,
+ canDestroyObjectRecords: false,
+ })),
],
fieldPermissions: [],
permissionFlagUniversalIdentifiers: [SystemPermissionFlag.AI],