deeplinks first pass review

Author: hughescoin

docs/docs.json

@@ -466,7 +466,8 @@
             "pages": [
               "mini-apps/technical-guides/sign-manifest",
               "mini-apps/technical-guides/dynamic-embeds",
-              "mini-apps/technical-guides/neynar-notifications"
+              "mini-apps/technical-guides/neynar-notifications",
+              "mini-apps/technical-guides/deeplinks"
 
             ]
           },

docs/mini-apps/technical-guides/deeplinks.mdx

@@ -0,0 +1,119 @@
+---
+title: 'Deeplinks for Agent Interactions'
+description: 'Use deeplinks to create seamless user flows between group and private conversations within Base App.'
+sidebarTitle: 'Deeplinks'
+---
+
+Deeplinks enable seamless navigation within Base App, allowing you to create more engaging and intuitive user experiences. Deeplinks enable you to directing users to start a private conversation with an agent or a group chat.
+
+## Implementation 
+
+Create a button that invites a user to join a group chat
+
+<Steps>
+  <Step title="Create a conversation ID">
+    
+    XMTP stuff -- reference: 
+
+    might need to update `group` to `conversation` / `conversationID`
+  ```typescript CreateGroupChat.tsx
+  const group = await client.conversations.newGroup(
+    [bo.inboxId, caro.inboxId],
+  );
+  ```
+
+  </Step>
+  <Step title="Use the openUrl hook">
+
+  Use `sdk.actions.openUrl()` to safely navigate a user to a group chat.
+
+
+  ```typescript ChatButtonComponent.tsx highlight={19, 36-42}
+  import { useState } from 'react';
+
+  interface DeeplinkButtonProps {
+    conversationID: string;
+    label?: string;
+    className?: string;
+  }
+
+  export function DeeplinkButton({ 
+    conversationID, 
+    label = "Direct Message",
+    className = "btn-primary" 
+  }: DeeplinkButtonProps) {
+    const [isLoading, setIsLoading] = useState(false);
+
+    const handleDeeplink = async () => {
+      setIsLoading(true);
+      try {
+        const deeplink = `cbwallet://messaging/${conversationID}`;
+        
+        // Check if running in supported environment
+        if (typeof window !== 'undefined') {
+          window.location.href = deeplink;
+        } else {
+          // Fallback for server-side rendering
+          console.warn('Deeplink not supported in this environment');
+        }
+      } catch (error) {
+        console.error('Failed to open deeplink:', error);
+      } finally {
+        setIsLoading(false);
+      }
+    };
+
+    return (
+      <button 
+        onClick={handleDeeplink}
+        disabled={isLoading}
+        className={className}
+      >
+        {isLoading ? 'Opening...' : label}
+      </button>
+    );
+  }
+  ```
+
+
+  </Step>
+  <Step title="Third Step">
+    These are instructions or content that only pertain to the third step.
+  </Step>
+</Steps>
+
+
+## Schema
+
+### Group Messages  
+
+Create a direct link to a group chat
+
+```
+cbwallet://messaging/${conversationID}
+```
+
+### Parameters
+
+<ResponseField name="conversationID" type="string" required>
+  The unique identifier for a XMTP chat
+</ResponseField>
+
+
+
+### Direct Message  (User or Agents)
+
+Create a direct link to message an agent or user
+
+```
+cbwallet://messaging/${address}
+```
+
+### Parameters
+
+<ResponseField name="address" type="string" required>
+  The 0x address of the user or agent you want to chat with (in hex format, e.g., `0xabc...1234`)
+</ResponseField>
+
+
+