Zenova API Docs

Integrate Zenova products into your web application with our REST APIs and embeddable widgets.

Getting Started

Authentication, API keys, and base URLs.

Support API

Conversations, messages, tickets, and AI endpoints.

Widget Integration

Embed the support chat widget on your website.

Getting Started

Authentication

All API requests require an API key passed in the Authorization header:

curl -X GET https://support.zenovatm-llc.com/api/v1/tickets \
  -H "Authorization: Bearer zk_live_your_api_key_here"

Base URL

https://support.zenovatm-llc.com/api/v1

Support API Reference

Method	Endpoint	Description
POST	/api/v1/conversations	Create a new conversation
GET	/api/v1/conversations	List conversations
GET	/api/v1/conversations/:id/messages	Get conversation messages
POST	/api/v1/messages	Send a message
POST	/api/v1/tickets	Create a ticket
GET	/api/v1/tickets	List tickets
GET	/api/v1/tickets/:id	Get ticket details
PATCH	/api/v1/tickets/:id	Update a ticket
POST	/api/v1/ai/chat	Trigger AI auto-reply
POST	/api/v1/ai/suggest	Get AI agent suggestions
POST	/api/v1/ai/embed	Generate article embedding

Create a Conversation

curl -X POST https://support.zenovatm-llc.com/api/v1/conversations \
  -H "Authorization: Bearer zk_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "customer_name": "John Doe",
    "customer_email": "john@example.com",
    "subject": "Help with billing"
  }'

Returns the created conversation object with its ID.

Send a Message

curl -X POST https://support.zenovatm-llc.com/api/v1/messages \
  -H "Authorization: Bearer zk_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "conversation_id": "uuid-here",
    "content": "I need help with my subscription",
    "sender_type": "customer"
  }'

Create a Ticket

curl -X POST https://support.zenovatm-llc.com/api/v1/tickets \
  -H "Authorization: Bearer zk_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "subject": "Billing issue",
    "priority": "high",
    "category": "billing",
    "conversation_id": "uuid-here"
  }'

Widget Integration

Add the Zenova Support chat widget to any website with a single script tag.

Installation

<script
  src="https://support.zenovatm-llc.com/widget/support-chat.js"
  data-api-key="zk_live_your_key"
  data-api-url="https://support.zenovatm-llc.com/api/v1"
  data-theme="light"
  data-position="bottom-right"
  data-color="#0f172a"
  data-greeting="Hi! How can we help you today?"
></script>

Configuration Options

Attribute	Required	Description
data-api-key	Yes	Your Zenova API key
data-api-url	Yes	Support API base URL
data-theme	No	light or dark (default: light)
data-position	No	bottom-right or bottom-left
data-color	No	Primary brand color (hex)
data-greeting	No	Welcome message shown to visitors
data-api-proxy	No	Your backend mirroring /api/v1 paths; hides API key from HTML
data-customer-name	No	Pre-fill name on welcome step (escape quotes)
data-customer-email	No	Pre-fill optional email (visible in page source)