Telnyx

POST

callConversationInsightsGenerated

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

telnyx-timestamp

integer<int64>

required

Unix timestamp (seconds since epoch) of when the webhook was sent - compatible with webhook-timestamp Unix timestamp for replay attack prevention

telnyx-signature-ed25519

string

required

Base64 encoded Ed25519 signature for webhook verification - compatible with webhook-signature Ed25519 signature of timestamp|payload for verification

Body

application/json

data

Call Conversation Insights Generated · object

Show child attributes

data.record_type

enum<string>

Identifies the type of the resource.

Available options:

event

Example:

"event"

data.event_type

enum<string>

The type of event being delivered.

Available options:

call.conversation_insights.generated

Example:

"call.conversation_insights.generated"

data.id

string<uuid>

Identifies the type of resource.

Example:

"0ccc7b54-4df3-4bca-a65a-3da1ecc777f0"

data.occurred_at

string<date-time>

ISO 8601 datetime of when the event occurred.

Example:

"2018-02-02T22:25:27.521992Z"

data.payload

object

Show child attributes

data.payload.call_control_id

string

Call ID used to issue commands via Call Control API.

Example:

"v3:MdI91X4lWFEs7IgbBEOT9M4AigoY08M0WWZFISt1Yw2axZ_IiE4pqg"

data.payload.connection_id

string

Call Control App ID (formerly Telnyx connection ID) used in the call.

Example:

"7267xxxxxxxxxxxxxx"

data.payload.call_leg_id

string

ID that is unique to the call and can be used to correlate webhook events.

Example:

"428c31b6-7af4-4bcb-b7f5-5013ef9657c1"

data.payload.call_session_id

string

ID that is unique to the call session and can be used to correlate webhook events. Call session is a group of related call legs that logically belong to the same phone call, e.g. an inbound and outbound leg of a transferred call.

Example:

"428c31b6-abf3-3bc1-b7f4-5013ef9657c1"

data.payload.client_state

string

State received from a command.

Example:

"aGF2ZSBhIG5pY2UgZGF5ID1d"

data.payload.calling_party_type

enum<string>

The type of calling party connection.

Available options:

pstn,

sip

Example:

"pstn"

data.payload.insight_group_id

string

ID that is unique to the insight group being generated for the call.

Example:

"428c31b6-abf3-3bc1-b7f4-5013ef9657c1"

data.payload.results

object[]

Array of insight results being generated for the call.

Show child attributes

data.payload.results.insight_id

string

ID that is unique to the insight result being generated for the call.

Example:

"428c31b6-abf3-3bc1-b7f4-5013ef9657c1"

data.payload.results.result

The result of the insight.

Example:

{
  "record_type": "event",
  "event_type": "call.conversation_insights.generated",
  "id": "898e96ef-be63-45aa-9e7d-01332bff9a97",
  "occurred_at": "2025-02-19T17:02:49.371454Z",
  "payload": {
    "call_control_id": "v3:MdI91X4lWFEs7IgbBEOT9M4AigoY08M0WWZFISt1Yw2axZ_IiE4pqg",
    "connection_id": "7267xxxxxxxxxxxxxx",
    "call_leg_id": "428c31b6-7af4-4bcb-b7f5-5013ef9657c1",
    "call_session_id": "428c31b6-7af4-4bcb-b7f5-5013ef9657c1",
    "client_state": "aGF2ZSBhIG5pY2UgZGF5ID1d",
    "calling_party_type": "pstn",
    "insight_group_id": "428c31b6-abf3-3bc1-b7f4-5013ef9657c1",
    "results": [
      {
        "insight_id": "428c31b6-abf3-3bc1-b7f4-5013ef9657c1",
        "result": "The user inquired about the menu at Ember & Oak. The menu offers various options, including vegetarian, vegan, and gluten-free dishes, as well as a children's menu. The restaurant also has a daily happy hour from 4 PM to 6 PM and offers takeaway and delivery services. The user found the information helpful but had to leave without making any further decisions or requests. No specific preferences or goals were expressed beyond inquiring about the menu."
      }
    ]
  }
}

Response

200

The server must return an HTTP 200, otherwise we will reattempt delivery at the failover webhook URL.

Call conversation ended Call dtmf received

⌘I

AI

Real-Time Communications

WebRTC

Messaging

Identity

Storage & Data

Account & Billing

Other Products

SETI

OAuth

Call conversation insights generated

Authorizations

Headers

Body

Response