retell-sdk 5.64.0 → 5.65.0

package/src/resources/contact.ts

@@ -2,8 +2,10 @@
 
 import { APIResource } from '../core/resource';
 import { APIPromise } from '../core/api-promise';
+import { type Uploadable } from '../core/uploads';
 import { buildHeaders } from '../internal/headers';
 import { RequestOptions } from '../internal/request-options';
+import { multipartFormRequestOptions } from '../internal/uploads';
 import { path } from '../internal/utils/path';
 
 export class Contact extends APIResource {
@@ -61,6 +63,19 @@ export class Contact extends APIResource {
     return this._client.post('/backfill-contact-analysis-data', { body, ...options });
   }
 
+  /**
+   * Start an incremental contact import from an uploaded CSV: creates new contacts
+   * and updates existing ones matched by phone number. Mapped columns overwrite the
+   * matched contact's fields; unmapped columns are ignored. Runs asynchronously —
+   * poll get-contact-import for progress.
+   */
+  createImport(
+    body: ContactCreateImportParams,
+    options?: RequestOptions,
+  ): APIPromise<ContactCreateImportResponse> {
+    return this._client.post('/create-contact-import', { body, ...options });
+  }
+
   /**
    * Retrieve a contact by ID.
    */
@@ -83,6 +98,13 @@ export class Contact extends APIResource {
     return this._client.get(path`/get-contact-by-phone/${phoneNumber}`, options);
   }
 
+  /**
+   * Status and counts for the org's current or latest contact import.
+   */
+  getImport(options?: RequestOptions): APIPromise<ContactGetImportResponse> {
+    return this._client.get('/get-contact-import', options);
+  }
+
   /**
    * List a contact's conversations (inbound calls, outbound calls, and chats) merged
    * into a single timeline, most recent first. Results are matched by the contact's
@@ -95,6 +117,20 @@ export class Contact extends APIResource {
   ): APIPromise<ContactListConversationsResponse> {
     return this._client.get(path`/list-contact-conversations/${contactID}`, { query, ...options });
   }
+
+  /**
+   * Upload a CSV file for a contact import. The file is stored privately and
+   * referenced by the returned upload_id in create-contact-import.
+   */
+  uploadImportFile(
+    body: ContactUploadImportFileParams,
+    options?: RequestOptions,
+  ): APIPromise<ContactUploadImportFileResponse> {
+    return this._client.post(
+      '/upload-contact-import-file',
+      multipartFormRequestOptions({ body, ...options }, this._client),
+    );
+  }
 }
 
 export interface ContactResponse {
@@ -153,6 +189,11 @@ export interface ContactResponse {
    */
   last_name?: string;
 
+  /**
+   * Tags assigned to the contact.
+   */
+  tags?: Array<string>;
+
   /**
    * Epoch milliseconds when the contact was last modified.
    */
@@ -160,12 +201,15 @@ export interface ContactResponse {
 }
 
 export interface ContactListResponse {
-  has_more?: boolean;
+  /**
+   * Whether more results are available.
+   */
+  has_more: boolean;
 
-  items?: Array<ContactResponse>;
+  items: Array<ContactResponse>;
 
   /**
-   * Base64url-encoded pagination key for the next page.
+   * Pagination key for the next page.
    */
   pagination_key?: string;
 
@@ -200,6 +244,31 @@ export interface ContactBackfillAnalysisDataResponse {
   triggered_by?: 'manual' | 'cron';
 }
 
+export interface ContactCreateImportResponse {
+  status: 'queued' | 'running' | 'idle';
+
+  /**
+   * Number of items that errored so far.
+   */
+  failed?: number;
+
+  /**
+   * Epoch milliseconds when the job started.
+   */
+  start_timestamp?: number;
+
+  /**
+   * Number of items processed successfully so far.
+   */
+  succeeded?: number;
+
+  /**
+   * Whether the job was started by an explicit API call (`manual`) or by the
+   * scheduled sync (`cron`).
+   */
+  triggered_by?: 'manual' | 'cron';
+}
+
 export interface ContactGetBackfillJobStatusResponse {
   status: 'queued' | 'running' | 'idle';
 
@@ -225,17 +294,41 @@ export interface ContactGetBackfillJobStatusResponse {
   triggered_by?: 'manual' | 'cron';
 }
 
+export interface ContactGetImportResponse {
+  status: 'queued' | 'running' | 'idle';
+
+  /**
+   * Number of items that errored so far.
+   */
+  failed?: number;
+
+  /**
+   * Epoch milliseconds when the job started.
+   */
+  start_timestamp?: number;
+
+  /**
+   * Number of items processed successfully so far.
+   */
+  succeeded?: number;
+
+  /**
+   * Whether the job was started by an explicit API call (`manual`) or by the
+   * scheduled sync (`cron`).
+   */
+  triggered_by?: 'manual' | 'cron';
+}
+
 export interface ContactListConversationsResponse {
   /**
-   * Whether more conversations exist beyond the returned window.
+   * Whether more results are available.
    */
-  has_more?: boolean;
+  has_more: boolean;
 
-  items?: Array<ContactListConversationsResponse.ContactCall | ContactListConversationsResponse.ContactChat>;
+  items: Array<ContactListConversationsResponse.ContactCall | ContactListConversationsResponse.ContactChat>;
 
   /**
-   * Base64url-encoded pagination key. Pass as `pagination_key` query parameter to
-   * fetch the next page.
+   * Pagination key for the next page.
    */
   pagination_key?: string;
 }
@@ -324,6 +417,12 @@ export namespace ContactListConversationsResponse {
   }
 }
 
+export interface ContactUploadImportFileResponse {
+  file_name?: string;
+
+  upload_id?: string;
+}
+
 export interface ContactCreateParams {
   /**
    * Phone number of the contact.
@@ -347,6 +446,11 @@ export interface ContactCreateParams {
    * Last name of the contact.
    */
   last_name?: string;
+
+  /**
+   * Full set of tags for the contact.
+   */
+  tags?: Array<string>;
 }
 
 export interface ContactUpdateParams {
@@ -367,6 +471,11 @@ export interface ContactUpdateParams {
    * Last name of the contact.
    */
   last_name?: string;
+
+  /**
+   * Full replacement set of tags for the contact.
+   */
+  tags?: Array<string>;
 }
 
 export interface ContactListParams {
@@ -448,6 +557,11 @@ export namespace ContactListParams {
      * number.
      */
     phone_number?: FilterCriteria.PhoneNumber;
+
+    /**
+     * Match contacts that have any of the listed tags.
+     */
+    tags?: FilterCriteria.Tags;
   }
 
   export namespace FilterCriteria {
@@ -628,6 +742,20 @@ export namespace ContactListParams {
 
       value: string;
     }
+
+    /**
+     * Match contacts that have any of the listed tags.
+     */
+    export interface Tags {
+      /**
+       * in: value is one of the listed values
+       */
+      op: 'in';
+
+      type: 'enum';
+
+      value: Array<string>;
+    }
   }
 }
 
@@ -671,7 +799,7 @@ export namespace ContactBackfillAnalysisDataParams {
       agent_id: string;
 
       /**
-       * Specific versions to filter on. If not provided, all versions are included.
+       * Specific versions to filter on. If omitted or empty, all versions are included.
        */
       version?: Array<number>;
     }
@@ -704,6 +832,47 @@ export namespace ContactBackfillAnalysisDataParams {
   }
 }
 
+export interface ContactCreateImportParams {
+  /**
+   * CSV headers mapped to contact fields. field_name is the contact field and
+   * external_field_name is the CSV header. Exactly one mapping must target
+   * phone_number. Unmapped columns are ignored.
+   */
+  column_mapping: Array<ContactCreateImportParams.ColumnMapping>;
+
+  /**
+   * Id returned by upload-contact-import-file.
+   */
+  upload_id: string;
+
+  /**
+   * Country for parsing phone numbers without a country code. Defaults to US.
+   */
+  default_country?: string;
+
+  /**
+   * Tags added to every contact in this import. Existing tags are preserved. Omit to
+   * leave tags unchanged.
+   */
+  tags?: Array<string>;
+}
+
+export namespace ContactCreateImportParams {
+  export interface ColumnMapping {
+    /**
+     * Field on the CRM's contact object to map to. A name that does not exist there
+     * surfaces as an error on the sync job rather than at configuration time.
+     */
+    external_field_name: string;
+
+    /**
+     * Retell contact field, built-in or custom, to map. Types must be compatible with
+     * the CRM field on both sides of the sync.
+     */
+    field_name: string;
+  }
+}
+
 export interface ContactListConversationsParams {
   /**
    * Maximum number of items to return.
@@ -716,17 +885,26 @@ export interface ContactListConversationsParams {
   pagination_key?: string;
 }
 
+export interface ContactUploadImportFileParams {
+  file: Uploadable;
+}
+
 export declare namespace Contact {
   export {
     type ContactResponse as ContactResponse,
     type ContactListResponse as ContactListResponse,
     type ContactBackfillAnalysisDataResponse as ContactBackfillAnalysisDataResponse,
+    type ContactCreateImportResponse as ContactCreateImportResponse,
     type ContactGetBackfillJobStatusResponse as ContactGetBackfillJobStatusResponse,
+    type ContactGetImportResponse as ContactGetImportResponse,
     type ContactListConversationsResponse as ContactListConversationsResponse,
+    type ContactUploadImportFileResponse as ContactUploadImportFileResponse,
     type ContactCreateParams as ContactCreateParams,
     type ContactUpdateParams as ContactUpdateParams,
     type ContactListParams as ContactListParams,
     type ContactBackfillAnalysisDataParams as ContactBackfillAnalysisDataParams,
+    type ContactCreateImportParams as ContactCreateImportParams,
     type ContactListConversationsParams as ContactListConversationsParams,
+    type ContactUploadImportFileParams as ContactUploadImportFileParams,
   };
 }

package/src/resources/conversation-flow-component.ts

@@ -2011,6 +2011,9 @@ export namespace ConversationFlowComponentResponse {
       }
     }
 
+    /**
+     * @deprecated
+     */
     export interface CheckAvailabilityCalTool {
       /**
        * Cal.com Api key that have access to the cal.com event you want to check
@@ -2051,6 +2054,9 @@ export namespace ConversationFlowComponentResponse {
       timezone?: string;
     }
 
+    /**
+     * @deprecated
+     */
     export interface BookAppointmentCalTool {
       /**
        * Cal.com Api key that have access to the cal.com event you want to book
@@ -8673,6 +8679,9 @@ export namespace ConversationFlowComponentResponse {
     }
   }
 
+  /**
+   * @deprecated
+   */
   export interface CheckAvailabilityCalTool {
     /**
      * Cal.com Api key that have access to the cal.com event you want to check
@@ -8718,6 +8727,9 @@ export namespace ConversationFlowComponentResponse {
     tool_id?: string;
   }
 
+  /**
+   * @deprecated
+   */
   export interface BookAppointmentCalTool {
     /**
      * Cal.com Api key that have access to the cal.com event you want to book
@@ -8768,9 +8780,9 @@ export interface ConversationFlowComponentListResponse {
   /**
    * Whether more results are available.
    */
-  has_more?: boolean;
+  has_more: boolean;
 
-  items?: Array<ConversationFlowComponentResponse>;
+  items: Array<ConversationFlowComponentResponse>;
 
   /**
    * Pagination key for the next page.
@@ -10664,6 +10676,9 @@ export namespace ConversationFlowComponentCreateParams {
       }
     }
 
+    /**
+     * @deprecated
+     */
     export interface CheckAvailabilityCalTool {
       /**
        * Cal.com Api key that have access to the cal.com event you want to check
@@ -10704,6 +10719,9 @@ export namespace ConversationFlowComponentCreateParams {
       timezone?: string;
     }
 
+    /**
+     * @deprecated
+     */
     export interface BookAppointmentCalTool {
       /**
        * Cal.com Api key that have access to the cal.com event you want to book
@@ -17326,6 +17344,9 @@ export namespace ConversationFlowComponentCreateParams {
     }
   }
 
+  /**
+   * @deprecated
+   */
   export interface CheckAvailabilityCalTool {
     /**
      * Cal.com Api key that have access to the cal.com event you want to check
@@ -17371,6 +17392,9 @@ export namespace ConversationFlowComponentCreateParams {
     tool_id?: string;
   }
 
+  /**
+   * @deprecated
+   */
   export interface BookAppointmentCalTool {
     /**
      * Cal.com Api key that have access to the cal.com event you want to book
@@ -19337,6 +19361,9 @@ export namespace ConversationFlowComponentUpdateParams {
       }
     }
 
+    /**
+     * @deprecated
+     */
     export interface CheckAvailabilityCalTool {
       /**
        * Cal.com Api key that have access to the cal.com event you want to check
@@ -19377,6 +19404,9 @@ export namespace ConversationFlowComponentUpdateParams {
       timezone?: string;
     }
 
+    /**
+     * @deprecated
+     */
     export interface BookAppointmentCalTool {
       /**
        * Cal.com Api key that have access to the cal.com event you want to book
@@ -25965,6 +25995,9 @@ export namespace ConversationFlowComponentUpdateParams {
     }
   }
 
+  /**
+   * @deprecated
+   */
   export interface CheckAvailabilityCalTool {
     /**
      * Cal.com Api key that have access to the cal.com event you want to check
@@ -26010,6 +26043,9 @@ export namespace ConversationFlowComponentUpdateParams {
     tool_id?: string;
   }
 
+  /**
+   * @deprecated
+   */
   export interface BookAppointmentCalTool {
     /**
      * Cal.com Api key that have access to the cal.com event you want to book

package/src/resources/conversation-flow.ts

@@ -2147,6 +2147,9 @@ export namespace ConversationFlowResponse {
         }
       }
 
+      /**
+       * @deprecated
+       */
       export interface CheckAvailabilityCalTool {
         /**
          * Cal.com Api key that have access to the cal.com event you want to check
@@ -2187,6 +2190,9 @@ export namespace ConversationFlowResponse {
         timezone?: string;
       }
 
+      /**
+       * @deprecated
+       */
       export interface BookAppointmentCalTool {
         /**
          * Cal.com Api key that have access to the cal.com event you want to book
@@ -8809,6 +8815,9 @@ export namespace ConversationFlowResponse {
       }
     }
 
+    /**
+     * @deprecated
+     */
     export interface CheckAvailabilityCalTool {
       /**
        * Cal.com Api key that have access to the cal.com event you want to check
@@ -8854,6 +8863,9 @@ export namespace ConversationFlowResponse {
       tool_id?: string;
     }
 
+    /**
+     * @deprecated
+     */
     export interface BookAppointmentCalTool {
       /**
        * Cal.com Api key that have access to the cal.com event you want to book
@@ -10806,6 +10818,9 @@ export namespace ConversationFlowResponse {
       }
     }
 
+    /**
+     * @deprecated
+     */
     export interface CheckAvailabilityCalTool {
       /**
        * Cal.com Api key that have access to the cal.com event you want to check
@@ -10846,6 +10861,9 @@ export namespace ConversationFlowResponse {
       timezone?: string;
     }
 
+    /**
+     * @deprecated
+     */
     export interface BookAppointmentCalTool {
       /**
        * Cal.com Api key that have access to the cal.com event you want to book
@@ -17434,6 +17452,9 @@ export namespace ConversationFlowResponse {
     }
   }
 
+  /**
+   * @deprecated
+   */
   export interface CheckAvailabilityCalTool {
     /**
      * Cal.com Api key that have access to the cal.com event you want to check
@@ -17479,6 +17500,9 @@ export namespace ConversationFlowResponse {
     tool_id?: string;
   }
 
+  /**
+   * @deprecated
+   */
   export interface BookAppointmentCalTool {
     /**
      * Cal.com Api key that have access to the cal.com event you want to book
@@ -17529,9 +17553,9 @@ export interface ConversationFlowListResponse {
   /**
    * Whether more results are available.
    */
-  has_more?: boolean;
+  has_more: boolean;
 
-  items?: Array<ConversationFlowResponse>;
+  items: Array<ConversationFlowResponse>;
 
   /**
    * Pagination key for the next page.
@@ -19526,6 +19550,9 @@ export namespace ConversationFlowCreateParams {
       }
     }
 
+    /**
+     * @deprecated
+     */
     export interface CheckAvailabilityCalTool {
       /**
        * Cal.com Api key that have access to the cal.com event you want to check
@@ -19566,6 +19593,9 @@ export namespace ConversationFlowCreateParams {
       timezone?: string;
     }
 
+    /**
+     * @deprecated
+     */
     export interface BookAppointmentCalTool {
       /**
        * Cal.com Api key that have access to the cal.com event you want to book
@@ -27844,6 +27874,9 @@ export namespace ConversationFlowCreateParams {
         }
       }
 
+      /**
+       * @deprecated
+       */
       export interface CheckAvailabilityCalTool {
         /**
          * Cal.com Api key that have access to the cal.com event you want to check
@@ -27884,6 +27917,9 @@ export namespace ConversationFlowCreateParams {
         timezone?: string;
       }
 
+      /**
+       * @deprecated
+       */
       export interface BookAppointmentCalTool {
         /**
          * Cal.com Api key that have access to the cal.com event you want to book
@@ -34506,6 +34542,9 @@ export namespace ConversationFlowCreateParams {
       }
     }
 
+    /**
+     * @deprecated
+     */
     export interface CheckAvailabilityCalTool {
       /**
        * Cal.com Api key that have access to the cal.com event you want to check
@@ -34551,6 +34590,9 @@ export namespace ConversationFlowCreateParams {
       tool_id?: string;
     }
 
+    /**
+     * @deprecated
+     */
     export interface BookAppointmentCalTool {
       /**
        * Cal.com Api key that have access to the cal.com event you want to book
@@ -34840,6 +34882,9 @@ export namespace ConversationFlowCreateParams {
     }
   }
 
+  /**
+   * @deprecated
+   */
   export interface CheckAvailabilityCalTool {
     /**
      * Cal.com Api key that have access to the cal.com event you want to check
@@ -34885,6 +34930,9 @@ export namespace ConversationFlowCreateParams {
     tool_id?: string;
   }
 
+  /**
+   * @deprecated
+   */
   export interface BookAppointmentCalTool {
     /**
      * Cal.com Api key that have access to the cal.com event you want to book
@@ -36960,6 +37008,9 @@ export namespace ConversationFlowUpdateParams {
         }
       }
 
+      /**
+       * @deprecated
+       */
       export interface CheckAvailabilityCalTool {
         /**
          * Cal.com Api key that have access to the cal.com event you want to check
@@ -37000,6 +37051,9 @@ export namespace ConversationFlowUpdateParams {
         timezone?: string;
       }
 
+      /**
+       * @deprecated
+       */
       export interface BookAppointmentCalTool {
         /**
          * Cal.com Api key that have access to the cal.com event you want to book
@@ -43622,6 +43676,9 @@ export namespace ConversationFlowUpdateParams {
       }
     }
 
+    /**
+     * @deprecated
+     */
     export interface CheckAvailabilityCalTool {
       /**
        * Cal.com Api key that have access to the cal.com event you want to check
@@ -43667,6 +43724,9 @@ export namespace ConversationFlowUpdateParams {
       tool_id?: string;
     }
 
+    /**
+     * @deprecated
+     */
     export interface BookAppointmentCalTool {
       /**
        * Cal.com Api key that have access to the cal.com event you want to book
@@ -45619,6 +45679,9 @@ export namespace ConversationFlowUpdateParams {
       }
     }
 
+    /**
+     * @deprecated
+     */
     export interface CheckAvailabilityCalTool {
       /**
        * Cal.com Api key that have access to the cal.com event you want to check
@@ -45659,6 +45722,9 @@ export namespace ConversationFlowUpdateParams {
       timezone?: string;
     }
 
+    /**
+     * @deprecated
+     */
     export interface BookAppointmentCalTool {
       /**
        * Cal.com Api key that have access to the cal.com event you want to book
@@ -52247,6 +52313,9 @@ export namespace ConversationFlowUpdateParams {
     }
   }
 
+  /**
+   * @deprecated
+   */
   export interface CheckAvailabilityCalTool {
     /**
      * Cal.com Api key that have access to the cal.com event you want to check
@@ -52292,6 +52361,9 @@ export namespace ConversationFlowUpdateParams {
     tool_id?: string;
   }
 
+  /**
+   * @deprecated
+   */
   export interface BookAppointmentCalTool {
     /**
      * Cal.com Api key that have access to the cal.com event you want to book

package/src/resources/crm.ts

@@ -65,6 +65,11 @@ export interface CRMConfig {
    */
   contact_columns_order?: Array<string>;
 
+  /**
+   * Tags available to contacts in this organization.
+   */
+  contact_tags?: Array<string>;
+
   crm_analysis_data_mappings?: Array<CRMConfig.CRMAnalysisDataMapping>;
 
   custom_fields?: Array<CRMConfig.CustomField>;