React Native SDK

yarn add @kindly-ai/react-native
cd ios && pod install

import { KindlySDK, hexColor } from '@kindly-ai/react-native';

// 1. Initialize once on app start
KindlySDK.start({
  botKey: 'your-bot-key',
  market: 'general', // required — your market slug (Settings → General → Details & markets)
  languageCode: 'en',
  // Optional: invoked by the SDK when it needs an authenticated JWT for
  // the current chat session. `chatId` is the backend-generated identifier
  // — include it when calling your auth backend so the token is scoped to
  // this chat. Return null for anonymous chats.
  authTokenCallback: async (chatId) => {
    return await yourAuthBackend.getKindlyJWT({ chatId });
  },
});

// Identity providers that issue more than a single JWT - a companion access
// token, an issuer, or an opaque token whose expiry only you know - use
// authCredentialsCallback instead. It wins when both are given.
KindlySDK.start({
  botKey: 'YOUR_BOT_KEY',
  market: 'general',
  authCredentialsCallback: async (chatId) => {
    const tokens = await yourAuthBackend.getTokens({ chatId });
    return {
      idToken: tokens.idToken,             // optional
      accessToken: tokens.accessToken,     // optional
      issuer: 'https://idp.example.com/',  // optional
      expiresAt: tokens.expiresAtUnixSeconds, // optional, Unix seconds
    };
  },
});

// Only an access token? Return only that. It becomes the bearer.
KindlySDK.start({
  botKey: 'YOUR_BOT_KEY',
  market: 'general',
  authCredentialsCallback: async () => ({
    accessToken: await yourAuthBackend.getAccessToken(),
    issuer: 'https://idp.example.com/',
  }),
});

// 2. Open the chat UI when the user wants it
<Button title="Open chat" onPress={() => KindlySDK.launchChat()} />

// 3. (Optional) host-app callbacks for buttons / link interception
KindlySDK.setDelegate({
  onButtonPressed: (button, chatLog) => console.log('button', button),
  shouldHandleLink: (url) => {
    if (url.startsWith('myapp://')) {
      // Take over the deep link
      return false;
    }
    return true; // let the SDK open it
  },
});