kommo-aiatende-api 1.2.1 → 1.2.3

package/dist/index.d.mts

@@ -1,5 +1,13 @@
 import { AxiosInstance } from 'axios';
 
+interface RetryConfig {
+    /** Número máximo de novas tentativas após a primeira falha. Padrão: 2. */
+    retries?: number;
+    /** Atraso base (ms) usado no backoff exponencial. Padrão: 300. */
+    baseDelayMs?: number;
+    /** Teto do atraso entre tentativas (ms). Padrão: 3000. */
+    maxDelayMs?: number;
+}
 interface KommoConfig {
     domain: string;
     accessToken?: string;
@@ -7,6 +15,10 @@ interface KommoConfig {
     clientId?: string;
     clientSecret?: string;
     redirectUri?: string;
+    /** Timeout (ms) por requisição HTTP. Padrão: 30000. */
+    timeout?: number;
+    /** Configuração de retry para erros transitórios de rede (ex.: "socket hang up"). Passe `false` para desativar. */
+    retry?: RetryConfig | false;
 }
 interface AccessTokenResponse {
     token_type: string;
@@ -73,6 +85,14 @@ declare class AuthManager {
 declare abstract class BaseResource {
     protected client: AxiosInstance;
     constructor(client: AxiosInstance);
+    /**
+     * POST de criação em lote marcado como seguro para retry: cada item recebe um
+     * request_id (se ainda não tiver um) para que a Kommo deduplique reenvios após
+     * falhas transitórias de rede, e a requisição fica elegível ao retry automático.
+     */
+    protected postIdempotent<TResponse, TItem extends {
+        request_id?: string;
+    }>(url: string, items: TItem[]): Promise<TResponse>;
 }
 
 interface Lead {
@@ -2792,6 +2812,64 @@ declare class AccountResource extends BaseResource {
     get(params?: GetAccountParams): Promise<Account>;
 }
 
+type TalkEntityType = 'lead';
+type TalkStatus = 'in_work' | 'closed' | 'nps_scheduled' | 'nps_in_progress' | 'with_error';
+interface Talk {
+    talk_id: number;
+    created_at: number;
+    updated_at: number;
+    rate: number | null;
+    contact_id: number;
+    chat_id: string;
+    entity_id: number;
+    entity_type: TalkEntityType;
+    status: TalkStatus;
+    is_in_work: boolean;
+    is_read: boolean;
+    origin: string;
+    source_id: string | null;
+    account_id: number;
+    _embedded?: {
+        contacts?: Array<{
+            id: number;
+        }>;
+        leads?: Array<{
+            id: number;
+        }>;
+    };
+}
+interface ListTalksParams {
+    page?: number;
+    limit?: number;
+    filter_talk_id?: number[];
+    filter_contact_id?: number[];
+    filter_entity_id?: number[];
+    filter_entity_type?: TalkEntityType;
+    filter_only_in_work?: boolean;
+}
+interface ListTalksResponse {
+    _page: number;
+    _links?: {
+        self?: {
+            href: string;
+        };
+        next?: {
+            href: string;
+        };
+    };
+    _embedded?: {
+        talks?: Talk[];
+    };
+}
+interface CloseTalkParams {
+    force_close?: boolean;
+}
+
+declare class TalksResource extends BaseResource {
+    list(params?: ListTalksParams): Promise<ListTalksResponse>;
+    close(id: number, params?: CloseTalkParams): Promise<void>;
+}
+
 declare class KommoClient {
     config: KommoConfig;
     auth: AuthManager;
@@ -2818,6 +2896,7 @@ declare class KommoClient {
     webhooks: WebhooksResource;
     files: FilesResource;
     account: AccountResource;
+    talks: TalksResource;
     constructor(config: KommoConfig);
     setAccessToken(token: string): void;
 }
@@ -2831,4 +2910,4 @@ declare class KommoApiError extends Error {
     constructor(message: string, info?: Partial<KommoApiError>);
 }
 
-export { type AccessTokenResponse, type Account, AccountResource, type AccountWithParam, type AmojoRights, type AttachFilesToEntityItem, type AttachmentNoteParams, AuthManager, type BaseCreateUnsortedItem, type BaseCustomField, type BaseEntity, type CallNoteParams, type Catalog, type CatalogElement, type CatalogElementCustomFieldValue, CatalogsResource, type ChatTemplate, type ChatTemplateAttachment, type ChatTemplateButton, type ChatTemplateButtonType, type ChatTemplateReview, type ChatTemplateType, ChatTemplatesResource, type CollectionResponse, type CommonNoteParams, CompaniesResource, type Company, type CompanyCatalogElementRef, type CompanyContactRef, type CompanyLeadRef, type CompanyTag, type CompanyTagRef, type CompanyWithParam, type Contact, type ContactCatalogElementRef, type ContactCompanyRef, type ContactCustomerRef, type ContactLeadRef, type ContactTag, type ContactTagRef, type ContactWithParam, ContactsResource, type CreateCatalogElementInput, type CreateCatalogElementsResponse, type CreateCatalogInput, type CreateCatalogsResponse, type CreateChatTemplateInput, type CreateChatTemplatesResponse, type CreateCompaniesResponse, type CreateCompanyInput, type CreateComplexLeadInput, type CreateComplexLeadsResponse, type CreateComplexLeadsResponseItem, type CreateContactInput, type CreateContactsResponse, type CreateCustomFieldGroupInput, type CreateEntityCustomFieldInput, type CreateEntityLinkInput, type CreateEntityLinksResponse, type CreateFileUploadSessionInput, type CreateFormUnsortedLeadInput, type CreateLeadInput, type CreateLeadsResponse, type CreateListCustomFieldInput, type CreateNoteInput, type CreateNotesResponse, type CreatePipelineInput, type CreatePipelineStatusInput, type CreatePipelinesResponse, type CreateRoleInput, type CreateSipUnsortedLeadInput, type CreateSourceInput, type CreateSourcesResponse, type CreateStatusInput, type CreateStatusesResponse, type CreateTagInput, type CreateTagRef, type CreateTagsResponse, type CreateTaskInput, type CreateTasksResponse, type CreateUnsortedCompany, type CreateUnsortedContact, type CreateUnsortedLead, type CreateUnsortedLeadsResponse, type CreateUserInput, type CreateWebhookInput, type CreateWebsiteButtonInput, type CreateWebsiteButtonResponse, type CustomField, type CustomFieldEnum, type CustomFieldGroup, CustomFieldGroupsResource, type CustomFieldNestedValue, type CustomFieldRequiredStatus, type CustomFieldType, type CustomFieldValue, CustomFieldsResource, type DeleteChatTemplateInput, type DeleteEntityLinkInput, type DeleteFilesItem, type DeleteSourceBatchInput, type DeleteWebhookInput, type DetachFilesFromEntityItem, type Embedded, type EntityAttachedFileRecord, type EntityCustomField, EntityFilesResource, type EntityLink, type EntityLinkMetadata, type EntityLinkWithSource, type EntityRights, type EntityType, type EntityUpdateResult, type Event, type EventTypeDefinition, type EventValueChange, type EventValueFilters, type EventWithParam, EventsResource, type FileAttachEntityType, type FileLinkedEntityRecord, FileLinksResource, type FileRecord, type FileVersionRecord, FilesResource, FilesServiceResource, type FormMetadata, type GeolocationNoteParams, type GetAccountParams, KNOWN_WEBHOOK_EVENTS, KOMMO_PIPELINE_STAGE_COLORS, KOMMO_TAG_COLORS, type KnownEventType, KommoApiError, KommoClient, type KommoConfig, type KommoPipelineStageColor, type Lead, type LeadCatalogElementRef, type LeadCompanyRef, type LeadContactRef, type LeadTag, type LeadTagRef, type LeadWithParam, LeadsResource, type LinkMetadataInput, type LinkSourceEntityType, type LinkTargetEntityType, type LinkUnsortedLeadResponse, LinksResource, type ListCatalogElementsParams, type ListCatalogElementsResponse, type ListCatalogsParams, type ListCatalogsResponse, type ListChatTemplatesParams, type ListChatTemplatesResponse, type ListCompaniesParams, type ListCompaniesResponse, type ListContactsParams, type ListContactsResponse, type ListCustomField, type ListCustomFieldGroupsResponse, type ListEntityAttachedFilesParams, type ListEntityAttachedFilesResponse, type ListEntityCustomFieldsResponse, type ListEntityLinksParams, type ListEntityLinksResponse, type ListEntityNotesParams, type ListEventTypesParams, type ListEventTypesResponse, type ListEventsParams, type ListEventsResponse, type ListFileLinkedEntitiesResponse, type ListFileVersionsResponse, type ListFilesParams, type ListFilesResponse, type ListLeadsParams, type ListLeadsResponse, type ListListCustomFieldsResponse, type ListLossReasonsResponse, type ListNotesResponse, type ListPipelineStatusesResponse, type ListPipelinesResponse, type ListRolesParams, type ListRolesResponse, type ListSalesbotsParams, type ListSalesbotsResponse, type ListSourcesResponse, type ListTagsParams, type ListTagsResponse, type ListTasksParams, type ListTasksResponse, type ListUnsortedLeadsParams, type ListUnsortedLeadsResponse, type ListUsersParams, type ListUsersResponse, type ListWebhooksParams, type ListWebhooksResponse, type ListWebsiteButtonsParams, type ListWebsiteButtonsResponse, type LossReason, type Note, type NoteEntityType, type NoteParams, type NoteType, NotesResource, type PermissionLevel, type Pipeline, type PipelineStatus, PipelinesResource, type RestoreFilesItem, type Role, type RoleWithParam, RolesResource, type RunManySalesbotsItem, type RunSalesbotInput, type Salesbot, type SalesbotContinueBotType, type SalesbotContinueInput, type SalesbotExecuteHandler, type SalesbotFunctionalityType, SalesbotsResource, type ServiceMessageNoteParams, type SipMetadata, type SmsNoteParams, type Source, type SourceService, type SourceServicePage, SourcesResource, type StatusDescription, type StatusRight, type StopSalesbotInput, type SubmitWhatsAppTemplateReviewResponse, type Tag, type TagColor, type TagEntityType, type TagRefInput, TagsResource, type Task, TasksResource, type UnsortedDecisionResponse, type UnsortedLead, UnsortedResource, type UnsortedSummaryParams, type UnsortedSummaryResponse, type UpdateCatalogElementInput, type UpdateCatalogElementsResponse, type UpdateCatalogInput, type UpdateCatalogsResponse, type UpdateChatTemplateInput, type UpdateChatTemplatesResponse, type UpdateCompaniesResponse, type UpdateCompanyInput, type UpdateContactInput, type UpdateContactsResponse, type UpdateCustomFieldGroupInput, type UpdateEntityCustomFieldInput, type UpdateEntityTagsBatchResponse, type UpdateEntityTagsInput, type UpdateEntityTagsSingleResponse, type UpdateFileInput, type UpdateLeadInput, type UpdateLeadsResponse, type UpdateListCustomFieldInput, type UpdateNoteInput, type UpdateNotesResponse, type UpdatePipelineInput, type UpdateRoleInput, type UpdateSingleCatalogElementInput, type UpdateSingleCatalogInput, type UpdateSingleCompanyInput, type UpdateSingleContactInput, type UpdateSingleEntityCustomFieldInput, type UpdateSingleEntityTagsInput, type UpdateSingleLeadInput, type UpdateSingleListCustomFieldInput, type UpdateSingleNoteInput, type UpdateSingleTaskInput, type UpdateSourceBatchInput, type UpdateSourceInput, type UpdateSourcesResponse, type UpdateStatusInput, type UpdateTaskInput, type UpdateTasksResponse, type UpdateWebsiteButtonInput, type UpdateWhatsAppTemplateReviewStatusInput, type UpdateWhatsAppTemplateReviewStatusResponse, type UploadFilePartInput, type UploadFilePartResponse, type UploadSessionResponse, type User, type UserWithParam, UsersResource, type WabaCategory, type WabaHeaderType, type WabaReviewStatus, type Webhook, type WebhookEvent, WebhooksResource, type WebsiteButton, type WebsiteButtonCreationStatus, WebsiteButtonsResource, type WhatsAppTemplateModerationStatus, eventUtils };
+export { type AccessTokenResponse, type Account, AccountResource, type AccountWithParam, type AmojoRights, type AttachFilesToEntityItem, type AttachmentNoteParams, AuthManager, type BaseCreateUnsortedItem, type BaseCustomField, type BaseEntity, type CallNoteParams, type Catalog, type CatalogElement, type CatalogElementCustomFieldValue, CatalogsResource, type ChatTemplate, type ChatTemplateAttachment, type ChatTemplateButton, type ChatTemplateButtonType, type ChatTemplateReview, type ChatTemplateType, ChatTemplatesResource, type CloseTalkParams, type CollectionResponse, type CommonNoteParams, CompaniesResource, type Company, type CompanyCatalogElementRef, type CompanyContactRef, type CompanyLeadRef, type CompanyTag, type CompanyTagRef, type CompanyWithParam, type Contact, type ContactCatalogElementRef, type ContactCompanyRef, type ContactCustomerRef, type ContactLeadRef, type ContactTag, type ContactTagRef, type ContactWithParam, ContactsResource, type CreateCatalogElementInput, type CreateCatalogElementsResponse, type CreateCatalogInput, type CreateCatalogsResponse, type CreateChatTemplateInput, type CreateChatTemplatesResponse, type CreateCompaniesResponse, type CreateCompanyInput, type CreateComplexLeadInput, type CreateComplexLeadsResponse, type CreateComplexLeadsResponseItem, type CreateContactInput, type CreateContactsResponse, type CreateCustomFieldGroupInput, type CreateEntityCustomFieldInput, type CreateEntityLinkInput, type CreateEntityLinksResponse, type CreateFileUploadSessionInput, type CreateFormUnsortedLeadInput, type CreateLeadInput, type CreateLeadsResponse, type CreateListCustomFieldInput, type CreateNoteInput, type CreateNotesResponse, type CreatePipelineInput, type CreatePipelineStatusInput, type CreatePipelinesResponse, type CreateRoleInput, type CreateSipUnsortedLeadInput, type CreateSourceInput, type CreateSourcesResponse, type CreateStatusInput, type CreateStatusesResponse, type CreateTagInput, type CreateTagRef, type CreateTagsResponse, type CreateTaskInput, type CreateTasksResponse, type CreateUnsortedCompany, type CreateUnsortedContact, type CreateUnsortedLead, type CreateUnsortedLeadsResponse, type CreateUserInput, type CreateWebhookInput, type CreateWebsiteButtonInput, type CreateWebsiteButtonResponse, type CustomField, type CustomFieldEnum, type CustomFieldGroup, CustomFieldGroupsResource, type CustomFieldNestedValue, type CustomFieldRequiredStatus, type CustomFieldType, type CustomFieldValue, CustomFieldsResource, type DeleteChatTemplateInput, type DeleteEntityLinkInput, type DeleteFilesItem, type DeleteSourceBatchInput, type DeleteWebhookInput, type DetachFilesFromEntityItem, type Embedded, type EntityAttachedFileRecord, type EntityCustomField, EntityFilesResource, type EntityLink, type EntityLinkMetadata, type EntityLinkWithSource, type EntityRights, type EntityType, type EntityUpdateResult, type Event, type EventTypeDefinition, type EventValueChange, type EventValueFilters, type EventWithParam, EventsResource, type FileAttachEntityType, type FileLinkedEntityRecord, FileLinksResource, type FileRecord, type FileVersionRecord, FilesResource, FilesServiceResource, type FormMetadata, type GeolocationNoteParams, type GetAccountParams, KNOWN_WEBHOOK_EVENTS, KOMMO_PIPELINE_STAGE_COLORS, KOMMO_TAG_COLORS, type KnownEventType, KommoApiError, KommoClient, type KommoConfig, type KommoPipelineStageColor, type Lead, type LeadCatalogElementRef, type LeadCompanyRef, type LeadContactRef, type LeadTag, type LeadTagRef, type LeadWithParam, LeadsResource, type LinkMetadataInput, type LinkSourceEntityType, type LinkTargetEntityType, type LinkUnsortedLeadResponse, LinksResource, type ListCatalogElementsParams, type ListCatalogElementsResponse, type ListCatalogsParams, type ListCatalogsResponse, type ListChatTemplatesParams, type ListChatTemplatesResponse, type ListCompaniesParams, type ListCompaniesResponse, type ListContactsParams, type ListContactsResponse, type ListCustomField, type ListCustomFieldGroupsResponse, type ListEntityAttachedFilesParams, type ListEntityAttachedFilesResponse, type ListEntityCustomFieldsResponse, type ListEntityLinksParams, type ListEntityLinksResponse, type ListEntityNotesParams, type ListEventTypesParams, type ListEventTypesResponse, type ListEventsParams, type ListEventsResponse, type ListFileLinkedEntitiesResponse, type ListFileVersionsResponse, type ListFilesParams, type ListFilesResponse, type ListLeadsParams, type ListLeadsResponse, type ListListCustomFieldsResponse, type ListLossReasonsResponse, type ListNotesResponse, type ListPipelineStatusesResponse, type ListPipelinesResponse, type ListRolesParams, type ListRolesResponse, type ListSalesbotsParams, type ListSalesbotsResponse, type ListSourcesResponse, type ListTagsParams, type ListTagsResponse, type ListTalksParams, type ListTalksResponse, type ListTasksParams, type ListTasksResponse, type ListUnsortedLeadsParams, type ListUnsortedLeadsResponse, type ListUsersParams, type ListUsersResponse, type ListWebhooksParams, type ListWebhooksResponse, type ListWebsiteButtonsParams, type ListWebsiteButtonsResponse, type LossReason, type Note, type NoteEntityType, type NoteParams, type NoteType, NotesResource, type PermissionLevel, type Pipeline, type PipelineStatus, PipelinesResource, type RestoreFilesItem, type RetryConfig, type Role, type RoleWithParam, RolesResource, type RunManySalesbotsItem, type RunSalesbotInput, type Salesbot, type SalesbotContinueBotType, type SalesbotContinueInput, type SalesbotExecuteHandler, type SalesbotFunctionalityType, SalesbotsResource, type ServiceMessageNoteParams, type SipMetadata, type SmsNoteParams, type Source, type SourceService, type SourceServicePage, SourcesResource, type StatusDescription, type StatusRight, type StopSalesbotInput, type SubmitWhatsAppTemplateReviewResponse, type Tag, type TagColor, type TagEntityType, type TagRefInput, TagsResource, type Talk, type TalkEntityType, type TalkStatus, TalksResource, type Task, TasksResource, type UnsortedDecisionResponse, type UnsortedLead, UnsortedResource, type UnsortedSummaryParams, type UnsortedSummaryResponse, type UpdateCatalogElementInput, type UpdateCatalogElementsResponse, type UpdateCatalogInput, type UpdateCatalogsResponse, type UpdateChatTemplateInput, type UpdateChatTemplatesResponse, type UpdateCompaniesResponse, type UpdateCompanyInput, type UpdateContactInput, type UpdateContactsResponse, type UpdateCustomFieldGroupInput, type UpdateEntityCustomFieldInput, type UpdateEntityTagsBatchResponse, type UpdateEntityTagsInput, type UpdateEntityTagsSingleResponse, type UpdateFileInput, type UpdateLeadInput, type UpdateLeadsResponse, type UpdateListCustomFieldInput, type UpdateNoteInput, type UpdateNotesResponse, type UpdatePipelineInput, type UpdateRoleInput, type UpdateSingleCatalogElementInput, type UpdateSingleCatalogInput, type UpdateSingleCompanyInput, type UpdateSingleContactInput, type UpdateSingleEntityCustomFieldInput, type UpdateSingleEntityTagsInput, type UpdateSingleLeadInput, type UpdateSingleListCustomFieldInput, type UpdateSingleNoteInput, type UpdateSingleTaskInput, type UpdateSourceBatchInput, type UpdateSourceInput, type UpdateSourcesResponse, type UpdateStatusInput, type UpdateTaskInput, type UpdateTasksResponse, type UpdateWebsiteButtonInput, type UpdateWhatsAppTemplateReviewStatusInput, type UpdateWhatsAppTemplateReviewStatusResponse, type UploadFilePartInput, type UploadFilePartResponse, type UploadSessionResponse, type User, type UserWithParam, UsersResource, type WabaCategory, type WabaHeaderType, type WabaReviewStatus, type Webhook, type WebhookEvent, WebhooksResource, type WebsiteButton, type WebsiteButtonCreationStatus, WebsiteButtonsResource, type WhatsAppTemplateModerationStatus, eventUtils };

package/dist/index.d.ts

@@ -1,5 +1,13 @@
 import { AxiosInstance } from 'axios';
 
+interface RetryConfig {
+    /** Número máximo de novas tentativas após a primeira falha. Padrão: 2. */
+    retries?: number;
+    /** Atraso base (ms) usado no backoff exponencial. Padrão: 300. */
+    baseDelayMs?: number;
+    /** Teto do atraso entre tentativas (ms). Padrão: 3000. */
+    maxDelayMs?: number;
+}
 interface KommoConfig {
     domain: string;
     accessToken?: string;
@@ -7,6 +15,10 @@ interface KommoConfig {
     clientId?: string;
     clientSecret?: string;
     redirectUri?: string;
+    /** Timeout (ms) por requisição HTTP. Padrão: 30000. */
+    timeout?: number;
+    /** Configuração de retry para erros transitórios de rede (ex.: "socket hang up"). Passe `false` para desativar. */
+    retry?: RetryConfig | false;
 }
 interface AccessTokenResponse {
     token_type: string;
@@ -73,6 +85,14 @@ declare class AuthManager {
 declare abstract class BaseResource {
     protected client: AxiosInstance;
     constructor(client: AxiosInstance);
+    /**
+     * POST de criação em lote marcado como seguro para retry: cada item recebe um
+     * request_id (se ainda não tiver um) para que a Kommo deduplique reenvios após
+     * falhas transitórias de rede, e a requisição fica elegível ao retry automático.
+     */
+    protected postIdempotent<TResponse, TItem extends {
+        request_id?: string;
+    }>(url: string, items: TItem[]): Promise<TResponse>;
 }
 
 interface Lead {
@@ -2792,6 +2812,64 @@ declare class AccountResource extends BaseResource {
     get(params?: GetAccountParams): Promise<Account>;
 }
 
+type TalkEntityType = 'lead';
+type TalkStatus = 'in_work' | 'closed' | 'nps_scheduled' | 'nps_in_progress' | 'with_error';
+interface Talk {
+    talk_id: number;
+    created_at: number;
+    updated_at: number;
+    rate: number | null;
+    contact_id: number;
+    chat_id: string;
+    entity_id: number;
+    entity_type: TalkEntityType;
+    status: TalkStatus;
+    is_in_work: boolean;
+    is_read: boolean;
+    origin: string;
+    source_id: string | null;
+    account_id: number;
+    _embedded?: {
+        contacts?: Array<{
+            id: number;
+        }>;
+        leads?: Array<{
+            id: number;
+        }>;
+    };
+}
+interface ListTalksParams {
+    page?: number;
+    limit?: number;
+    filter_talk_id?: number[];
+    filter_contact_id?: number[];
+    filter_entity_id?: number[];
+    filter_entity_type?: TalkEntityType;
+    filter_only_in_work?: boolean;
+}
+interface ListTalksResponse {
+    _page: number;
+    _links?: {
+        self?: {
+            href: string;
+        };
+        next?: {
+            href: string;
+        };
+    };
+    _embedded?: {
+        talks?: Talk[];
+    };
+}
+interface CloseTalkParams {
+    force_close?: boolean;
+}
+
+declare class TalksResource extends BaseResource {
+    list(params?: ListTalksParams): Promise<ListTalksResponse>;
+    close(id: number, params?: CloseTalkParams): Promise<void>;
+}
+
 declare class KommoClient {
     config: KommoConfig;
     auth: AuthManager;
@@ -2818,6 +2896,7 @@ declare class KommoClient {
     webhooks: WebhooksResource;
     files: FilesResource;
     account: AccountResource;
+    talks: TalksResource;
     constructor(config: KommoConfig);
     setAccessToken(token: string): void;
 }
@@ -2831,4 +2910,4 @@ declare class KommoApiError extends Error {
     constructor(message: string, info?: Partial<KommoApiError>);
 }
 
-export { type AccessTokenResponse, type Account, AccountResource, type AccountWithParam, type AmojoRights, type AttachFilesToEntityItem, type AttachmentNoteParams, AuthManager, type BaseCreateUnsortedItem, type BaseCustomField, type BaseEntity, type CallNoteParams, type Catalog, type CatalogElement, type CatalogElementCustomFieldValue, CatalogsResource, type ChatTemplate, type ChatTemplateAttachment, type ChatTemplateButton, type ChatTemplateButtonType, type ChatTemplateReview, type ChatTemplateType, ChatTemplatesResource, type CollectionResponse, type CommonNoteParams, CompaniesResource, type Company, type CompanyCatalogElementRef, type CompanyContactRef, type CompanyLeadRef, type CompanyTag, type CompanyTagRef, type CompanyWithParam, type Contact, type ContactCatalogElementRef, type ContactCompanyRef, type ContactCustomerRef, type ContactLeadRef, type ContactTag, type ContactTagRef, type ContactWithParam, ContactsResource, type CreateCatalogElementInput, type CreateCatalogElementsResponse, type CreateCatalogInput, type CreateCatalogsResponse, type CreateChatTemplateInput, type CreateChatTemplatesResponse, type CreateCompaniesResponse, type CreateCompanyInput, type CreateComplexLeadInput, type CreateComplexLeadsResponse, type CreateComplexLeadsResponseItem, type CreateContactInput, type CreateContactsResponse, type CreateCustomFieldGroupInput, type CreateEntityCustomFieldInput, type CreateEntityLinkInput, type CreateEntityLinksResponse, type CreateFileUploadSessionInput, type CreateFormUnsortedLeadInput, type CreateLeadInput, type CreateLeadsResponse, type CreateListCustomFieldInput, type CreateNoteInput, type CreateNotesResponse, type CreatePipelineInput, type CreatePipelineStatusInput, type CreatePipelinesResponse, type CreateRoleInput, type CreateSipUnsortedLeadInput, type CreateSourceInput, type CreateSourcesResponse, type CreateStatusInput, type CreateStatusesResponse, type CreateTagInput, type CreateTagRef, type CreateTagsResponse, type CreateTaskInput, type CreateTasksResponse, type CreateUnsortedCompany, type CreateUnsortedContact, type CreateUnsortedLead, type CreateUnsortedLeadsResponse, type CreateUserInput, type CreateWebhookInput, type CreateWebsiteButtonInput, type CreateWebsiteButtonResponse, type CustomField, type CustomFieldEnum, type CustomFieldGroup, CustomFieldGroupsResource, type CustomFieldNestedValue, type CustomFieldRequiredStatus, type CustomFieldType, type CustomFieldValue, CustomFieldsResource, type DeleteChatTemplateInput, type DeleteEntityLinkInput, type DeleteFilesItem, type DeleteSourceBatchInput, type DeleteWebhookInput, type DetachFilesFromEntityItem, type Embedded, type EntityAttachedFileRecord, type EntityCustomField, EntityFilesResource, type EntityLink, type EntityLinkMetadata, type EntityLinkWithSource, type EntityRights, type EntityType, type EntityUpdateResult, type Event, type EventTypeDefinition, type EventValueChange, type EventValueFilters, type EventWithParam, EventsResource, type FileAttachEntityType, type FileLinkedEntityRecord, FileLinksResource, type FileRecord, type FileVersionRecord, FilesResource, FilesServiceResource, type FormMetadata, type GeolocationNoteParams, type GetAccountParams, KNOWN_WEBHOOK_EVENTS, KOMMO_PIPELINE_STAGE_COLORS, KOMMO_TAG_COLORS, type KnownEventType, KommoApiError, KommoClient, type KommoConfig, type KommoPipelineStageColor, type Lead, type LeadCatalogElementRef, type LeadCompanyRef, type LeadContactRef, type LeadTag, type LeadTagRef, type LeadWithParam, LeadsResource, type LinkMetadataInput, type LinkSourceEntityType, type LinkTargetEntityType, type LinkUnsortedLeadResponse, LinksResource, type ListCatalogElementsParams, type ListCatalogElementsResponse, type ListCatalogsParams, type ListCatalogsResponse, type ListChatTemplatesParams, type ListChatTemplatesResponse, type ListCompaniesParams, type ListCompaniesResponse, type ListContactsParams, type ListContactsResponse, type ListCustomField, type ListCustomFieldGroupsResponse, type ListEntityAttachedFilesParams, type ListEntityAttachedFilesResponse, type ListEntityCustomFieldsResponse, type ListEntityLinksParams, type ListEntityLinksResponse, type ListEntityNotesParams, type ListEventTypesParams, type ListEventTypesResponse, type ListEventsParams, type ListEventsResponse, type ListFileLinkedEntitiesResponse, type ListFileVersionsResponse, type ListFilesParams, type ListFilesResponse, type ListLeadsParams, type ListLeadsResponse, type ListListCustomFieldsResponse, type ListLossReasonsResponse, type ListNotesResponse, type ListPipelineStatusesResponse, type ListPipelinesResponse, type ListRolesParams, type ListRolesResponse, type ListSalesbotsParams, type ListSalesbotsResponse, type ListSourcesResponse, type ListTagsParams, type ListTagsResponse, type ListTasksParams, type ListTasksResponse, type ListUnsortedLeadsParams, type ListUnsortedLeadsResponse, type ListUsersParams, type ListUsersResponse, type ListWebhooksParams, type ListWebhooksResponse, type ListWebsiteButtonsParams, type ListWebsiteButtonsResponse, type LossReason, type Note, type NoteEntityType, type NoteParams, type NoteType, NotesResource, type PermissionLevel, type Pipeline, type PipelineStatus, PipelinesResource, type RestoreFilesItem, type Role, type RoleWithParam, RolesResource, type RunManySalesbotsItem, type RunSalesbotInput, type Salesbot, type SalesbotContinueBotType, type SalesbotContinueInput, type SalesbotExecuteHandler, type SalesbotFunctionalityType, SalesbotsResource, type ServiceMessageNoteParams, type SipMetadata, type SmsNoteParams, type Source, type SourceService, type SourceServicePage, SourcesResource, type StatusDescription, type StatusRight, type StopSalesbotInput, type SubmitWhatsAppTemplateReviewResponse, type Tag, type TagColor, type TagEntityType, type TagRefInput, TagsResource, type Task, TasksResource, type UnsortedDecisionResponse, type UnsortedLead, UnsortedResource, type UnsortedSummaryParams, type UnsortedSummaryResponse, type UpdateCatalogElementInput, type UpdateCatalogElementsResponse, type UpdateCatalogInput, type UpdateCatalogsResponse, type UpdateChatTemplateInput, type UpdateChatTemplatesResponse, type UpdateCompaniesResponse, type UpdateCompanyInput, type UpdateContactInput, type UpdateContactsResponse, type UpdateCustomFieldGroupInput, type UpdateEntityCustomFieldInput, type UpdateEntityTagsBatchResponse, type UpdateEntityTagsInput, type UpdateEntityTagsSingleResponse, type UpdateFileInput, type UpdateLeadInput, type UpdateLeadsResponse, type UpdateListCustomFieldInput, type UpdateNoteInput, type UpdateNotesResponse, type UpdatePipelineInput, type UpdateRoleInput, type UpdateSingleCatalogElementInput, type UpdateSingleCatalogInput, type UpdateSingleCompanyInput, type UpdateSingleContactInput, type UpdateSingleEntityCustomFieldInput, type UpdateSingleEntityTagsInput, type UpdateSingleLeadInput, type UpdateSingleListCustomFieldInput, type UpdateSingleNoteInput, type UpdateSingleTaskInput, type UpdateSourceBatchInput, type UpdateSourceInput, type UpdateSourcesResponse, type UpdateStatusInput, type UpdateTaskInput, type UpdateTasksResponse, type UpdateWebsiteButtonInput, type UpdateWhatsAppTemplateReviewStatusInput, type UpdateWhatsAppTemplateReviewStatusResponse, type UploadFilePartInput, type UploadFilePartResponse, type UploadSessionResponse, type User, type UserWithParam, UsersResource, type WabaCategory, type WabaHeaderType, type WabaReviewStatus, type Webhook, type WebhookEvent, WebhooksResource, type WebsiteButton, type WebsiteButtonCreationStatus, WebsiteButtonsResource, type WhatsAppTemplateModerationStatus, eventUtils };
+export { type AccessTokenResponse, type Account, AccountResource, type AccountWithParam, type AmojoRights, type AttachFilesToEntityItem, type AttachmentNoteParams, AuthManager, type BaseCreateUnsortedItem, type BaseCustomField, type BaseEntity, type CallNoteParams, type Catalog, type CatalogElement, type CatalogElementCustomFieldValue, CatalogsResource, type ChatTemplate, type ChatTemplateAttachment, type ChatTemplateButton, type ChatTemplateButtonType, type ChatTemplateReview, type ChatTemplateType, ChatTemplatesResource, type CloseTalkParams, type CollectionResponse, type CommonNoteParams, CompaniesResource, type Company, type CompanyCatalogElementRef, type CompanyContactRef, type CompanyLeadRef, type CompanyTag, type CompanyTagRef, type CompanyWithParam, type Contact, type ContactCatalogElementRef, type ContactCompanyRef, type ContactCustomerRef, type ContactLeadRef, type ContactTag, type ContactTagRef, type ContactWithParam, ContactsResource, type CreateCatalogElementInput, type CreateCatalogElementsResponse, type CreateCatalogInput, type CreateCatalogsResponse, type CreateChatTemplateInput, type CreateChatTemplatesResponse, type CreateCompaniesResponse, type CreateCompanyInput, type CreateComplexLeadInput, type CreateComplexLeadsResponse, type CreateComplexLeadsResponseItem, type CreateContactInput, type CreateContactsResponse, type CreateCustomFieldGroupInput, type CreateEntityCustomFieldInput, type CreateEntityLinkInput, type CreateEntityLinksResponse, type CreateFileUploadSessionInput, type CreateFormUnsortedLeadInput, type CreateLeadInput, type CreateLeadsResponse, type CreateListCustomFieldInput, type CreateNoteInput, type CreateNotesResponse, type CreatePipelineInput, type CreatePipelineStatusInput, type CreatePipelinesResponse, type CreateRoleInput, type CreateSipUnsortedLeadInput, type CreateSourceInput, type CreateSourcesResponse, type CreateStatusInput, type CreateStatusesResponse, type CreateTagInput, type CreateTagRef, type CreateTagsResponse, type CreateTaskInput, type CreateTasksResponse, type CreateUnsortedCompany, type CreateUnsortedContact, type CreateUnsortedLead, type CreateUnsortedLeadsResponse, type CreateUserInput, type CreateWebhookInput, type CreateWebsiteButtonInput, type CreateWebsiteButtonResponse, type CustomField, type CustomFieldEnum, type CustomFieldGroup, CustomFieldGroupsResource, type CustomFieldNestedValue, type CustomFieldRequiredStatus, type CustomFieldType, type CustomFieldValue, CustomFieldsResource, type DeleteChatTemplateInput, type DeleteEntityLinkInput, type DeleteFilesItem, type DeleteSourceBatchInput, type DeleteWebhookInput, type DetachFilesFromEntityItem, type Embedded, type EntityAttachedFileRecord, type EntityCustomField, EntityFilesResource, type EntityLink, type EntityLinkMetadata, type EntityLinkWithSource, type EntityRights, type EntityType, type EntityUpdateResult, type Event, type EventTypeDefinition, type EventValueChange, type EventValueFilters, type EventWithParam, EventsResource, type FileAttachEntityType, type FileLinkedEntityRecord, FileLinksResource, type FileRecord, type FileVersionRecord, FilesResource, FilesServiceResource, type FormMetadata, type GeolocationNoteParams, type GetAccountParams, KNOWN_WEBHOOK_EVENTS, KOMMO_PIPELINE_STAGE_COLORS, KOMMO_TAG_COLORS, type KnownEventType, KommoApiError, KommoClient, type KommoConfig, type KommoPipelineStageColor, type Lead, type LeadCatalogElementRef, type LeadCompanyRef, type LeadContactRef, type LeadTag, type LeadTagRef, type LeadWithParam, LeadsResource, type LinkMetadataInput, type LinkSourceEntityType, type LinkTargetEntityType, type LinkUnsortedLeadResponse, LinksResource, type ListCatalogElementsParams, type ListCatalogElementsResponse, type ListCatalogsParams, type ListCatalogsResponse, type ListChatTemplatesParams, type ListChatTemplatesResponse, type ListCompaniesParams, type ListCompaniesResponse, type ListContactsParams, type ListContactsResponse, type ListCustomField, type ListCustomFieldGroupsResponse, type ListEntityAttachedFilesParams, type ListEntityAttachedFilesResponse, type ListEntityCustomFieldsResponse, type ListEntityLinksParams, type ListEntityLinksResponse, type ListEntityNotesParams, type ListEventTypesParams, type ListEventTypesResponse, type ListEventsParams, type ListEventsResponse, type ListFileLinkedEntitiesResponse, type ListFileVersionsResponse, type ListFilesParams, type ListFilesResponse, type ListLeadsParams, type ListLeadsResponse, type ListListCustomFieldsResponse, type ListLossReasonsResponse, type ListNotesResponse, type ListPipelineStatusesResponse, type ListPipelinesResponse, type ListRolesParams, type ListRolesResponse, type ListSalesbotsParams, type ListSalesbotsResponse, type ListSourcesResponse, type ListTagsParams, type ListTagsResponse, type ListTalksParams, type ListTalksResponse, type ListTasksParams, type ListTasksResponse, type ListUnsortedLeadsParams, type ListUnsortedLeadsResponse, type ListUsersParams, type ListUsersResponse, type ListWebhooksParams, type ListWebhooksResponse, type ListWebsiteButtonsParams, type ListWebsiteButtonsResponse, type LossReason, type Note, type NoteEntityType, type NoteParams, type NoteType, NotesResource, type PermissionLevel, type Pipeline, type PipelineStatus, PipelinesResource, type RestoreFilesItem, type RetryConfig, type Role, type RoleWithParam, RolesResource, type RunManySalesbotsItem, type RunSalesbotInput, type Salesbot, type SalesbotContinueBotType, type SalesbotContinueInput, type SalesbotExecuteHandler, type SalesbotFunctionalityType, SalesbotsResource, type ServiceMessageNoteParams, type SipMetadata, type SmsNoteParams, type Source, type SourceService, type SourceServicePage, SourcesResource, type StatusDescription, type StatusRight, type StopSalesbotInput, type SubmitWhatsAppTemplateReviewResponse, type Tag, type TagColor, type TagEntityType, type TagRefInput, TagsResource, type Talk, type TalkEntityType, type TalkStatus, TalksResource, type Task, TasksResource, type UnsortedDecisionResponse, type UnsortedLead, UnsortedResource, type UnsortedSummaryParams, type UnsortedSummaryResponse, type UpdateCatalogElementInput, type UpdateCatalogElementsResponse, type UpdateCatalogInput, type UpdateCatalogsResponse, type UpdateChatTemplateInput, type UpdateChatTemplatesResponse, type UpdateCompaniesResponse, type UpdateCompanyInput, type UpdateContactInput, type UpdateContactsResponse, type UpdateCustomFieldGroupInput, type UpdateEntityCustomFieldInput, type UpdateEntityTagsBatchResponse, type UpdateEntityTagsInput, type UpdateEntityTagsSingleResponse, type UpdateFileInput, type UpdateLeadInput, type UpdateLeadsResponse, type UpdateListCustomFieldInput, type UpdateNoteInput, type UpdateNotesResponse, type UpdatePipelineInput, type UpdateRoleInput, type UpdateSingleCatalogElementInput, type UpdateSingleCatalogInput, type UpdateSingleCompanyInput, type UpdateSingleContactInput, type UpdateSingleEntityCustomFieldInput, type UpdateSingleEntityTagsInput, type UpdateSingleLeadInput, type UpdateSingleListCustomFieldInput, type UpdateSingleNoteInput, type UpdateSingleTaskInput, type UpdateSourceBatchInput, type UpdateSourceInput, type UpdateSourcesResponse, type UpdateStatusInput, type UpdateTaskInput, type UpdateTasksResponse, type UpdateWebsiteButtonInput, type UpdateWhatsAppTemplateReviewStatusInput, type UpdateWhatsAppTemplateReviewStatusResponse, type UploadFilePartInput, type UploadFilePartResponse, type UploadSessionResponse, type User, type UserWithParam, UsersResource, type WabaCategory, type WabaHeaderType, type WabaReviewStatus, type Webhook, type WebhookEvent, WebhooksResource, type WebsiteButton, type WebsiteButtonCreationStatus, WebsiteButtonsResource, type WhatsAppTemplateModerationStatus, eventUtils };

package/dist/index.js

@@ -56,6 +56,7 @@ __export(index_exports, {
   SalesbotsResource: () => SalesbotsResource,
   SourcesResource: () => SourcesResource,
   TagsResource: () => TagsResource,
+  TalksResource: () => TalksResource,
   TasksResource: () => TasksResource,
   UnsortedResource: () => UnsortedResource,
   UsersResource: () => UsersResource,
@@ -67,7 +68,7 @@ module.exports = __toCommonJS(index_exports);
 
 // src/client.ts
 var import_axios2 = __toESM(require("axios"));
-var import_qs18 = __toESM(require("qs"));
+var import_qs19 = __toESM(require("qs"));
 
 // src/auth.ts
 var import_axios = __toESM(require("axios"));
@@ -108,12 +109,30 @@ var AuthManager = class {
 // src/resources/leads/index.ts
 var import_qs = __toESM(require("qs"));
 
+// src/utils/idempotency.ts
+var import_crypto = require("crypto");
+function ensureRequestId(item) {
+  if (item.request_id) return item;
+  return { ...item, request_id: (0, import_crypto.randomUUID)() };
+}
+
 // src/base.ts
 var BaseResource = class {
   client;
   constructor(client) {
     this.client = client;
   }
+  /**
+   * POST de criação em lote marcado como seguro para retry: cada item recebe um
+   * request_id (se ainda não tiver um) para que a Kommo deduplique reenvios após
+   * falhas transitórias de rede, e a requisição fica elegível ao retry automático.
+   */
+  async postIdempotent(url, items) {
+    const payload = items.map(ensureRequestId);
+    const config = { _idempotentRetry: true };
+    const response = await this.client.post(url, payload, config);
+    return response.data;
+  }
 };
 
 // src/resources/leads/index.ts
@@ -185,8 +204,7 @@ var LeadsResource = class extends BaseResource {
   }
   async create(items) {
     const payload = Array.isArray(items) ? items : [items];
-    const response = await this.client.post("/api/v4/leads", payload);
-    return response.data;
+    return this.postIdempotent("/api/v4/leads", payload);
   }
   async update(items) {
     const payload = Array.isArray(items) ? items : [items];
@@ -199,8 +217,7 @@ var LeadsResource = class extends BaseResource {
   }
   async createComplex(items) {
     const payload = Array.isArray(items) ? items : [items];
-    const response = await this.client.post("/api/v4/leads/complex", payload);
-    return response.data;
+    return this.postIdempotent("/api/v4/leads/complex", payload);
   }
   async listLossReasons() {
     const response = await this.client.get("/api/v4/leads/loss_reasons");
@@ -277,8 +294,7 @@ var ContactsResource = class extends BaseResource {
   }
   async create(items) {
     const payload = Array.isArray(items) ? items : [items];
-    const response = await this.client.post("/api/v4/contacts", payload);
-    return response.data;
+    return this.postIdempotent("/api/v4/contacts", payload);
   }
   async update(items) {
     const payload = Array.isArray(items) ? items : [items];
@@ -745,8 +761,7 @@ var CompaniesResource = class extends BaseResource {
   }
   async create(items) {
     const payload = Array.isArray(items) ? items : [items];
-    const response = await this.client.post("/api/v4/companies", payload);
-    return response.data;
+    return this.postIdempotent("/api/v4/companies", payload);
   }
   async update(items) {
     const payload = Array.isArray(items) ? items : [items];
@@ -1414,6 +1429,33 @@ var AccountResource = class extends BaseResource {
   }
 };
 
+// src/resources/talks/index.ts
+var import_qs18 = __toESM(require("qs"));
+var TalksResource = class extends BaseResource {
+  async list(params) {
+    const queryParams = {};
+    if (params) {
+      if (params.page !== void 0) queryParams.page = params.page;
+      if (params.limit !== void 0) queryParams.limit = params.limit;
+      if (params.filter_talk_id !== void 0) queryParams.filter = { ...queryParams.filter, talk_id: params.filter_talk_id };
+      if (params.filter_contact_id !== void 0) queryParams.filter = { ...queryParams.filter, contact_id: params.filter_contact_id };
+      if (params.filter_entity_id !== void 0) queryParams.filter = { ...queryParams.filter, entity_id: params.filter_entity_id };
+      if (params.filter_entity_type !== void 0) queryParams.filter = { ...queryParams.filter, entity_type: params.filter_entity_type };
+      if (params.filter_only_in_work) queryParams.filter = { ...queryParams.filter, only_in_work: "" };
+    }
+    const query = import_qs18.default.stringify(queryParams, { skipNulls: true, arrayFormat: "brackets" });
+    const qsStr = query ? `?${query}` : "";
+    const response = await this.client.get(`/api/v4/talks${qsStr}`);
+    if (response.status === 204 || !response.data) {
+      return { _page: 1, _embedded: { talks: [] } };
+    }
+    return response.data;
+  }
+  async close(id, params) {
+    await this.client.post(`/api/v4/talks/${id}/close`, params ?? {});
+  }
+};
+
 // src/errors.ts
 var KommoApiError = class extends Error {
   status;
@@ -1434,6 +1476,47 @@ var KommoApiError = class extends Error {
   }
 };
 
+// src/http/retry.ts
+var IDEMPOTENT_METHODS = /* @__PURE__ */ new Set(["get", "delete", "patch", "put", "head", "options"]);
+var TRANSIENT_ERROR_CODES = /* @__PURE__ */ new Set([
+  "ECONNRESET",
+  "ECONNABORTED",
+  "ETIMEDOUT",
+  "EAI_AGAIN",
+  "EPIPE"
+]);
+function isTransientNetworkError(error) {
+  if (error.response) return false;
+  if (error.code && TRANSIENT_ERROR_CODES.has(error.code)) return true;
+  return /socket hang up|network error/i.test(error.message || "");
+}
+function isRetryableRequest(config) {
+  const method = (config.method || "get").toLowerCase();
+  if (IDEMPOTENT_METHODS.has(method)) return true;
+  return method === "post" && config._idempotentRetry === true;
+}
+function wait(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+function attachRetryInterceptor(client, retryConfig = {}) {
+  const { retries = 2, baseDelayMs = 300, maxDelayMs = 3e3 } = retryConfig;
+  client.interceptors.response.use(void 0, async (error) => {
+    const config = error.config;
+    if (!config || retries <= 0 || !isTransientNetworkError(error) || !isRetryableRequest(config)) {
+      throw error;
+    }
+    const attempt = config._retryCount ?? 0;
+    if (attempt >= retries) {
+      throw error;
+    }
+    config._retryCount = attempt + 1;
+    const backoff = Math.min(maxDelayMs, baseDelayMs * 2 ** attempt);
+    const jitter = backoff * 0.3 * Math.random();
+    await wait(backoff + jitter);
+    return client.request(config);
+  });
+}
+
 // src/client.ts
 var KommoClient = class {
   config;
@@ -1461,6 +1544,7 @@ var KommoClient = class {
   webhooks;
   files;
   account;
+  talks;
   constructor(config) {
     this.config = config;
     this.auth = new AuthManager(
@@ -1472,13 +1556,17 @@ var KommoClient = class {
     const baseURL = `https://${config.domain}.kommo.com`;
     this.httpClient = import_axios2.default.create({
       baseURL,
+      timeout: config.timeout ?? 3e4,
       headers: {
         "Content-Type": "application/json"
       },
       paramsSerializer: (params) => {
-        return import_qs18.default.stringify(params, { arrayFormat: "brackets" });
+        return import_qs19.default.stringify(params, { arrayFormat: "brackets" });
       }
     });
+    if (config.retry !== false) {
+      attachRetryInterceptor(this.httpClient, config.retry || {});
+    }
     this.httpClient.interceptors.response.use(
       (response) => response,
       (error) => {
@@ -1520,6 +1608,7 @@ var KommoClient = class {
     this.webhooks = new WebhooksResource(this.httpClient);
     this.files = new FilesResource(this.httpClient);
     this.account = new AccountResource(this.httpClient);
+    this.talks = new TalksResource(this.httpClient);
   }
   setAccessToken(token) {
     this.config.accessToken = token;
@@ -1648,6 +1737,7 @@ var KNOWN_WEBHOOK_EVENTS = [
   SalesbotsResource,
   SourcesResource,
   TagsResource,
+  TalksResource,
   TasksResource,
   UnsortedResource,
   UsersResource,