Skip to main content
The official Flutter SDK for integrating g-tateth chat into Android and iOS apps.

​
Overview

With the Flutter SDK, clients can:
  • Initialize a chat session from mobile
  • Send and receive messages in real time
  • Display a native chat UI component
  • Reuse existing widget/chat backend APIs

​
Prerequisites

  • Flutter 3.19+ (Dart 3.3+)
  • Access to a valid g-tateth tenant (tenantDomain or tenantId)
  • Backend API URL (production: https://api.g-tateth.com)

​
Installation

Add the package to your Flutter app: 
dependencies:
  gtateth_flutter_sdk: ^0.1.0
If using a private/local package source, replace with your internal installation method.

​
Quick Integration

import 'package:flutter/material.dart';
import 'package:gtateth_flutter_sdk/gtateth_flutter_sdk.dart';

class SupportPage extends StatelessWidget {
  const SupportPage({super.key});

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: const Text('Support')),
      body: GtatethChatWidget(
        config: const WidgetClientConfig(
          baseUrl: 'https://api.g-tateth.com',
          tenantDomain: 'your-tenant-domain.com',
        ),
       customer: ChatCustomer(
  firstName: currentUser.firstName,
  lastName: currentUser.lastName,
  email: currentUser.email,
),

      ),
    );
  }
}

​
Required Configuration

  • baseUrl: your API host
    • Production: https://api.g-tateth.com
  • One tenant identifier:
    • tenantDomain (recommended), or
    • tenantId

​
Local Testing

For Android emulator testing:
  • Use backend URL: http://10.0.2.2:3001
  • Keep backend running on port 3001
  • Use a valid tenant identifier from your g-tateth setup response

​
Production Checklist

Before shipping to clients:
  1. Use HTTPS API URL only.
  2. Confirm tenant identifier is correct.
  3. Verify chatbot and handoff behavior per tenant settings.
  4. Test reconnect behavior on poor mobile networks.
  5. Ensure support/ops teams can monitor chat events and errors.

​
Troubleshooting

  • Tenant not found
    • Verify tenantDomain/tenantId values.
  • Failed to fetch
    • Confirm backend URL is reachable from device/emulator.
    • Emulator must use 10.0.2.2 for localhost backend.
  • No bot response
    • Check tenant chatbot settings and plan/feature access.
    • Confirm backend logs for chatbot gating and realtime emissions.

​
Support