retell-sdk 4.59.0 → 4.61.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,693 @@
1
+ import { APIResource } from "../resource.js";
2
+ import * as Core from "../core.js";
3
+ export declare class ChatAgent extends APIResource {
4
+ /**
5
+ * Create a new chat agent
6
+ *
7
+ * @example
8
+ * ```ts
9
+ * const chatAgentResponse = await client.chatAgent.create({
10
+ * response_engine: {
11
+ * llm_id: 'llm_234sdertfsdsfsdf',
12
+ * type: 'retell-llm',
13
+ * },
14
+ * });
15
+ * ```
16
+ */
17
+ create(body: ChatAgentCreateParams, options?: Core.RequestOptions): Core.APIPromise<ChatAgentResponse>;
18
+ /**
19
+ * Retrieve details of a specific chat agent
20
+ *
21
+ * @example
22
+ * ```ts
23
+ * const chatAgentResponse = await client.chatAgent.retrieve(
24
+ * '16b980523634a6dc504898cda492e939',
25
+ * );
26
+ * ```
27
+ */
28
+ retrieve(agentId: string, query?: ChatAgentRetrieveParams, options?: Core.RequestOptions): Core.APIPromise<ChatAgentResponse>;
29
+ retrieve(agentId: string, options?: Core.RequestOptions): Core.APIPromise<ChatAgentResponse>;
30
+ /**
31
+ * Update an existing chat agent
32
+ *
33
+ * @example
34
+ * ```ts
35
+ * const chatAgentResponse = await client.chatAgent.update(
36
+ * '16b980523634a6dc504898cda492e939',
37
+ * );
38
+ * ```
39
+ */
40
+ update(agentId: string, params: ChatAgentUpdateParams, options?: Core.RequestOptions): Core.APIPromise<ChatAgentResponse>;
41
+ /**
42
+ * List all chat agents
43
+ *
44
+ * @example
45
+ * ```ts
46
+ * const chatAgentResponses = await client.chatAgent.list();
47
+ * ```
48
+ */
49
+ list(query?: ChatAgentListParams, options?: Core.RequestOptions): Core.APIPromise<ChatAgentListResponse>;
50
+ list(options?: Core.RequestOptions): Core.APIPromise<ChatAgentListResponse>;
51
+ /**
52
+ * Delete an existing chat agent
53
+ *
54
+ * @example
55
+ * ```ts
56
+ * await client.chatAgent.delete(
57
+ * 'oBeDLoLOeuAbiuaMFXRtDOLriTJ5tSxD',
58
+ * );
59
+ * ```
60
+ */
61
+ delete(agentId: string, options?: Core.RequestOptions): Core.APIPromise<void>;
62
+ /**
63
+ * Get all versions of a chat agent
64
+ *
65
+ * @example
66
+ * ```ts
67
+ * const chatAgentResponses =
68
+ * await client.chatAgent.getVersions(
69
+ * '16b980523634a6dc504898cda492e939',
70
+ * );
71
+ * ```
72
+ */
73
+ getVersions(agentId: string, options?: Core.RequestOptions): Core.APIPromise<ChatAgentGetVersionsResponse>;
74
+ /**
75
+ * Publish the latest version of the chat agent and create a new draft chat agent
76
+ * with newer version.
77
+ *
78
+ * @example
79
+ * ```ts
80
+ * await client.chatAgent.publish(
81
+ * '16b980523634a6dc504898cda492e939',
82
+ * );
83
+ * ```
84
+ */
85
+ publish(agentId: string, options?: Core.RequestOptions): Core.APIPromise<void>;
86
+ }
87
+ export interface ChatAgentResponse {
88
+ /**
89
+ * Unique id of chat agent.
90
+ */
91
+ agent_id: string;
92
+ /**
93
+ * Last modification timestamp (milliseconds since epoch). Either the time of last
94
+ * update or creation if no updates available.
95
+ */
96
+ last_modification_timestamp: number;
97
+ /**
98
+ * The Response Engine to attach to the agent. It is used to generate responses for
99
+ * the agent. You need to create a Response Engine first before attaching it to an
100
+ * agent.
101
+ */
102
+ response_engine: ChatAgentResponse.ResponseEngineRetellLm | ChatAgentResponse.ResponseEngineCustomLm | ChatAgentResponse.ResponseEngineConversationFlow;
103
+ /**
104
+ * The name of the chat agent. Only used for your own reference.
105
+ */
106
+ agent_name?: string | null;
107
+ /**
108
+ * Message to display when the chat is automatically closed.
109
+ */
110
+ auto_close_message?: string | null;
111
+ /**
112
+ * Controls what data is stored for this agent. "everything" stores all data
113
+ * including transcripts and recordings. "everything_except_pii" stores data but
114
+ * excludes PII when possible based on PII configuration. "basic_attributes_only"
115
+ * stores only basic metadata. If not set, defaults to "everything".
116
+ */
117
+ data_storage_setting?: 'everything' | 'everything_except_pii' | 'basic_attributes_only' | null;
118
+ /**
119
+ * If users stay silent for a period after agent speech, end the chat. The minimum
120
+ * value allowed is 360,000 ms (0.1 hours). The maximum value allowed is
121
+ * 259,200,000 ms (72 hours). By default, this is set to 3,600,000 (1 hour).
122
+ */
123
+ end_chat_after_silence_ms?: number;
124
+ /**
125
+ * Whether the chat agent is published.
126
+ */
127
+ is_published?: boolean;
128
+ /**
129
+ * Specifies what language (and dialect) the chat will operate in. For instance,
130
+ * selecting `en-GB` optimizes for British English. If unset, will use default
131
+ * value `en-US`. Select `multi` for multilingual support, currently this supports
132
+ * Spanish and English.
133
+ */
134
+ language?: 'en-US' | 'en-IN' | 'en-GB' | 'en-AU' | 'en-NZ' | 'de-DE' | 'es-ES' | 'es-419' | 'hi-IN' | 'fr-FR' | 'fr-CA' | 'ja-JP' | 'pt-PT' | 'pt-BR' | 'zh-CN' | 'ru-RU' | 'it-IT' | 'ko-KR' | 'nl-NL' | 'nl-BE' | 'pl-PL' | 'tr-TR' | 'th-TH' | 'vi-VN' | 'ro-RO' | 'bg-BG' | 'ca-ES' | 'da-DK' | 'fi-FI' | 'el-GR' | 'hu-HU' | 'id-ID' | 'no-NO' | 'sk-SK' | 'sv-SE' | 'multi';
135
+ /**
136
+ * Whether this agent opts in to signed url for public log. If not set, default
137
+ * value of false will apply.
138
+ */
139
+ opt_in_signed_url?: boolean;
140
+ /**
141
+ * Configuration for PII scrubbing from transcripts and recordings.
142
+ */
143
+ pii_config?: ChatAgentResponse.PiiConfig;
144
+ /**
145
+ * Post chat analysis data to extract from the chat. This data will augment the
146
+ * pre-defined variables extracted in the chat analysis. This will be available
147
+ * after the chat ends.
148
+ */
149
+ post_chat_analysis_data?: Array<ChatAgentResponse.StringAnalysisData | ChatAgentResponse.EnumAnalysisData | ChatAgentResponse.BooleanAnalysisData | ChatAgentResponse.NumberAnalysisData> | null;
150
+ /**
151
+ * The model to use for post chat analysis. Default to gpt-4.1-mini.
152
+ */
153
+ post_chat_analysis_model?: 'gpt-4o' | 'gpt-4o-mini' | 'gpt-4.1' | 'gpt-4.1-mini' | 'gpt-4.1-nano' | 'gpt-5' | 'gpt-5.1' | 'gpt-5-mini' | 'gpt-5-nano' | 'claude-4.5-sonnet' | 'claude-4.0-sonnet' | 'claude-3.7-sonnet' | 'claude-3.5-haiku' | 'gemini-2.0-flash' | 'gemini-2.0-flash-lite' | 'gemini-2.5-flash' | 'gemini-2.5-flash-lite';
154
+ /**
155
+ * The version of the chat agent.
156
+ */
157
+ version?: number;
158
+ /**
159
+ * The timeout for the webhook in milliseconds. If not set, default value of 10000
160
+ * will apply.
161
+ */
162
+ webhook_timeout_ms?: number;
163
+ /**
164
+ * The webhook for agent to listen to chat events. See what events it would get at
165
+ * [webhook doc](/features/webhook). If set, will binds webhook events for this
166
+ * agent to the specified url, and will ignore the account level webhook for this
167
+ * agent. Set to `null` to remove webhook url from this agent.
168
+ */
169
+ webhook_url?: string | null;
170
+ }
171
+ export declare namespace ChatAgentResponse {
172
+ interface ResponseEngineRetellLm {
173
+ /**
174
+ * id of the Retell LLM Response Engine.
175
+ */
176
+ llm_id: string;
177
+ /**
178
+ * type of the Response Engine.
179
+ */
180
+ type: 'retell-llm';
181
+ /**
182
+ * Version of the Retell LLM Response Engine.
183
+ */
184
+ version?: number | null;
185
+ }
186
+ interface ResponseEngineCustomLm {
187
+ /**
188
+ * LLM websocket url of the custom LLM.
189
+ */
190
+ llm_websocket_url: string;
191
+ /**
192
+ * type of the Response Engine.
193
+ */
194
+ type: 'custom-llm';
195
+ }
196
+ interface ResponseEngineConversationFlow {
197
+ /**
198
+ * ID of the Conversation Flow Response Engine.
199
+ */
200
+ conversation_flow_id: string;
201
+ /**
202
+ * type of the Response Engine.
203
+ */
204
+ type: 'conversation-flow';
205
+ /**
206
+ * Version of the Conversation Flow Response Engine.
207
+ */
208
+ version?: number | null;
209
+ }
210
+ /**
211
+ * Configuration for PII scrubbing from transcripts and recordings.
212
+ */
213
+ interface PiiConfig {
214
+ /**
215
+ * List of PII categories to scrub from transcripts and recordings.
216
+ */
217
+ categories: Array<'person_name' | 'address' | 'email' | 'phone_number' | 'ssn' | 'passport' | 'driver_license' | 'credit_card' | 'bank_account' | 'password' | 'pin' | 'medical_id' | 'date_of_birth'>;
218
+ /**
219
+ * The processing mode for PII scrubbing. Currently only post-call is supported.
220
+ */
221
+ mode: 'post_call';
222
+ }
223
+ interface StringAnalysisData {
224
+ /**
225
+ * Description of the variable.
226
+ */
227
+ description: string;
228
+ /**
229
+ * Name of the variable.
230
+ */
231
+ name: string;
232
+ /**
233
+ * Type of the variable to extract.
234
+ */
235
+ type: 'string';
236
+ /**
237
+ * Examples of the variable value to teach model the style and syntax.
238
+ */
239
+ examples?: Array<string>;
240
+ }
241
+ interface EnumAnalysisData {
242
+ /**
243
+ * The possible values of the variable, must be non empty array.
244
+ */
245
+ choices: Array<string>;
246
+ /**
247
+ * Description of the variable.
248
+ */
249
+ description: string;
250
+ /**
251
+ * Name of the variable.
252
+ */
253
+ name: string;
254
+ /**
255
+ * Type of the variable to extract.
256
+ */
257
+ type: 'enum';
258
+ }
259
+ interface BooleanAnalysisData {
260
+ /**
261
+ * Description of the variable.
262
+ */
263
+ description: string;
264
+ /**
265
+ * Name of the variable.
266
+ */
267
+ name: string;
268
+ /**
269
+ * Type of the variable to extract.
270
+ */
271
+ type: 'boolean';
272
+ }
273
+ interface NumberAnalysisData {
274
+ /**
275
+ * Description of the variable.
276
+ */
277
+ description: string;
278
+ /**
279
+ * Name of the variable.
280
+ */
281
+ name: string;
282
+ /**
283
+ * Type of the variable to extract.
284
+ */
285
+ type: 'number';
286
+ }
287
+ }
288
+ export type ChatAgentListResponse = Array<ChatAgentResponse>;
289
+ export type ChatAgentGetVersionsResponse = Array<ChatAgentResponse>;
290
+ export interface ChatAgentCreateParams {
291
+ /**
292
+ * The Response Engine to attach to the agent. It is used to generate responses for
293
+ * the agent. You need to create a Response Engine first before attaching it to an
294
+ * agent.
295
+ */
296
+ response_engine: ChatAgentCreateParams.ResponseEngineRetellLm | ChatAgentCreateParams.ResponseEngineCustomLm | ChatAgentCreateParams.ResponseEngineConversationFlow;
297
+ /**
298
+ * The name of the chat agent. Only used for your own reference.
299
+ */
300
+ agent_name?: string | null;
301
+ /**
302
+ * Message to display when the chat is automatically closed.
303
+ */
304
+ auto_close_message?: string | null;
305
+ /**
306
+ * Controls what data is stored for this agent. "everything" stores all data
307
+ * including transcripts and recordings. "everything_except_pii" stores data but
308
+ * excludes PII when possible based on PII configuration. "basic_attributes_only"
309
+ * stores only basic metadata. If not set, defaults to "everything".
310
+ */
311
+ data_storage_setting?: 'everything' | 'everything_except_pii' | 'basic_attributes_only' | null;
312
+ /**
313
+ * If users stay silent for a period after agent speech, end the chat. The minimum
314
+ * value allowed is 360,000 ms (0.1 hours). The maximum value allowed is
315
+ * 259,200,000 ms (72 hours). By default, this is set to 3,600,000 (1 hour).
316
+ */
317
+ end_chat_after_silence_ms?: number;
318
+ /**
319
+ * Specifies what language (and dialect) the chat will operate in. For instance,
320
+ * selecting `en-GB` optimizes for British English. If unset, will use default
321
+ * value `en-US`. Select `multi` for multilingual support, currently this supports
322
+ * Spanish and English.
323
+ */
324
+ language?: 'en-US' | 'en-IN' | 'en-GB' | 'en-AU' | 'en-NZ' | 'de-DE' | 'es-ES' | 'es-419' | 'hi-IN' | 'fr-FR' | 'fr-CA' | 'ja-JP' | 'pt-PT' | 'pt-BR' | 'zh-CN' | 'ru-RU' | 'it-IT' | 'ko-KR' | 'nl-NL' | 'nl-BE' | 'pl-PL' | 'tr-TR' | 'th-TH' | 'vi-VN' | 'ro-RO' | 'bg-BG' | 'ca-ES' | 'da-DK' | 'fi-FI' | 'el-GR' | 'hu-HU' | 'id-ID' | 'no-NO' | 'sk-SK' | 'sv-SE' | 'multi';
325
+ /**
326
+ * Whether this agent opts in to signed url for public log. If not set, default
327
+ * value of false will apply.
328
+ */
329
+ opt_in_signed_url?: boolean;
330
+ /**
331
+ * Configuration for PII scrubbing from transcripts and recordings.
332
+ */
333
+ pii_config?: ChatAgentCreateParams.PiiConfig;
334
+ /**
335
+ * Post chat analysis data to extract from the chat. This data will augment the
336
+ * pre-defined variables extracted in the chat analysis. This will be available
337
+ * after the chat ends.
338
+ */
339
+ post_chat_analysis_data?: Array<ChatAgentCreateParams.StringAnalysisData | ChatAgentCreateParams.EnumAnalysisData | ChatAgentCreateParams.BooleanAnalysisData | ChatAgentCreateParams.NumberAnalysisData> | null;
340
+ /**
341
+ * The model to use for post chat analysis. Default to gpt-4.1-mini.
342
+ */
343
+ post_chat_analysis_model?: 'gpt-4o' | 'gpt-4o-mini' | 'gpt-4.1' | 'gpt-4.1-mini' | 'gpt-4.1-nano' | 'gpt-5' | 'gpt-5.1' | 'gpt-5-mini' | 'gpt-5-nano' | 'claude-4.5-sonnet' | 'claude-4.0-sonnet' | 'claude-3.7-sonnet' | 'claude-3.5-haiku' | 'gemini-2.0-flash' | 'gemini-2.0-flash-lite' | 'gemini-2.5-flash' | 'gemini-2.5-flash-lite';
344
+ /**
345
+ * The timeout for the webhook in milliseconds. If not set, default value of 10000
346
+ * will apply.
347
+ */
348
+ webhook_timeout_ms?: number;
349
+ /**
350
+ * The webhook for agent to listen to chat events. See what events it would get at
351
+ * [webhook doc](/features/webhook). If set, will binds webhook events for this
352
+ * agent to the specified url, and will ignore the account level webhook for this
353
+ * agent. Set to `null` to remove webhook url from this agent.
354
+ */
355
+ webhook_url?: string | null;
356
+ }
357
+ export declare namespace ChatAgentCreateParams {
358
+ interface ResponseEngineRetellLm {
359
+ /**
360
+ * id of the Retell LLM Response Engine.
361
+ */
362
+ llm_id: string;
363
+ /**
364
+ * type of the Response Engine.
365
+ */
366
+ type: 'retell-llm';
367
+ /**
368
+ * Version of the Retell LLM Response Engine.
369
+ */
370
+ version?: number | null;
371
+ }
372
+ interface ResponseEngineCustomLm {
373
+ /**
374
+ * LLM websocket url of the custom LLM.
375
+ */
376
+ llm_websocket_url: string;
377
+ /**
378
+ * type of the Response Engine.
379
+ */
380
+ type: 'custom-llm';
381
+ }
382
+ interface ResponseEngineConversationFlow {
383
+ /**
384
+ * ID of the Conversation Flow Response Engine.
385
+ */
386
+ conversation_flow_id: string;
387
+ /**
388
+ * type of the Response Engine.
389
+ */
390
+ type: 'conversation-flow';
391
+ /**
392
+ * Version of the Conversation Flow Response Engine.
393
+ */
394
+ version?: number | null;
395
+ }
396
+ /**
397
+ * Configuration for PII scrubbing from transcripts and recordings.
398
+ */
399
+ interface PiiConfig {
400
+ /**
401
+ * List of PII categories to scrub from transcripts and recordings.
402
+ */
403
+ categories: Array<'person_name' | 'address' | 'email' | 'phone_number' | 'ssn' | 'passport' | 'driver_license' | 'credit_card' | 'bank_account' | 'password' | 'pin' | 'medical_id' | 'date_of_birth'>;
404
+ /**
405
+ * The processing mode for PII scrubbing. Currently only post-call is supported.
406
+ */
407
+ mode: 'post_call';
408
+ }
409
+ interface StringAnalysisData {
410
+ /**
411
+ * Description of the variable.
412
+ */
413
+ description: string;
414
+ /**
415
+ * Name of the variable.
416
+ */
417
+ name: string;
418
+ /**
419
+ * Type of the variable to extract.
420
+ */
421
+ type: 'string';
422
+ /**
423
+ * Examples of the variable value to teach model the style and syntax.
424
+ */
425
+ examples?: Array<string>;
426
+ }
427
+ interface EnumAnalysisData {
428
+ /**
429
+ * The possible values of the variable, must be non empty array.
430
+ */
431
+ choices: Array<string>;
432
+ /**
433
+ * Description of the variable.
434
+ */
435
+ description: string;
436
+ /**
437
+ * Name of the variable.
438
+ */
439
+ name: string;
440
+ /**
441
+ * Type of the variable to extract.
442
+ */
443
+ type: 'enum';
444
+ }
445
+ interface BooleanAnalysisData {
446
+ /**
447
+ * Description of the variable.
448
+ */
449
+ description: string;
450
+ /**
451
+ * Name of the variable.
452
+ */
453
+ name: string;
454
+ /**
455
+ * Type of the variable to extract.
456
+ */
457
+ type: 'boolean';
458
+ }
459
+ interface NumberAnalysisData {
460
+ /**
461
+ * Description of the variable.
462
+ */
463
+ description: string;
464
+ /**
465
+ * Name of the variable.
466
+ */
467
+ name: string;
468
+ /**
469
+ * Type of the variable to extract.
470
+ */
471
+ type: 'number';
472
+ }
473
+ }
474
+ export interface ChatAgentRetrieveParams {
475
+ /**
476
+ * Optional version of the API to use for this request. If not provided, will
477
+ * default to latest version.
478
+ */
479
+ version?: number;
480
+ }
481
+ export interface ChatAgentUpdateParams {
482
+ /**
483
+ * Query param: Optional version of the API to use for this request. Default to
484
+ * latest version.
485
+ */
486
+ version?: number;
487
+ /**
488
+ * Body param: The name of the chat agent. Only used for your own reference.
489
+ */
490
+ agent_name?: string | null;
491
+ /**
492
+ * Body param: Message to display when the chat is automatically closed.
493
+ */
494
+ auto_close_message?: string | null;
495
+ /**
496
+ * Body param: Controls what data is stored for this agent. "everything" stores all
497
+ * data including transcripts and recordings. "everything_except_pii" stores data
498
+ * but excludes PII when possible based on PII configuration.
499
+ * "basic_attributes_only" stores only basic metadata. If not set, defaults to
500
+ * "everything".
501
+ */
502
+ data_storage_setting?: 'everything' | 'everything_except_pii' | 'basic_attributes_only' | null;
503
+ /**
504
+ * Body param: If users stay silent for a period after agent speech, end the chat.
505
+ * The minimum value allowed is 360,000 ms (0.1 hours). The maximum value allowed
506
+ * is 259,200,000 ms (72 hours). By default, this is set to 3,600,000 (1 hour).
507
+ */
508
+ end_chat_after_silence_ms?: number;
509
+ /**
510
+ * Body param: Specifies what language (and dialect) the chat will operate in. For
511
+ * instance, selecting `en-GB` optimizes for British English. If unset, will use
512
+ * default value `en-US`. Select `multi` for multilingual support, currently this
513
+ * supports Spanish and English.
514
+ */
515
+ language?: 'en-US' | 'en-IN' | 'en-GB' | 'en-AU' | 'en-NZ' | 'de-DE' | 'es-ES' | 'es-419' | 'hi-IN' | 'fr-FR' | 'fr-CA' | 'ja-JP' | 'pt-PT' | 'pt-BR' | 'zh-CN' | 'ru-RU' | 'it-IT' | 'ko-KR' | 'nl-NL' | 'nl-BE' | 'pl-PL' | 'tr-TR' | 'th-TH' | 'vi-VN' | 'ro-RO' | 'bg-BG' | 'ca-ES' | 'da-DK' | 'fi-FI' | 'el-GR' | 'hu-HU' | 'id-ID' | 'no-NO' | 'sk-SK' | 'sv-SE' | 'multi';
516
+ /**
517
+ * Body param: Whether this agent opts in to signed url for public log. If not set,
518
+ * default value of false will apply.
519
+ */
520
+ opt_in_signed_url?: boolean;
521
+ /**
522
+ * Body param: Configuration for PII scrubbing from transcripts and recordings.
523
+ */
524
+ pii_config?: ChatAgentUpdateParams.PiiConfig;
525
+ /**
526
+ * Body param: Post chat analysis data to extract from the chat. This data will
527
+ * augment the pre-defined variables extracted in the chat analysis. This will be
528
+ * available after the chat ends.
529
+ */
530
+ post_chat_analysis_data?: Array<ChatAgentUpdateParams.StringAnalysisData | ChatAgentUpdateParams.EnumAnalysisData | ChatAgentUpdateParams.BooleanAnalysisData | ChatAgentUpdateParams.NumberAnalysisData> | null;
531
+ /**
532
+ * Body param: The model to use for post chat analysis. Default to gpt-4.1-mini.
533
+ */
534
+ post_chat_analysis_model?: 'gpt-4o' | 'gpt-4o-mini' | 'gpt-4.1' | 'gpt-4.1-mini' | 'gpt-4.1-nano' | 'gpt-5' | 'gpt-5.1' | 'gpt-5-mini' | 'gpt-5-nano' | 'claude-4.5-sonnet' | 'claude-4.0-sonnet' | 'claude-3.7-sonnet' | 'claude-3.5-haiku' | 'gemini-2.0-flash' | 'gemini-2.0-flash-lite' | 'gemini-2.5-flash' | 'gemini-2.5-flash-lite';
535
+ /**
536
+ * Body param: The Response Engine to attach to the agent. It is used to generate
537
+ * responses for the agent. You need to create a Response Engine first before
538
+ * attaching it to an agent.
539
+ */
540
+ response_engine?: ChatAgentUpdateParams.ResponseEngineRetellLm | ChatAgentUpdateParams.ResponseEngineCustomLm | ChatAgentUpdateParams.ResponseEngineConversationFlow;
541
+ /**
542
+ * Body param: The timeout for the webhook in milliseconds. If not set, default
543
+ * value of 10000 will apply.
544
+ */
545
+ webhook_timeout_ms?: number;
546
+ /**
547
+ * Body param: The webhook for agent to listen to chat events. See what events it
548
+ * would get at [webhook doc](/features/webhook). If set, will binds webhook events
549
+ * for this agent to the specified url, and will ignore the account level webhook
550
+ * for this agent. Set to `null` to remove webhook url from this agent.
551
+ */
552
+ webhook_url?: string | null;
553
+ }
554
+ export declare namespace ChatAgentUpdateParams {
555
+ /**
556
+ * Configuration for PII scrubbing from transcripts and recordings.
557
+ */
558
+ interface PiiConfig {
559
+ /**
560
+ * List of PII categories to scrub from transcripts and recordings.
561
+ */
562
+ categories: Array<'person_name' | 'address' | 'email' | 'phone_number' | 'ssn' | 'passport' | 'driver_license' | 'credit_card' | 'bank_account' | 'password' | 'pin' | 'medical_id' | 'date_of_birth'>;
563
+ /**
564
+ * The processing mode for PII scrubbing. Currently only post-call is supported.
565
+ */
566
+ mode: 'post_call';
567
+ }
568
+ interface StringAnalysisData {
569
+ /**
570
+ * Description of the variable.
571
+ */
572
+ description: string;
573
+ /**
574
+ * Name of the variable.
575
+ */
576
+ name: string;
577
+ /**
578
+ * Type of the variable to extract.
579
+ */
580
+ type: 'string';
581
+ /**
582
+ * Examples of the variable value to teach model the style and syntax.
583
+ */
584
+ examples?: Array<string>;
585
+ }
586
+ interface EnumAnalysisData {
587
+ /**
588
+ * The possible values of the variable, must be non empty array.
589
+ */
590
+ choices: Array<string>;
591
+ /**
592
+ * Description of the variable.
593
+ */
594
+ description: string;
595
+ /**
596
+ * Name of the variable.
597
+ */
598
+ name: string;
599
+ /**
600
+ * Type of the variable to extract.
601
+ */
602
+ type: 'enum';
603
+ }
604
+ interface BooleanAnalysisData {
605
+ /**
606
+ * Description of the variable.
607
+ */
608
+ description: string;
609
+ /**
610
+ * Name of the variable.
611
+ */
612
+ name: string;
613
+ /**
614
+ * Type of the variable to extract.
615
+ */
616
+ type: 'boolean';
617
+ }
618
+ interface NumberAnalysisData {
619
+ /**
620
+ * Description of the variable.
621
+ */
622
+ description: string;
623
+ /**
624
+ * Name of the variable.
625
+ */
626
+ name: string;
627
+ /**
628
+ * Type of the variable to extract.
629
+ */
630
+ type: 'number';
631
+ }
632
+ interface ResponseEngineRetellLm {
633
+ /**
634
+ * id of the Retell LLM Response Engine.
635
+ */
636
+ llm_id: string;
637
+ /**
638
+ * type of the Response Engine.
639
+ */
640
+ type: 'retell-llm';
641
+ /**
642
+ * Version of the Retell LLM Response Engine.
643
+ */
644
+ version?: number | null;
645
+ }
646
+ interface ResponseEngineCustomLm {
647
+ /**
648
+ * LLM websocket url of the custom LLM.
649
+ */
650
+ llm_websocket_url: string;
651
+ /**
652
+ * type of the Response Engine.
653
+ */
654
+ type: 'custom-llm';
655
+ }
656
+ interface ResponseEngineConversationFlow {
657
+ /**
658
+ * ID of the Conversation Flow Response Engine.
659
+ */
660
+ conversation_flow_id: string;
661
+ /**
662
+ * type of the Response Engine.
663
+ */
664
+ type: 'conversation-flow';
665
+ /**
666
+ * Version of the Conversation Flow Response Engine.
667
+ */
668
+ version?: number | null;
669
+ }
670
+ }
671
+ export interface ChatAgentListParams {
672
+ /**
673
+ * A limit on the number of objects to be returned. Limit can range between 1 and
674
+ * 1000, and the default is 1000.
675
+ */
676
+ limit?: number;
677
+ /**
678
+ * The pagination key to continue fetching the next page of agents. Pagination key
679
+ * is represented by a agent id, pagination key and version pair is exclusive (not
680
+ * included in the fetched page). If not set, will start from the beginning.
681
+ */
682
+ pagination_key?: string;
683
+ /**
684
+ * Specifies the version of the agent associated with the pagination_key. When
685
+ * paginating, both the pagination_key and its version must be provided to ensure
686
+ * consistent ordering and to fetch the next page correctly.
687
+ */
688
+ pagination_key_version?: number;
689
+ }
690
+ export declare namespace ChatAgent {
691
+ export { type ChatAgentResponse as ChatAgentResponse, type ChatAgentListResponse as ChatAgentListResponse, type ChatAgentGetVersionsResponse as ChatAgentGetVersionsResponse, type ChatAgentCreateParams as ChatAgentCreateParams, type ChatAgentRetrieveParams as ChatAgentRetrieveParams, type ChatAgentUpdateParams as ChatAgentUpdateParams, type ChatAgentListParams as ChatAgentListParams, };
692
+ }
693
+ //# sourceMappingURL=chat-agent.d.ts.map