Export conversations
Export conversations. See the OpenAPI-defined parameters, request body, and responses below.
/Conversation/exportExport conversations. See the OpenAPI-defined parameters, request body, and responses below.
OpenAPI description: Este endpoint retorna todas as conversas que atendem ao filtro informado, com itens de checklist opcionais.
Authentication
Authentication required. Send your user API key in the X-API-Key header.
Parameters
This operation has no path, query, or header parameters.
Request body
Content type: application/json · Schema: ConversationExportFilterDto
| Property | Type | Required | Description | Constraints |
|---|---|---|---|---|
enableFilter | ConversationFilterEnable | No | — | — |
liveAgentFilter | ConversationFilterEnable | No | — | — |
callSuccessfulFilter | ConversationFilterEnable | No | — | — |
messageContent | string | No | — | nullable |
userIds | array<integer · int32> | No | — | nullable |
botIds | array<integer · int32> | No | — | nullable |
tagIds | array<integer · int32> | No | — | nullable |
from | string | No | — | nullable |
createdAtStart | string · date-time | No | — | — |
createdAtEnd | string · date-time | No | — | — |
finishedAt | string · date-time | No | — | nullable |
conversationFilterQueue | ConversationFilterQueueStatus | No | — | — |
integrationType | ConversationIntegrationType | No | — | — |
conversationEvaluationStatus | ConversationEvaluationStatus | No | — | — |
queueIds | array<integer · int32> | No | — | nullable |
conversationType | ConversationType | No | — | — |
userId | integer · int32 | No | — | — |
botId | integer · int32 | No | — | — |
tagId | integer · int32 | No | — | — |
id | integer · int32 | No | — | — |
title | string | No | — | nullable |
finalScoreFrom | integer · int32 | No | — | nullable |
finalScoreTo | integer · int32 | No | — | nullable |
includeChecklistItemConversations | boolean | No | — | — |
Example request
curl --request POST \
--url 'https://api.zild.ai/Conversation/export' \
--header 'X-API-Key: YOUR_USER_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"enableFilter": 0,
"liveAgentFilter": 0,
"callSuccessfulFilter": 0,
"messageContent": "string",
"userIds": [
0
],
"botIds": [
0
],
"tagIds": [
0
],
"from": "string",
"createdAtStart": "2026-09-22T18:00:00Z",
"createdAtEnd": "2026-09-22T18:00:00Z",
"finishedAt": "2026-09-22T18:00:00Z",
"conversationFilterQueue": 0,
"integrationType": 0,
"conversationEvaluationStatus": 0,
"queueIds": [
0
],
"conversationType": 0,
"userId": 0,
"botId": 0,
"tagId": 0,
"id": 0,
"title": "string",
"finalScoreFrom": 0,
"finalScoreTo": 0,
"includeChecklistItemConversations": true
}'
Responses
| Status | Description | Response body |
|---|---|---|
200 | OK | application/json · array<ConversationExportDto> |
Example response (200):
[
{
"conversation": {
"id": 0,
"active": true,
"title": "string",
"liveAgent": true,
"from": "string",
"conversationId": "string",
"waterMark": "string",
"token": "string",
"createdAt": "2026-09-22T18:00:00Z",
"finishedAt": "2026-09-22T18:00:00Z",
"queuedAt": "2026-09-22T18:00:00Z",
"lastConversationUpdateTime": "2026-09-22T18:00:00Z",
"lastMessageContent": "string",
"contactId": 0,
"contactName": "string",
"userId": 0,
"userName": "string",
"counterpartUserId": 0,
"counterpartUserName": "string",
"botId": 0,
"botName": "string",
"fileUrl": "string",
"fileName": "string",
"tenantId": 0,
"conversationSummary": "string",
"messages": [
{
"id": 0,
"createdAt": "2026-09-22T18:00:00Z",
"from": "string",
"to": "string",
"content": "string",
"conversationId": 0,
"sentiment": "string",
"offset": "string",
"isNPS": true,
"contentSid": "string",
"messageType": 0,
"conversationTemplateId": 0,
"mediaUrl": "string",
"mediaFileName": "string",
"tenantId": 0,
"userId": 0,
"contentVariables": "string",
"messageSid": "string",
"messageStatus": 0,
"sent": true,
"delivered": true,
"read": true,
"errorCode": "string",
"errorMessage": "string",
"isReadByUser": true,
"documentId": 0
}
],
"score": 0,
"finalScore": 0,
"checklistId": 0,
"communicationChannel": 0,
"conversationIntegrationType": 0,
"duration": "string",
"highImportanceErrorDetected": true,
"tags": [
{
"id": 0,
"name": "string",
"active": true,
"createdAt": "2026-09-22T18:00:00Z",
"tenantId": 0
}
],
"conversationEvaluationStatus": 0,
"conversationEvaluationStatusMessage": "string",
"queueId": 0,
"queueName": "string",
"conversationEndedReasonId": 0,
"agentType": 0,
"conversationType": 0,
"applicationStatusId": 0,
"overallSentiment": "string",
"callStatus": "string",
"disconnectionReason": "string",
"callSuccessful": true,
"totalUnreadedMessagesByUser": 0,
"dynamicVariables": [
{
"id": 0,
"name": "string",
"value": "string",
"conversationId": 0
}
],
"dataCollection": [
{
"id": 0,
"name": "string",
"value": "string",
"conversationId": 0
}
],
"agentId": 0,
"loadingResponse": true
},
"checklistItemConversations": [
{
"id": 0,
"checklistItemId": 0,
"checklistItemName": "string",
"approved": true,
"feedback": "string",
"score": 0,
"notApplicable": true,
"checklistEvaluationId": 0,
"conversationId": 0,
"tenantId": 0,
"highImportance": true,
"maxScore": 0,
"groupName": "string",
"groupId": 0
}
]
}
]
Data models
AgentType
0 = ZildAssist; 1 = ZildFlow; 2 = ZildInsightChat; 3 = ZildChat; 4 = ZildDocs; 5 = ZildVoice; 6 = ZildCoach; 7 = ZildInsightChecklist
integer
ChecklistItemConversationDto
| Property | Type | Required | Description | Constraints |
|---|---|---|---|---|
id | integer · int32 | No | — | — |
checklistItemId | integer · int32 | No | — | — |
checklistItemName | string | No | — | nullable |
approved | boolean | No | — | — |
feedback | string | No | — | nullable |
score | integer · int32 | No | — | — |
notApplicable | boolean | No | — | — |
checklistEvaluationId | integer · int32 | No | — | nullable |
conversationId | integer · int32 | No | — | — |
tenantId | integer · int32 | No | — | — |
highImportance | boolean | No | — | — |
maxScore | integer · int32 | No | — | — |
groupName | string | No | — | nullable |
groupId | integer · int32 | No | — | nullable |
CommunicationChannel
0 = Default; 1 = WhatsApp; 2 = Telefonia; 3 = Email; 4 = WebChat; 5 = InstagramDirectMessage; 6 = FacebookMessenger; 7 = MicrosoftTeams; 8 = ZildCoach
integer
ConversationDataCollectionDto
| Property | Type | Required | Description | Constraints |
|---|---|---|---|---|
id | integer · int32 | No | — | — |
name | string | No | — | nullable |
value | string | No | — | nullable |
conversationId | integer · int32 | No | — | — |
ConversationDto
| Property | Type | Required | Description | Constraints |
|---|---|---|---|---|
id | integer · int32 | No | — | — |
active | boolean | No | — | — |
title | string | No | — | nullable |
liveAgent | boolean | No | — | — |
from | string | No | — | nullable |
conversationId | string | No | — | nullable |
waterMark | string | No | — | nullable |
token | string | No | — | nullable |
createdAt | string · date-time | No | — | — |
finishedAt | string · date-time | No | — | nullable |
queuedAt | string · date-time | No | — | nullable |
lastConversationUpdateTime | string · date-time | No | — | — |
lastMessageContent | string | No | — | nullable |
contactId | integer · int32 | No | — | — |
contactName | string | No | — | nullable |
userId | integer · int32 | No | — | — |
userName | string | No | — | nullable |
counterpartUserId | integer · int32 | No | — | — |
counterpartUserName | string | No | — | nullable |
botId | integer · int32 | No | — | — |
botName | string | No | — | nullable |
fileUrl | string | No | — | nullable |
fileName | string | No | — | nullable |
tenantId | integer · int32 | No | — | — |
conversationSummary | string | No | — | nullable |
messages | array<MessageDto> | No | — | nullable |
score | integer · int32 | No | — | — |
finalScore | integer · int32 | No | — | — |
checklistId | integer · int32 | No | — | — |
communicationChannel | CommunicationChannel | No | — | — |
conversationIntegrationType | ConversationIntegrationType | No | — | — |
duration | string · date-span | No | — | nullable |
highImportanceErrorDetected | boolean | No | — | — |
tags | array<TagDto> | No | — | nullable |
conversationEvaluationStatus | ConversationEvaluationStatus | No | — | — |
conversationEvaluationStatusMessage | string | No | — | nullable |
queueId | integer · int32 | No | — | — |
queueName | string | No | — | nullable |
conversationEndedReasonId | integer · int32 | No | — | — |
agentType | AgentType | No | — | — |
conversationType | ConversationType | No | — | — |
applicationStatusId | integer · int32 | No | — | — |
overallSentiment | string | No | — | nullable |
callStatus | string | No | — | nullable |
disconnectionReason | string | No | — | nullable |
callSuccessful | boolean | No | — | — |
totalUnreadedMessagesByUser | integer · int32 | No | — | — |
dynamicVariables | array<ConversationDynamicVariableDto> | No | — | nullable |
dataCollection | array<ConversationDataCollectionDto> | No | — | nullable |
agentId | integer · int32 | No | — | — |
loadingResponse | boolean | No | — | — |
ConversationDynamicVariableDto
| Property | Type | Required | Description | Constraints |
|---|---|---|---|---|
id | integer · int32 | No | — | — |
name | string | No | — | nullable |
value | string | No | — | nullable |
conversationId | integer · int32 | No | — | — |
ConversationEvaluationStatus
0 = NotStarted; 1 = InProgress; 2 = Success; 3 = Error; 4 = Ineligible
integer
ConversationExportDto
| Property | Type | Required | Description | Constraints |
|---|---|---|---|---|
conversation | ConversationDto | No | — | — |
checklistItemConversations | array<ChecklistItemConversationDto> | No | — | nullable |
ConversationExportFilterDto
| Property | Type | Required | Description | Constraints |
|---|---|---|---|---|
enableFilter | ConversationFilterEnable | No | — | — |
liveAgentFilter | ConversationFilterEnable | No | — | — |
callSuccessfulFilter | ConversationFilterEnable | No | — | — |
messageContent | string | No | — | nullable |
userIds | array<integer · int32> | No | — | nullable |
botIds | array<integer · int32> | No | — | nullable |
tagIds | array<integer · int32> | No | — | nullable |
from | string | No | — | nullable |
createdAtStart | string · date-time | No | — | — |
createdAtEnd | string · date-time | No | — | — |
finishedAt | string · date-time | No | — | nullable |
conversationFilterQueue | ConversationFilterQueueStatus | No | — | — |
integrationType | ConversationIntegrationType | No | — | — |
conversationEvaluationStatus | ConversationEvaluationStatus | No | — | — |
queueIds | array<integer · int32> | No | — | nullable |
conversationType | ConversationType | No | — | — |
userId | integer · int32 | No | — | — |
botId | integer · int32 | No | — | — |
tagId | integer · int32 | No | — | — |
id | integer · int32 | No | — | — |
title | string | No | — | nullable |
finalScoreFrom | integer · int32 | No | — | nullable |
finalScoreTo | integer · int32 | No | — | nullable |
includeChecklistItemConversations | boolean | No | — | — |
ConversationFilterEnable
0 = All; 1 = Enable; 2 = Disable
integer
ConversationFilterQueueStatus
0 = All; 1 = InQueueWithoutDefinedUser; 2 = InQueueWithDefinedUser
integer
ConversationIntegrationType
0 = None; 1 = Olus; 2 = TotalIP; 3 = MicrosoftTeams; 4 = Fluctus; 5 = OpaSuite; 6 = ChatMix; 7 = MKBOOT; 8 = FocusChat; 9 = Tallos; 10 = SZFortics; 11 = James; 12 = MatrixGo; 13 = Twilio; 14 = Native; 15 = Internal; 16 = RetellAI; 17 = ElevenLabs; 18 = Email; 19 = WhatsAppApi; 20 = WebChat
integer
ConversationType
0 = ZildAssist; 1 = ZildInsight; 2 = AiSdrReactive; 3 = AiSdrProactive; 4 = AiHrInterview; 5 = ZildCoach; 6 = ZildVoice; 99 = Agent
integer
MessageDto
| Property | Type | Required | Description | Constraints |
|---|---|---|---|---|
id | integer · int32 | No | — | — |
createdAt | string · date-time | No | — | — |
from | string | No | — | nullable |
to | string | No | — | nullable |
content | string | No | — | nullable |
conversationId | integer · int32 | No | — | — |
sentiment | string | No | — | nullable |
offset | string | No | — | nullable |
isNPS | boolean | No | — | — |
contentSid | string | No | — | nullable |
messageType | MessageType | No | — | — |
conversationTemplateId | integer · int32 | No | — | — |
mediaUrl | string | No | — | nullable |
mediaFileName | string | No | — | nullable |
tenantId | integer · int32 | No | — | — |
userId | integer · int32 | No | — | — |
contentVariables | string | No | — | nullable |
messageSid | string | No | — | nullable |
messageStatus | MessageStatus | No | — | — |
sent | boolean | No | — | — |
delivered | boolean | No | — | — |
read | boolean | No | — | — |
errorCode | string | No | — | nullable |
errorMessage | string | No | — | nullable |
isReadByUser | boolean | No | — | — |
documentId | integer · int32 | No | — | nullable |
MessageStatus
0 = Queued; 1 = Sending; 2 = Sent; 3 = Delivered; 4 = Receiving; 5 = Received; 6 = Accepted; 7 = Scheduled; 8 = Read; 9 = Undelivered; 10 = Canceled; 11 = Failed
integer
MessageType
0 = Text; 1 = Image; 2 = File; 3 = Audio; 4 = Video; 5 = Internal; 6 = TemplateMarketing; 7 = TemplateUtility; 8 = Location; 9 = Contact
integer
TagDto
| Property | Type | Required | Description | Constraints |
|---|---|---|---|---|
id | integer · int32 | No | — | — |
name | string | No | — | nullable |
active | boolean | No | — | — |
createdAt | string · date-time | No | — | — |
tenantId | integer · int32 | No | — | — |