Arena Fi SmartDialog API

Name: SmartDialog API
Brand: SmartDialog API
Availability: InStock

★ Only Publicly Available OpenAPI DocumentCommunicationsChat Messagingbearer5 EndpointsREST

For Agents

Define and manage dialog flows on the SmartDialog platform and read back conversation transcripts produced by those flows.

Install Jentic One Beta

Connect the SmartDialog API to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the SmartDialog API, 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://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh

Step 2: Agent machine

# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | 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 SmartDialog API.

List dialog flow definitions stored on the SmartDialog platform

Create a new dialog flow with steps and routing logic

Fetch a single dialog by id with its current configuration

Update an existing dialog's configuration

GET STARTED

Start building with SmartDialog API

Explore with Jentic

View OpenAPI Document

Use Cases

Patterns agents use SmartDialog API for, with concrete tasks.

★ Conversational Self-Service Deployment

Configure SmartDialog flows for customer self-service in industries such as utilities and public services, where end-users complete tasks through scripted conversational steps. The dialogs endpoint handles flow CRUD and the conversations endpoint exposes the transcripts each flow has produced, so deployment and quality monitoring can be scripted rather than done manually in a dashboard.

Create a SmartDialog flow named 'meter-reading-2026' with three steps and confirm it appears in GET /dialogs

Conversation Quality Audit

Audit conversations handled by a SmartDialog flow by pulling the transcripts via /conversations and feeding them into a review pipeline that flags failed intents or escalation triggers. This lets ops teams measure dialog effectiveness without manual log scraping.

Fetch the latest conversations from /conversations and summarise which dialog flows had the most escalations to a human agent

Dialog Versioning Workflow

Maintain dialog flow versions in source control by reading the dialog definition via GET /dialogs/{id}, storing it in a repo, and pushing updates back via the update endpoint. This brings change history to a domain that is usually managed inside a vendor UI.

Pull the JSON definition for dialog id 42 via GET /dialogs/42, commit it to git, and after editing push the updated definition back via the dialog update endpoint

Agent-Driven Dialog Management via Jentic

Give an internal agent a single tool that creates and inspects SmartDialog flows on demand. The agent searches Jentic for 'create a SmartDialog dialog', loads the schema, and executes — without an operator needing to log into the SmartDialog dashboard.

Search Jentic for 'create a SmartDialog dialog', load the schema, and execute to spin up a new flow for handling password reset conversations

Key Endpoints

5 endpoints — jentic publishes the only available openapi specification for smartdialog api, keeping it validated and agent-ready.

METHOD

PATH

DESCRIPTION

GET

/dialogs

List dialog flows

POST

/dialogs

Create a new dialog flow

GET

/dialogs/{id}

Fetch a dialog by id

PUT

/dialogs/{id}

Update an existing dialog

GET

/conversations

List conversations handled by dialogs

GET

/dialogs

List dialog flows

POST

/dialogs

Create a new dialog flow

GET

/dialogs/{id}

Fetch a dialog by id

PUT

/dialogs/{id}

Update an existing dialog

GET

/conversations

List conversations handled by dialogs

Why Jentic?

Three things that make agents converge on Jentic-routed access.

Credential isolation

SmartDialog bearer tokens are encrypted in the Jentic vault and injected at execution time. The agent never receives the raw token in its context.

Intent-based discovery

Agents search Jentic with intents like 'create a SmartDialog dialog' or 'list conversations'. Jentic returns the matching SmartDialog operation and input schema directly.

Time to first call

Direct SmartDialog integration: 1-2 days to build auth, dialog payload shaping, and conversation polling. Through Jentic: under 1 hour — search, load, execute.

FAQs

Specific to using SmartDialog API through Jentic.

Why is there no official OpenAPI spec for SmartDialog API?

Arena does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call SmartDialog API via structured tooling. It is validated against the live API and kept up to date. Get started at https://app.jentic.com/sign-up.

What authentication does the SmartDialog API use?

SmartDialog uses HTTP Bearer token authentication on the Authorization header. Through Jentic, the token is held encrypted in the vault and supplied to the call at runtime, so the agent context never holds the raw secret.

Can I create dialog flows programmatically with the SmartDialog API?

Yes. POST /dialogs accepts a dialog definition body and creates a new flow. GET /dialogs/{id} returns the resulting configuration so you can verify the create succeeded.

What are the rate limits for the SmartDialog API?

Arena does not publish hard rate limits in the public spec. In practice, the platform is meant for management traffic rather than message-per-second loads — keep dialog list polling to once per minute or less and rely on conversation listings for batch reads.

How do I list all dialogs through Jentic?

Run pip install jentic, then search Jentic with 'list SmartDialog dialogs', load the returned schema for GET /dialogs, and execute. The response is a list of dialog flow definitions you can iterate over.

Can I read the conversations a dialog has handled?

Yes. GET /conversations returns conversation records produced by dialogs, which you can filter to a specific dialog via the appropriate query parameter described in the spec.

Arena Fi SmartDialog API

Connect the SmartDialog API to your agent

Capabilities

Start building with SmartDialog API

Use Cases

Key Endpoints

Why Jentic?

Related APIs

FAQs