AI Conversation Summary Request

  • Published on Dec 16, 2025
  • 1 minute(s) read
  • EM
 Prev Next
Post
/ai-services/summary_conversation

This API requests asynchronous AI-powered summarization of customer-agent conversations.
The generated AI summary comes in the desired language specified in the request (automated translation), with the option to direct the output as a webhook.


Request Body Parameters:
Text (mandatory) with the object's content
Language (mandatory) with the desired language of the output
Callback_url (optional) with the Webhook URL destination of the summary.

Note: AI summaries are available for 12 hours, after which they are deleted from the cache and the action_ids become invalid.
Conversation text must be at least 150 characters.

Security
HTTP
Type bearer

API key is needed to authorize requests. You can get your API key via the management console.
A Bearer Token is needed to be set in the Authorization header of every API call.
For additional support you can contact us.

Body parameters

null

object
text
string Required

The content of the object (conversation for summary)

ExampleAgent: Good morning! Welcome to First National Bank. How can I help you today? Customer: Hi, I'm having a couple of issues...
language
string Required

Language of the output

Exampleenglish
callback_url
string

Webhook URL destination of the summary

Examplehttps://webhook.site/0088b4fa-3b8b-4e00-b3e4-35353ea79b45
Responses
200

Summary generated successfully

object
status
string

The request status for the AI conversation summary

ExampleInitialized
answer
string

Conversation summary. Empty object (populated when completed)

Example
action_id
string

Unique identifier for tracking this request

ExampleAI_API_SUMMARY_2f6995be-d52b-484b-9bae-2578227caf58
400

Bad request - invalid input parameters

object
error
string
ExampleInvalid language parameter or Text too short
status
integer
Example400
401

Unauthorized

object
error
string
Exampletrue
message
string
ExampleInvalid or missing authentication token
404

Not Found

object
status
integer
Example404
description
string
ExampleNot found
response_time
string (date-time)
Example2025-12-14T07:26:35.975Z
500

Internal server error

object
error
string
ExampleInternal server error occurred
status
string
Exampleerror