Skip to main content

truhuddle_widget 2.1.5 copy "truhuddle_widget: ^2.1.5" to clipboard
truhuddle_widget: ^2.1.5 copied to clipboard

TruHuddle customer support for Flutter with a bundled widget with live messaging, voice notes and workspace settings.

TruHuddle Widget for Flutter #

Open customer support with the same design as your TruHuddle web widget.

Install #

flutter pub add truhuddle_widget

Add your Android package name or iOS bundle ID once in TruHuddle → Widget settings → Integration & Security. The package reads the installed app's identifier automatically.

Open support #

import 'package:truhuddle_widget/truhuddle_widget.dart';

final support = TruhuddleOptions(appId: 'YOUR_APP_ID');

// Run when your signed-in screen opens, before the support button is tapped.
TruhuddleWidget.preload(options: support);

// Your support button:
await TruhuddleWidget.open(context, options: support);

You can also prefill a guest's details:

TruhuddleOptions(
  appId: 'YOUR_APP_ID',
  name: 'Amara Johnson',
  email: 'amara@example.com',
)

Your workspace controls the logo, colors, greeting and features. The widget interface is bundled with this package. Update the package to receive interface changes.

Guests' names and emails are remembered on this device. They can use Profile → Clear session to start again. When your app supplies both details, the widget keeps them read-only. Guest details do not verify identity.

On logout, close support and clear saved guest access:

await TruhuddleWidget.clearGuestSession(appId: 'YOUR_APP_ID');

Signed-in customers #

For private account history, pass a session from your signed-in backend:

TruhuddleOptions(
  appId: 'YOUR_APP_ID',
  getSession: () async => TruhuddleSession.fromJson(
    await yourApi.createSupportSession(),
  ),
)

You can pass session: yourSession directly instead. A callback can renew expiring sessions. Names and emails alone are guest details, not verified identity. Close support when the customer logs out or changes accounts. Verified customer guide.

The widget remembers its appearance and recent-chat preview securely on the device, then refreshes them in the background. A first uncached visit shows a small loading indicator. Call clearGuestSession when signing out to remove saved guest access and the local widget cache.

Devices and permissions #

Requires Flutter 3.41+, Android API 24+, or iOS 13+ and an internet connection.

Chat options can export a transcript as TXT or Markdown using the device’s save/share sheet. Android builds require Java 17, Kotlin 2.2+, Android Gradle Plugin 8.12.1+ and Gradle 8.13+.

Android AndroidManifest.xml:

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.RECORD_AUDIO" />

iOS Info.plist, if you enable voice notes or photos:

<key>NSMicrophoneUsageDescription</key>
<string>Record a voice note for support.</string>
<key>NSCameraUsageDescription</key>
<string>Take a photo to share with support.</string>
<key>NSPhotoLibraryUsageDescription</key>
<string>Share a photo with support.</string>

For remembered guest sessions, enable Keychain Sharing on the iOS Runner and exclude secure-storage preferences from Android backups, following the secure-storage setup. If device storage is unavailable, support still opens but guest details may not be remembered.

For iOS projects using CocoaPods, enable PERMISSION_MICROPHONE=1 in the permission_handler build settings described in its setup guide. Gallery selection uses the system picker; broad storage access is not requested.

Documentation

0
likes
0
points
1.14k
downloads

Publisher

unverified uploader

Weekly Downloads

TruHuddle customer support for Flutter with a bundled widget with live messaging, voice notes and workspace settings.

Homepage

Funding

Consider supporting this project:

truhuddle.com

License

unknown (license)

Dependencies

crypto, flutter, flutter_secure_storage, image_picker, package_info_plus, path_provider, permission_handler, share_plus, url_launcher, webview_flutter, webview_flutter_android

More

Packages that depend on truhuddle_widget