add setup instructions

Author: jasonpraful

README.md

@@ -408,13 +408,20 @@ func application(_ application: UIApplication, didFinishLaunchingWithOptions lau
 
 #### iOS: Permissions
 
-Add this permission to your `Info.plist`
+Add these permissions to your `Info.plist`:
 
 ```xml
+<!-- Optional: Camera access for taking photos in conversations -->
 <key>NSCameraUsageDescription</key>
 <string>Access your camera to take photos within a conversation</string>
+
+<!-- Optional: Microphone access for voice message transcription (v9.3.0+) -->
+<key>NSMicrophoneUsageDescription</key>
+<string>Access your microphone to transcribe voice messages in conversations</string>
 ```
 
+**Note:** These permissions are only requested when the user attempts to use the respective feature. You can customize the description strings to match your app's use case.
+
 #### iOS: Push Notifications
 
 > **Note**: You should request user permission to display push notifications.
@@ -593,6 +600,27 @@ const apiKey = Platform.select({
 await Intercom.initialize(apiKey, 'abc123');
 ```
 
+#### Expo: iOS Permissions
+
+To enable camera and microphone features in your Expo app, add the following to your `app.json` or `app.config.js`:
+
+```json
+{
+  "expo": {
+    "ios": {
+      "infoPlist": {
+        "NSCameraUsageDescription": "Access your camera to take photos within a conversation",
+        "NSMicrophoneUsageDescription": "Access your microphone to transcribe voice messages in conversations"
+      }
+    }
+  }
+}
+```
+
+**Note:** These permissions are required for iOS SDK 19.3.0+. The microphone permission enables voice message transcription. You can customize the description strings to match your app's use case.
+
+After adding these permissions, run `npx expo prebuild` to regenerate the native iOS project with the updated Info.plist.
+
 #### Expo: Push notifications
 
 Add the following configurations into your `app.json` or `app.config.js`:

examples/example/ios/IntercomReactNativeExample/Info.plist

@@ -56,6 +56,10 @@
 	<string></string>
 	<key>NSPhotoLibraryUsageDescription</key>
 	<string>Send photos to support center</string>
+	<key>NSCameraUsageDescription</key>
+	<string>Access your camera to take photos within a conversation</string>
+	<key>NSMicrophoneUsageDescription</key>
+	<string>Access your microphone to transcribe voice messages in conversations</string>
 	<key>UIBackgroundModes</key>
 	<array>
 		<string>remote-notification</string>

examples/expo-example/app.json

@@ -13,6 +13,10 @@
       "bundleIdentifier": "com.example.intercomreactnative", // Change this to your app's bundle identifier
       "entitlements": {
         "aps-environment": "production" // Change this to your app's environment
+      },
+      "infoPlist": {
+        "NSCameraUsageDescription": "Access your camera to take photos within a conversation",
+        "NSMicrophoneUsageDescription": "Access your microphone to transcribe voice messages in conversations"
       }
     },
     "android": {

examples/with-notifications/ios/withnotification/Info.plist

@@ -33,6 +33,12 @@
 	</dict>
 	<key>NSLocationWhenInUseUsageDescription</key>
 	<string></string>
+	<key>NSPhotoLibraryUsageDescription</key>
+	<string>Send photos to support center</string>
+	<key>NSCameraUsageDescription</key>
+	<string>Access your camera to take photos within a conversation</string>
+	<key>NSMicrophoneUsageDescription</key>
+	<string>Access your microphone to transcribe voice messages in conversations</string>
 	<key>RCTNewArchEnabled</key>
 	<true/>
 	<key>UILaunchStoryboardName</key>