taello-core

AI-powered shopping assistant widget for any website. Drop one script tag and your store gets a fully working chat that recommends products, handles carts, and drives conversions.

Install

npm install taello-core

Script tag (no install needed)

<script
  src="https://unpkg.com/taello-core@latest/dist/sdk.iife.js"
  data-api-key="pk_live_YOUR_KEY"
  data-api-url="https://api.taello.ai/api"
  data-store-name="My Store"
  data-primary-color="#F04438"
></script>

A floating chat button appears in the bottom-right corner. That's the entire integration.

ES module

import TaelloSDK from 'taello-core'

const sdk = new TaelloSDK({
  apiKey: 'pk_live_YOUR_KEY',
  apiUrl: 'https://api.taello.ai/api',
  storeName: 'My Store',
  theme: { primaryColor: '#F04438' },
  mode: 'overlay',
  onAddToCart: (product, qty) => console.log('Added:', product),
  onCheckout: (cart) => console.log('Checkout:', cart),
})

// Later — remove the widget
sdk.destroy()

Options

| Option | Default | Description | |---|---|---| | apiKey | required | Publishable key from your Taello dashboard | | apiUrl | required | Your API base URL | | theme.primaryColor | #F04438 | Brand color (hex) | | storeName | Taello | Name shown in the chat header | | logoUrl | — | URL of your store logo | | welcomeMessage | — | Opening message from the AI | | placeholder | Ask about products... | Input placeholder text | | mode | overlay | overlay · sidebar · fullpage | | position | bottom-right | bottom-right · bottom-left | | sidebarWidth | 400 | Width in px (sidebar mode only) | | autoOpen | false | Open the chat immediately on load | | onAddToCart | — | Called when a shopper adds an item | | onViewProduct | — | Called when a shopper views a product | | onCheckout | — | Called when a shopper hits checkout |

Display modes

overlay — floating popup over your existing page (default)

sidebar — slides in from the side and pushes your page content

fullpage — fills the entire screen, ideal for dedicated chat pages and mobile web

Getting your API key

1. Sign up at taello.ai
2. Create a store and upload your product catalog (CSV or URL)
3. Go to API Keys in the sidebar and copy your publishable key

Keys starting with pk_test_ are for development. Switch to pk_live_ before going to production.

React

npm install taello-react

import { TaelloChat } from 'taello-react'

<TaelloChat apiKey="pk_live_YOUR_KEY" apiUrl="https://api.taello.ai/api" />

See taello-react on npm.

React Native

npm install taello-react-native react-native-webview

import { TaelloChat } from 'taello-react-native'

<TaelloChat
  visible={chatOpen}
  onClose={() => setChatOpen(false)}
  apiKey="pk_live_YOUR_KEY"
  apiUrl="https://api.taello.ai/api"
/>

See taello-react-native on npm.

License

MIT