Hoppa till navigering

Textsök i konversationsmeddelanden

Sök bland meddelanden i konversationstranskriptioner med fulltextsökning och fuzzy-sökning

Headers

xi-api-keystringValfri

Frågeparametrar

text_querystringObligatorisk

Texten i sökfrågan för fulltextsökning och ungefärlig matchning

agent_idstring or nullValfri

Agent-ID (agent_…) eller externt ID för talmotor (seng_), som matchas mot samma underliggande resurs.

visited_agent_idslist of strings or nullValfri

Filtrera konversationer där någon av dessa agenter deltog. Får inte överstiga 50 värden.

visited_agent_branch_idslist of strings or nullValfri

Filtrera konversationer där någon av dessa agentgrenar deltog. Får inte överstiga 50 värden.

triggered_procedure_idslist of strings or nullValfri

Filtrera konversationer där någon av dessa procedurer utlöstes. Får inte överstiga 50 värden.

call_successfulenum or nullValfri

Resultatet av framgångsutvärderingen

Tillåtna värden:
call_start_before_unixinteger or nullValfri

Unix-tidsstämpel (i sekunder) för att filtrera samtal fram till detta startdatum.

call_start_after_unixinteger or nullValfri

Unix-tidsstämpel (i sekunder) för att filtrera samtal efter detta startdatum.

call_duration_min_secsinteger or nullValfri

Minsta samtalslängd i sekunder.

call_duration_max_secsinteger or nullValfri

Maximal samtalslängd i sekunder.

rating_maxinteger or nullValfri1-5

Högsta övergripande betyg (1–5).

rating_mininteger or nullValfri1-5

Minsta övergripande betyg (1–5).

has_feedback_commentboolean or nullValfri

Filtrera konversationer med kommentarer från användarfeedback.

user_idstring or nullValfri

Filtrera konversationer efter användar-ID:t för den som initierade dem.

evaluation_paramslist of strings or nullValfri

Utvärderingsfilter. Upprepad parameter. Format: criteria_id:result där result är något av success|failure|unknown. Exempel: eval=value_framing:success

data_collection_paramslist of strings or nullValfri

Filter för datainsamling. Upprepa parametern. Format: id:op:value, där op är något av eq|neq|gt|gte|lt|lte|in. För in avgränsar du värden med lodstreck. Ett tomt värde matchar konversationer där fältet inte samlades in (id:eq:), och neq med ett tomt värde matchar där det samlades in (id:neq:). eq innebär exakt likhet. gt|gte|lt|lte kräver ett numeriskt värde.

dynamic_variable_paramslist of strings or nullValfri

Filter för dynamiska variabler. Upprepa parametern. Format: name:op:value där op är ett av eq|neq|gt|gte|lt|lte|in. För in, avgränsa värden med lodstreck. Ett tomt värde matchar samtal där variabeln inte angavs (name:eq:), och neq med ett tomt värde matchar där den angavs (name:neq:). eq är exakt likhet. gt|gte|lt|lte kräver ett numeriskt värde. Namn som innehåller ':' kan inte uttryckas.

tool_nameslist of strings or nullValfri

Filtrera konversationer efter verktygsnamn som användes under samtalet.

tool_names_successfullist of strings or nullValfri
Filtrera konversationer efter verktygsnamn med lyckade anrop.
tool_names_erroredlist of strings or nullValfri
Filtrera konversationer efter verktygsnamn med felaktiga anrop.
include_invalid_tool_callsbooleanValfriStandard är false

Matcha även verktygsanrop som aldrig kördes.

main_languageslist of strings or nullValfri

Filtrera konversationer efter identifierat huvudspråk (språkkod).

exclude_statuseslist of enums or nullValfri

Uteslut samtal med de angivna statusarna. Användbart för att dölja pågående samtal / samtal under bearbetning från listvyer.

Tillåtna värden:
termination_reasonslist of strings or nullValfri

Filtrera konversationer efter deras lagrade termination_reason (metadata.termination_reason). Upprepa parametern för att matcha något av flera värden.

page_sizeintegerValfri1-50Standard är 20
Antal resultat per sida. Max 50.
summary_modeenumValfriStandard är exclude
Om transkriptionssammanfattningar ska inkluderas i svaret.
Tillåtna värden:
conversation_initiation_sourceenum or nullValfriStandard är unknown

Enum som representerar möjliga källor för att initiera samtal.

text_onlyboolean or nullValfri
conversation_product_typeenum or nullValfri

Begränsa resultaten till en enda produktvy för konversationer.

Tillåtna värden:
branch_idstring or nullValfri

Filtrera konversationer efter gren-ID.

version_idstring or nullValfri

Filtrera konversationer efter versions-ID.

topic_idslist of strings or nullValfri

Filtrera konversationer efter ämnes-ID:n som tilldelats vid ämnesidentifiering.

sort_byenumValfri

Sorteringsordning för sökresultat. 'search_score' sorterar efter sökpoäng, 'created_at' sorterar efter konversationens starttid.

Tillåtna värden:
cursorstring or nullValfri

Används för att hämta nästa sida. Markören returneras i svaret.

Svar

Lyckat svar
resultslist of objects
has_moreboolean

Om det finns fler tillgängliga resultat

metaobjectValfri
next_cursorstring or nullValfri

Markör för nästa resultatsida

Fel

422
Unprocessable Entity Error