SmartDialog API

Name: SmartDialog API 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.

Quickstart

Get started with SmartDialog API in minutes using your preferred integration method.

# Add to your MCP client config (Claude Desktop, Cursor, Windsurf)
{
  "jentic": {
    "url": "https://api.jentic.com/mcp",
    "auth": "oauth"
  }
}

# Then ask your agent:
"create a SmartDialog dialog flow"

# → Jentic returns the GET /events tool with parameter schema, agent executes.

Capabilities

What an agent can do with SmartDialog API 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

Retrieve conversation transcripts produced by a dialog flow

GET STARTED

Start building with SmartDialog API API

Explore with Jentic

View OpenAPI Document

Jentic publishes the only available OpenAPI document for SmartDialog API, keeping it validated and agent-ready.

Jentic publishes the only available OpenAPI specification for SmartDialog API, keeping it validated and agent-ready. SmartDialog is Arena's conversational platform API for managing dialog flows and the conversations that run through them. Five endpoints cover dialog definition (list, create, fetch, update) and conversation retrieval, so an agent can assemble new dialog flows or read the conversation history that customers have produced inside them.

Use Cases

Patterns agents use SmartDialog API 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 though 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.

Related APIs

Alternatives and complements available in the Jentic catalogue.

Complementary

Slack API

Slack handles internal team messaging while SmartDialog handles end-customer conversational flows

Use Slack when the agent posts internally to a channel; use SmartDialog when the agent is configuring or auditing customer-facing dialog flows.

Alternative

Discord API

Discord exposes generic chat and bot primitives; SmartDialog exposes scripted conversational flows aimed at customer self-service

Choose Discord for community chat bot integrations. Choose SmartDialog when the conversation needs structured dialog steps and transcript retrieval for ops review.

Complementary

Calendly API

Calendly schedules the human handoff after a SmartDialog flow escalates beyond self-service

Pair when the SmartDialog flow ends in a human handoff and the agent needs to book the follow-up call automatically.

FAQs

Specific to using SmartDialog API 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.