Docs / Mobile SDKs

Mobile SDKs

Add Conversa to React Native, Android, and iOS apps. Same Bot ID and backend as the website widget and WordPress plugin.

Quick setup

  1. Create a bot, add sources, process, set status to ACTIVE.
  2. Copy your Bot ID from Dashboard → Embed.
  3. Under Widget → Allowed domains: leave empty, or add mobile:com.yourcompany.app.
  4. Pass your bundle / application id as appId (sends X-Conversa-App-Id).

React Native

import { ConversaChat } from "@conversa/react-native";

<ConversaChat
  baseUrl="https://www.conversa.ng"
  botId="YOUR_BOT_ID"
  appId="com.yourcompany.app"
/>

Android

Module: integrations/mobile/android/conversa-sdk

chat.configure(ConversaConfig(
  "https://www.conversa.ng",
  "YOUR_BOT_ID",
  applicationContext.packageName
))

iOS (SwiftPM)

Package: integrations/mobile/ios/ConversaSDK

ConversaChatView(config: ConversaConfig(
  baseURL: URL(string: "https://www.conversa.ng")!,
  botId: "YOUR_BOT_ID",
  appId: Bundle.main.bundleIdentifier
))

Full guide (WebView embed, troubleshooting, core client): see docs/MOBILE_SDK.md in the Conversa repository.

← Back to embed docs