Mobile SDKs

// Swift Package Manager
// Xcode ▸ File ▸ Add Package Dependencies… then enter the package URL
// and pin to "Up to Next Major Version" from 1.0.0:
https://github.com/awncare/awncare-ios

// …or add it to Package.swift:
dependencies: [
  .package(url: "https://github.com/awncare/awncare-ios", from: "1.0.0"),
]

import AwnCareSDK

AwnCare.configure(workspaceId: "YOUR_WORKSPACE_ID", locale: "ar", color: "#2431E0")

// Present the chat full-screen from any UIViewController:
AwnCare.present(from: self)

// Attach the visitor's identity:
AwnCare.identify(AwnCareIdentity(name: "Sara", email: "[email protected]"))

AwnCare.identify(AwnCareIdentity(
  name: "Sara",
  email: "[email protected]",
  externalId: "usr_10294",
  metadata: ["plan": "pro"]
))

// Switch language or clear the identity later:
AwnCare.setLocale("en")
AwnCare.logout()

// Observe widget events with closures…
AwnCare.onReady = { print("AwnCare ready") }
AwnCare.onUnreadCountChanged = { count in
  UIApplication.shared.applicationIconBadgeNumber = count
}
AwnCare.onChatClosed = { print("Chat closed") }

// …or conform to AwnCareDelegate:
class Support: AwnCareDelegate {
  func awnCare(_ awn: AwnCare, didChangeUnread count: Int) { /* … */ }
  func awnCareDidClose(_ awn: AwnCare) { /* … */ }
}
AwnCare.delegate = Support()

// Embed the chat inside your own screen as a child view controller:
let chat = AwnCareChatViewController(
  workspaceId: "YOUR_WORKSPACE_ID",
  locale: "ar",
  color: "#2431E0"
)
addChild(chat)
chat.view.frame = container.bounds
container.addSubview(chat.view)
chat.didMove(toParent: self)

// settings.gradle.kts — add the JitPack repository:
dependencyResolutionManagement {
  repositories {
    maven { url = uri("https://jitpack.io") }
  }
}

// app/build.gradle.kts — add the dependency:
dependencies {
  implementation("com.github.awncare:awncare-android:1.0.0")
}

import care.awn.sdk.AwnCare
import care.awn.sdk.AwnCareIdentity

AwnCare.configure(workspaceId = "YOUR_WORKSPACE_ID", locale = "ar", color = "#2431E0")

// Launch the chat full-screen:
AwnCare.open(context)

// Attach the visitor's identity:
AwnCare.identify(AwnCareIdentity(name = "Sara", email = "[email protected]"))

AwnCare.identify(
  AwnCareIdentity(
    name = "Sara",
    email = "[email protected]",
    externalId = "usr_10294",
    metadata = mapOf("plan" to "pro"),
  )
)

// Switch language or clear the identity later:
AwnCare.setLocale("en")
AwnCare.logout()

AwnCare.setListener(object : AwnCareListener {
  override fun onReady() { /* … */ }
  override fun onUnreadCountChanged(count: Int) {
    // update your own badge
  }
  override fun onConversationStarted(conversationId: String) { /* … */ }
  override fun onChatClosed() { /* … */ }
})

<!-- Drop the chat into any layout: -->
<care.awn.sdk.AwnCareChatView
    android:id="@+id/awnChat"
    android:layout_width="match_parent"
    android:layout_height="match_parent" />

// Configure the embedded view from code:
findViewById<AwnCareChatView>(R.id.awnChat).apply {
  workspaceId = "YOUR_WORKSPACE_ID"
  locale = "ar"
  color = "#2431E0"
}

# pubspec.yaml
dependencies:
  webview_flutter: ^4.0.0
  awncare_flutter:
    git:
      url: https://github.com/awncare/awncare-flutter
      path: sdks/flutter/awncare_flutter

import 'package:awncare_flutter/awncare_flutter.dart';

AwnCare.configure(workspaceId: 'YOUR_WORKSPACE_ID', locale: 'ar', color: '#2431E0');

// Push the chat as a full-screen route:
Navigator.push(
  context,
  MaterialPageRoute(
    builder: (_) => AwnCareChatScreen(
      onUnreadCountChanged: (count) => setState(() => unread = count),
      onClosed: () => Navigator.pop(context),
    ),
  ),
);

AwnCare.identify(const AwnCareIdentity(
  name: 'Sara',
  email: '[email protected]',
  externalId: 'usr_10294',
  metadata: {'plan': 'pro'},
));

// Switch language or clear the identity later:
AwnCare.setLocale('en');
AwnCare.logout();

// Per-screen callbacks:
AwnCareChatScreen(
  onReady: () => debugPrint('ready'),
  onUnreadCountChanged: (count) => setState(() => unread = count),
  onConversationStarted: (id) => debugPrint('conversation $id'),
  onClosed: () => Navigator.pop(context),
);

// …or subscribe to the global event stream:
final sub = AwnCareEvents.stream.listen((event) {
  if (event is AwnCareUnread) setState(() => unread = event.count);
});

// Embed the chat inside any widget tree:
SizedBox(
  height: 480,
  child: AwnCareChatView(
    workspaceId: 'YOUR_WORKSPACE_ID',
    locale: 'ar',
    color: '#2431E0',
    onUnreadCountChanged: (count) => setState(() => unread = count),
  ),
);

npm install github:awncare/awncare-react-native react-native-webview

# iOS only — install the native pods:
cd ios && pod install

import { AwnCareChat } from '@awncare/react-native';

export function SupportScreen({ navigation }) {
  const [unread, setUnread] = useState(0);
  return (
    <AwnCareChat
      workspaceId="YOUR_WORKSPACE_ID"
      locale="ar"
      color="#2431E0"
      identity={{ name: 'Sara', email: '[email protected]' }}
      onUnreadCountChanged={(c) => setUnread(c)}
      onClosed={() => navigation.goBack()}
    />
  );
}

import { useRef } from 'react';
import { AwnCareChat, AwnCareChatRef } from '@awncare/react-native';

const ref = useRef<AwnCareChatRef>(null);

// Imperatively drive the chat through the ref:
ref.current?.identify({
  name: 'Sara',
  email: '[email protected]',
  externalId: 'usr_10294',
  metadata: { plan: 'pro' },
});
ref.current?.setLocale('en');
ref.current?.logout();

<AwnCareChat ref={ref} workspaceId="YOUR_WORKSPACE_ID" />;

<AwnCareChat
  workspaceId="YOUR_WORKSPACE_ID"
  onReady={() => console.log('ready')}
  onUnreadCountChanged={(count) => setUnread(count)}
  onConversationStarted={(id) => console.log('conversation', id)}
  onMessageReceived={({ text, sender }) => console.log(sender, text)}
  onClosed={() => navigation.goBack()}
/>

// <AwnCareChat> is just a View — render it inside any container:
<View style={{ height: 480, borderRadius: 16, overflow: 'hidden' }}>
  <AwnCareChat workspaceId="YOUR_WORKSPACE_ID" locale="ar" color="#2431E0" />
</View>