Install Jentic One Beta

Connect the Jirafe Events to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Jirafe Events, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.

Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.

Step 1: Jentic One Host machine

# On the machine that will host your Jentic One instance:
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fjirafe.com%2Fjirafe" | sh

Step 2: Agent machine

# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fjirafe.com%2Fjirafe" | sh
jentic register       # connects your agent to your Jentic One instance

Jentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.

Capabilities

What an agent can do with Jirafe Events API.

Record cart events as shoppers add or remove items

Record order events when a purchase completes

Record product view and detail events for a site

Record category browsing events

Record customer identification events

GET STARTED

Start building with Jirafe Events API

Explore with Jentic One

View OpenAPI Document

Use Cases

Patterns agents use Jirafe Events API for, with concrete tasks.

★ Stream storefront events to analytics

Merchandising teams need shopper behavior in one analytics system to spot drop-off and demand. The Jirafe Events API accepts cart, product, category, and order events for a site, so a storefront can post each interaction as it happens and let Jirafe assemble funnels and product performance. Events are scoped per site by the identifier in the path.

Post a cart event to Jirafe each time a shopper adds a product, including the site identifier and item details.

Capture completed purchases

Revenue reporting depends on reliable order data. The Jirafe order event carries the details of a completed purchase for a site, letting an analytics pipeline attribute revenue to sessions and campaigns without direct database access. Sending the event at checkout keeps the analytics view close to real time.

Send an order event to Jirafe when checkout completes, including the order total and line items for the site.

Backfill history in bulk

Teams onboarding to analytics often have a backlog of events to load. The Jirafe batch endpoint accepts several events in one request, so an import job can replay historical cart, product, and order activity for a site rather than posting each event separately. Batching reduces the number of round trips during a migration.

Group a day of stored storefront events into a single batch request and post it to Jirafe for the site.

Agent-driven event instrumentation

An AI agent managing a storefront integration can emit analytics events without a developer hand-wiring each call. Through Jentic the agent matches an intent such as 'record this cart event' to the right Jirafe operation, sends the payload for the site, and confirms acceptance. The OAuth2 credential stays in the user's Jentic One instance and never reaches the agent's prompt.

Translate a storefront webhook into a Jirafe cart or order event and post it for the correct site.

Key Endpoints

6 endpoints — the jirafe events api records ecommerce behavioral events for analytics.

METHOD

PATH

DESCRIPTION

POST

/{siteId}/cart

Record a cart event for a site.

POST

/{siteId}/order

Record an order event for a site.

POST

/{siteId}/product

Record a product view or detail event for a site.

POST

/{siteId}/category

Record a category browsing event for a site.

POST

/{siteId}/customer

Record a customer identification event for a site.

POST

/{siteId}/batch

Submit multiple events in a single batch for a site.

POST

/{siteId}/cart

Record a cart event for a site.

POST

/{siteId}/order

Record an order event for a site.

POST

/{siteId}/product

Record a product view or detail event for a site.

POST

/{siteId}/category

Record a category browsing event for a site.

POST

/{siteId}/customer

Record a customer identification event for a site.

POST

/{siteId}/batch

Submit multiple events in a single batch for a site.

Why Jentic?

What agents get from Jentic-routed access to this vendor.

Setup

Wiring Jirafe yourself means running an OAuth2 flow, threading a site identifier into every event path, and shaping each cart, order, or product payload correctly. With Jentic you install once, import Jirafe from the API Directory, and authorize the credential a single time.

Permission scoping

Jentic lets you grant your agent only the Jirafe event types it needs, such as cart and order events without customer events, and enforces that on every call.

Credential isolation

Your Jirafe OAuth2 credential is stored once, encrypted, by your own Jentic One instance. It is injected when a call runs and never enters the agent's prompt, logs, or context.

Intent-based discovery

Agents find Jirafe through Jentic's intent search, matching a request like 'record this order event' to the right endpoint without hardcoded paths.

FAQs

Specific to using Jirafe Events API through Jentic.

What can an AI agent do with the Jirafe Events API through Jentic?

An agent can post cart, order, product, category, and customer events for a site and submit several at once through the batch endpoint. Through Jentic the agent matches an intent to the right event operation and calls it with your OAuth2 credential injected at run time.

How do I authenticate with the Jirafe Events API?

Jirafe uses OAuth2, so requests carry an access token obtained through the authorization flow. You authorize once and store the credential in your Jentic One instance, which supplies the token on each call rather than placing it in the agent's prompt.

Are events scoped to a single store?

Yes. Every event endpoint takes a site identifier in its path, so each call records activity for one store. Send the identifier that matches the storefront the event came from.

Does the API define rate limits for event ingestion?

The OpenAPI specification does not state rate limits or ingestion quotas; throughput depends on your Jirafe agreement. Confirm the limits that apply to your account with Jirafe before running a large backfill.

Can I control what my agent is allowed to do with the Jirafe Events API?

Yes. Jentic lets you allow only the event types your agent should send, for example cart and order events while withholding customer events. Your Jentic One instance enforces that scope on every call and keeps the OAuth2 credential outside the agent's context.

Jirafe Events

Name: Jirafe Events API
Brand: Jirafe Events
Availability: InStock

Community OpenAPI document · agent-readyAnalyticsProduct Analyticsoauth26 EndpointsREST

Know of an official OpenAPI document? Contribute it →

For Agents

Send cart, order, product, category, and customer events for a site to Jirafe for ecommerce analytics, individually or in batches.

Use for: I need to send a completed order event to Jirafe, Track when a shopper adds an item to their cart, Report a product view for analytics, Log which category a customer browsed

Not supported: Does not build dashboards, run queries, or store product catalogs; use it to send ecommerce events to Jirafe only.

The Jirafe Events API records ecommerce behavioral events for analytics. It accepts cart, order, product, category, and customer events for a given site, plus a batch endpoint that submits several events at once, feeding Jirafe's merchandising and product analytics. Each event posts as JSON scoped to one site, so an agent can stream shopper activity into Jirafe without wiring a full tracking SDK.

Jentic One on Github View OpenAPI Document

Connect the Jirafe Events to your agent

Capabilities

Start building with Jirafe Events API

Use Cases

Key Endpoints

Why Jentic?

Related APIs

FAQs

Jirafe Events