chore: improve comments

Author: margaritagomez

fern/security-and-privacy/recording-consent-plan.mdx

@@ -95,7 +95,7 @@ Add the recording consent plan to your assistant's `compliancePlan`:
   "compliancePlan": {
     "recordingConsentPlan": {
       "type": "verbal",
-      "message": "Can I record you please?",
+      "message": "This call may be recorded for quality and training purposes. Do you consent to being recorded? Please say 'yes' if you agree or 'no' if you decline.",
       "voice": {
         "voiceId": "Neha",
         "provider": "vapi"
@@ -106,6 +106,46 @@ Add the recording consent plan to your assistant's `compliancePlan`:
 }
 ```
 
+## Call Response Structure
+
+When you add a recording consent plan to your assistant, the call response will include a `compliance` field with recording consent information. Here's what the response looks like:
+
+### Successful Consent Response
+
+```json
+{
+  // ... Other call fields
+  "compliance": {
+    "recordingConsent": {
+      "type": "verbal",
+      "grantedAt": "2024-01-15T10:30:00Z"
+    }
+  }
+}
+```
+
+### No Consent Response
+
+```json
+{
+  "// ... Other call fields
+  "compliance": {
+    "recordingConsent": {
+      "type": "verbal"
+    }
+  }
+}
+```
+
+**Key points about the response structure:**
+
+- **`recordingConsent` field**: Always present when a consent plan is configured
+- **`type`**: Shows which consent type was used (`"verbal"` or `"stay-on-line"`)
+- **`grantedAt`**: Only set when the user explicitly grants permission
+- **Missing `grantedAt`**: Indicates the user declined consent or hung up before granting permission
+
+This structure allows you to easily determine whether recording consent was granted and audit compliance decisions for each call.
+
 ## Implementation
 
 <Steps>
@@ -142,7 +182,7 @@ Add the recording consent plan to your assistant's `compliancePlan`:
           compliancePlan: {
             recordingConsentPlan: {
               type: "verbal",
-              message: "This call may be recorded for quality and training purposes. Do you consent to being recorded?",
+              message: "This call may be recorded for quality and training purposes. Do you consent to being recorded? Please say 'yes' if you agree or 'no' if you decline.",
               declineTool: {
                 type: "endCall"
               }
@@ -170,7 +210,7 @@ Add the recording consent plan to your assistant's `compliancePlan`:
             "compliancePlan": {
                 "recordingConsentPlan": {
                     "type": "verbal",
-                    "message": "This call may be recorded for quality and training purposes. Do you consent to being recorded?",
+                    "message": "This call may be recorded for quality and training purposes. Do you consent to being recorded? Please say 'yes' if you agree or 'no' if you decline.",
                     "declineTool": {
                         "type": "endCall"
                     }