copy: reframe messaging channel descriptions from process to value

Replace technical setup instructions (BotFather, QR code) with
outcome-first descriptions that communicate why to connect, not how.

Author: marian2js

apps/desktop/src/features/connections/components/MessagingConnectionsPanel.tsx

@@ -14,6 +14,7 @@ import { Button } from "@/components/ui/button";
 import { Tooltip, TooltipContent, TooltipTrigger } from "@/components/ui/tooltip";
 import { cn } from "@/lib/utils";
 import type { SidecarClient } from "@/lib/sidecar/client";
+import { MESSAGING_CHANNEL_DESCRIPTIONS } from "./messaging-channel-descriptions";
 import { TelegramSetupFlow } from "./TelegramSetupFlow";
 import { WhatsAppSetupFlow } from "./WhatsAppSetupFlow";
 
@@ -213,10 +214,7 @@ export function MessagingConnectionsPanel({
             {(["telegram", "whatsapp"] as const).map((type) => {
               const meta = TYPE_META[type]!;
               const Icon = meta.icon;
-              const descriptions: Record<string, string> = {
-                telegram: "Create a bot with BotFather and connect it to your CMO.",
-                whatsapp: "Link your WhatsApp via QR code to message your CMO.",
-              };
+              const descriptions = MESSAGING_CHANNEL_DESCRIPTIONS;
               return (
                 <button
                   key={type}

apps/desktop/src/features/connections/components/messaging-channel-descriptions.ts

@@ -0,0 +1,7 @@
+/** Value-first descriptions for messaging channel cards (shown in the empty/connect state). */
+export const MESSAGING_CHANNEL_DESCRIPTIONS: Record<string, string> = {
+  telegram:
+    "Get marketing advice, output notifications, and run quick jobs — right from Telegram.",
+  whatsapp:
+    "Ask your CMO questions and get marketing outputs delivered to WhatsApp.",
+};

test/ui/messaging-channel-descriptions.test.ts

@@ -0,0 +1,33 @@
+import { describe, expect, it } from "vitest";
+import { MESSAGING_CHANNEL_DESCRIPTIONS } from "../../apps/desktop/src/features/connections/components/messaging-channel-descriptions";
+
+describe("Messaging channel card descriptions", () => {
+  it("telegram description communicates value, not setup process", () => {
+    const desc = MESSAGING_CHANNEL_DESCRIPTIONS.telegram;
+    expect(desc).toBeDefined();
+    // Must not mention technical setup steps
+    expect(desc).not.toMatch(/BotFather/i);
+    expect(desc).not.toMatch(/create a bot/i);
+    // Must communicate value/outcome
+    expect(desc).toMatch(/marketing|advice|notification|job/i);
+  });
+
+  it("whatsapp description communicates value, not setup process", () => {
+    const desc = MESSAGING_CHANNEL_DESCRIPTIONS.whatsapp;
+    expect(desc).toBeDefined();
+    // Must not mention technical setup steps
+    expect(desc).not.toMatch(/QR code/i);
+    expect(desc).not.toMatch(/link your/i);
+    // Must communicate value/outcome
+    expect(desc).toMatch(/question|output|marketing/i);
+  });
+
+  it("both descriptions avoid process language entirely", () => {
+    for (const [, desc] of Object.entries(MESSAGING_CHANNEL_DESCRIPTIONS)) {
+      expect(desc).not.toMatch(/create a bot/i);
+      expect(desc).not.toMatch(/QR code/i);
+      expect(desc).not.toMatch(/BotFather/i);
+      expect(desc).not.toMatch(/link your/i);
+    }
+  });
+});