algolia-webhooks-events

# Algolia Events & Insights ## Overview Algolia doesn't use traditional webhooks. Instead, it provides the **Insights API** for sending user behavior events (clicks, conversions, views) back to Algolia, and the **Analytics API** for reading search performance data. For keeping your index in sync, you build event-driven pipelines from your database to Algolia. ## Prerequisites - `algoliasearch` v5 installed (Insights client is included) - Index with records and `queryID` enabled (for click analytics) - `search-insights` npm package for frontend event tracking ## Instructions ### Step 1: Enable Click Analytics in Search ```typescript import { algoliasearch } from 'algoliasearch'; const client = algoliasearch(process.env.ALGOLIA_APP_ID!, process.env.ALGOLIA_ADMIN_KEY!); // Enable clickAnalytics to get queryID in search results const { hits, queryID } = await client.searchSingleIndex({ indexName: 'products', searchParams: { query: 'running shoes', clickAnalytics: true, // Returns queryID for event correlation }, }); // queryID links this search to subsequent click/conversion events ``` ### Step 2: Send Click and Conversion Events (Backend) ```typescript // The Insights API is built into the algoliasearch client // Events connect user behavior back to specific search queries // Track a click on a search result await client.pushEvents({ events: [{ eventType: 'click', eventName: 'Product Clicked', index: 'products', userToken: 'user-123',...