React Native Requirements

Review the requirements for integrating the Agentforce Mobile SDK with your React Native application.

RequirementMinimum Version
Node.js18+
React Native0.72+
iOS deployment target15.0
Android minSdk29
Android compileSdk36
Xcode15+
CocoaPods1.14+
JDK17
Kotlin2.2+

Before using the SDK in your app, configure your Salesforce org:

  1. Enable Agentforce in your org (Setup > Agentforce).
  2. Create an Agent: Either a Service Agent (for anonymous customer-facing use) or an Employee Agent (for authenticated internal use).
  3. Note the required values from your org configuration.

If you're enabling voice, create and configure your service agent in Agentforce Studio. For current mobile GA implementations, connect your service agent to telephony. See Create a Voice-Enabled Service Agent in Agentforce Studio.

ValueWhere to FindUsed By
serviceApiURLSetup > Embedded Service Deployments > your deployment > SettingsService Agent
organizationIdSetup > Company Information > Organization IDBoth
esDeveloperNameSetup > Embedded Service Deployments > your deployment > Developer NameService Agent
instanceUrlYour Salesforce instance URL (for example, https://myorg.my.salesforce.com)Employee Agent
userIdYour Salesforce User ID (from user profile)Employee Agent
agentIdSetup > Agentforce > your agent > Agent IDEmployee Agent

Set up your development environment for each platform.

  • macOS with Xcode 15 or later
  • CocoaPods 1.14 or later
  • Swift 5.0+ support (the bridge is written in Swift)
  • Android Studio with Android SDK
  • JDK 17
  • Kotlin 2.2+
  • Jetpack Compose support (the SDK uses Compose for the conversation UI)

Depending on the features you enable, you may need to add these permissions:

For voice input (enableVoice: true):

For camera and photo input (enableMultiModalInput: true):

For camera and multi-modal input: