@magnetcustomer/sdk 1.0.1 → 2.1.0

package/dist/generated/api/contacts-api.js

@@ -0,0 +1,448 @@
+"use strict";
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * API da Magnet Customer
+ * A API REST da Magnet Customer permite ler e gravar os registros do CRM a partir dos seus sistemas.  # Comece aqui  ## 1. Crie um Service Account  No CRM, abra **Configurações › Service Accounts** (apenas administradores), clique em **Novo service account**, escolha a validade e as permissões, e copie o **Client ID** e o **Client Secret**. O secret aparece uma única vez.  ## 2. Solicite um token  ```bash curl -X POST https://magnetcustomer.net/realms/platform/protocol/openid-connect/token \\   -H \"Content-Type: application/x-www-form-urlencoded\" \\   -d \"grant_type=client_credentials\" \\   -d \"client_id=SEU_CLIENT_ID\" \\   -d \"client_secret=SEU_CLIENT_SECRET\" ```  ```json { \"access_token\": \"eyJhbGciOiJSUzI1NiIs...\", \"expires_in\": 900, \"token_type\": \"Bearer\" } ```  O token vale 15 minutos e este fluxo não tem refresh token: quando vencer, ou ao receber `401`, repita o pedido.  ## 3. Chame a API  Cada conta tem o seu endereço. Troque `sua-conta` pelo subdomínio que você usa para abrir o CRM:  ```bash curl \"https://sua-conta.platform-api.magnetcustomer.com/api/deals?page=1&limit=15\" \\   -H \"Authorization: Bearer SEU_TOKEN\" ```  Requisições com corpo levam também `Content-Type: application/json`.  # Convenções  ## Paginação  Envie sempre `page`. Com ele, toda listagem devolve o mesmo envelope:  ```json { \"docs\": [], \"total\": 132, \"pages\": 9, \"page\": 1, \"limit\": 15 } ```  | Parâmetro | Padrão | Descrição | |---|---|---| | `page` | — | Página, a partir de 1. **Obrigatório na prática** | | `limit` | 15 | Registros por página. Máximo 100: acima disso a API usa 100 | | `sortBy` | varia por recurso | Campo de ordenação | | `sortType` | `desc` | `asc` ou `desc` | | `search` | — | Busca textual, quando o recurso aceita |  Sem `page`, algumas listagens (Contatos, Pipelines, Campos personalizados e os cadastros de apoio, como tipos e situações) devolvem uma lista simples (`[...]`), sem o envelope, e ignoram `limit`. Para percorrer tudo, peça `page=1` e avance até `page` ser igual a `pages`. Uma página além do fim devolve `docs` vazio.  O tamanho de página padrão é 15, com duas exceções: 25 em Leads, Prospects e Clientes, e 100 em Usuários. Um `limit` inválido cai no padrão.  ## Identificadores e datas  Todo ID é um texto de 24 caracteres hexadecimais, como `507f1f77bcf86cd799439011`. Ao gravar, envie a referência como **ID em texto** — nunca o objeto.  Um ID fora desse formato hoje é respondido com `500`, não `400`: valide o formato antes de enviar.  No corpo e nas respostas, datas são ISO 8601 em UTC, como `2026-05-15T10:00:00Z`. Nos filtros de data da URL (`minDate`, `createdAt_minDate`, `dateOfExpires_minDate`...), envie um **timestamp em milissegundos**, como `1798761600000`.  ## Listas na URL  Filtros que aceitam vários valores levam colchetes no nome, mesmo quando o valor é um só:  ``` /api/contacts?page=1&staffs[]=507f191e810c19729de860eb&staffs[]=507f191e810c19729de860ec ```  Sem colchetes, um valor único é recusado com erro em parte das listagens.  ## Campos ausentes  Campo sem valor costuma vir **ausente** da resposta, não como `null`. Trate a falta da chave como vazio.  ## Campos personalizados  Os campos criados pelo administrador da conta vão na lista `customFields`:  ```json { \"customFields\": [ { \"customField\": \"507f1f77bcf86cd799439014\", \"k\": \"segmento\", \"v\": \"Tecnologia\" } ] } ```  O valor vai em **`v`**. Um item com `value` é aceito sem erro, mas o campo fica vazio. Descubra os campos e os IDs com `GET /api/customfields?page=1&feature=deal` (troque `deal` por `meeting`, `task`, `contact`...). Com `&required=true` vêm só os obrigatórios da conta.  ## Erros  ```json {   \"reason\": \"Missing required parameters\",   \"message\": \"Missing required parameters\",   \"code\": \"VALIDATION_ERROR\",   \"errors\": [ { \"field\": \"title\", \"message\": \"must NOT have fewer than 1 characters\", \"keyword\": \"minLength\" } ] } ```  | Status | Quando | |---|---| | `400` | Corpo inválido: campo obrigatório ausente, tipo errado, valor fora da lista | | `401` | Token ausente, inválido ou vencido. Corpo: `{\"reason\": \"Access Denied\"}` | | `403` | O Service Account não tem a permissão da rota (`type: SA_PERMISSION_DENIED`, com `requiredPermission`) | | `404` | Registro não encontrado | | `409` | O registro não está no estado que a operação exige | | `429` | Limite de requisições excedido. Espere o tempo de `Retry-After` |  ## Permissões  Um Service Account só chama as rotas que as permissões dele liberam. Cada operação desta referência informa a permissão exigida, quando há uma: marque-a ao criar o Service Account. Uma chamada sem a permissão devolve `403` com o nome dela em `requiredPermission`.  Rotas de administração da conta (usuários, perfis, criação de webhooks, configurações) exigem um usuário administrador e não estão disponíveis para Service Accounts; por isso não aparecem aqui.  ## Limite de requisições  Os limites são aplicados por conta. Ao receber `429`, espere os segundos indicados em `Retry-After` e tente de novo com intervalo crescente.  ## Área de trabalho  Em contas com áreas de trabalho, a API define a área do registro pela credencial ou pelo registro pai. Não envie `workspace`.  # Webhooks  Para ser avisado quando algo muda no CRM, em vez de consultar a API de tempos em tempos, use webhooks. Um administrador cria o webhook no CRM, em **Integrações › Webhooks**, informando a URL do seu sistema e os eventos. A lista de eventos está em `GET /api/webhooks/triggers`; o formato da entrega, a assinatura e os reenvios estão na seção Webhooks do portal.  # Cobertura  Esta referência cobre Contatos (leads, prospects e clientes), Empresas, Oportunidades, Pipelines, etapas e motivos de perda, Jornadas, Reuniões, Tarefas, Observações, Tickets, Atendimentos, Usuários, Equipes, Áreas de trabalho, Campos personalizados e os eventos de webhook.
+ *
+ * The version of the OpenAPI document: 2026-11
+ * Contact: suporte@magnetcustomer.com
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ListContactsLifeCycleEnum = exports.ListContactsSortTypeEnum = exports.ContactsApi = exports.ContactsApiFactory = exports.ContactsApiFp = exports.ContactsApiAxiosParamCreator = void 0;
+const axios_1 = __importDefault(require("axios"));
+// Some imports not used depending on template conditions
+// @ts-ignore
+const common_1 = require("../common");
+// @ts-ignore
+const base_1 = require("../base");
+/**
+ * ContactsApi - axios parameter creator
+ */
+const ContactsApiAxiosParamCreator = function (configuration) {
+    return {
+        /**
+         * O corpo não tem campo obrigatório fixo: o administrador da conta define quais são. `GET /api/customfields?feature=contact&required=true` devolve os campos obrigatórios da conta. Quando falta um deles, a API responde `400` com `code: MISSING_REQUIRED` e a lista em `fields`.  **Permissão do Service Account:** `contacts.create`
+         * @summary Criar contato
+         * @param {ContactInput} contactInput
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        createContact: async (contactInput, options = {}) => {
+            // verify required parameter 'contactInput' is not null or undefined
+            (0, common_1.assertParamExists)('createContact', 'contactInput', contactInput);
+            const localVarPath = `/api/contacts`;
+            // use dummy base URL string because the URL constructor only accepts absolute URLs.
+            const localVarUrlObj = new URL(localVarPath, common_1.DUMMY_BASE_URL);
+            let baseOptions;
+            if (configuration) {
+                baseOptions = configuration.baseOptions;
+            }
+            const localVarRequestOptions = { method: 'POST', ...baseOptions, ...options };
+            const localVarHeaderParameter = {};
+            const localVarQueryParameter = {};
+            // authentication ServiceAccount required
+            // oauth required
+            await (0, common_1.setOAuthToObject)(localVarHeaderParameter, "ServiceAccount", [], configuration);
+            localVarHeaderParameter['Content-Type'] = 'application/json';
+            localVarHeaderParameter['Accept'] = 'application/json';
+            (0, common_1.setSearchParams)(localVarUrlObj, localVarQueryParameter);
+            let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
+            localVarRequestOptions.headers = { ...localVarHeaderParameter, ...headersFromBaseOptions, ...options.headers };
+            localVarRequestOptions.data = (0, common_1.serializeDataIfNeeded)(contactInput, localVarRequestOptions, configuration);
+            return {
+                url: (0, common_1.toPathString)(localVarUrlObj),
+                options: localVarRequestOptions,
+            };
+        },
+        /**
+         * Exige a permissão de excluir.  **Permissão do Service Account:** `contacts.delete`
+         * @summary Excluir contato
+         * @param {string} id ID do registro.
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        deleteContact: async (id, options = {}) => {
+            // verify required parameter 'id' is not null or undefined
+            (0, common_1.assertParamExists)('deleteContact', 'id', id);
+            const localVarPath = `/api/contacts/{id}`
+                .replace(`{${"id"}}`, encodeURIComponent(String(id)));
+            // use dummy base URL string because the URL constructor only accepts absolute URLs.
+            const localVarUrlObj = new URL(localVarPath, common_1.DUMMY_BASE_URL);
+            let baseOptions;
+            if (configuration) {
+                baseOptions = configuration.baseOptions;
+            }
+            const localVarRequestOptions = { method: 'DELETE', ...baseOptions, ...options };
+            const localVarHeaderParameter = {};
+            const localVarQueryParameter = {};
+            // authentication ServiceAccount required
+            // oauth required
+            await (0, common_1.setOAuthToObject)(localVarHeaderParameter, "ServiceAccount", [], configuration);
+            localVarHeaderParameter['Accept'] = 'application/json';
+            (0, common_1.setSearchParams)(localVarUrlObj, localVarQueryParameter);
+            let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
+            localVarRequestOptions.headers = { ...localVarHeaderParameter, ...headersFromBaseOptions, ...options.headers };
+            return {
+                url: (0, common_1.toPathString)(localVarUrlObj),
+                options: localVarRequestOptions,
+            };
+        },
+        /**
+         * **Permissão do Service Account:** `contacts.read`
+         * @summary Obter contato
+         * @param {string} id ID do registro.
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        getContact: async (id, options = {}) => {
+            // verify required parameter 'id' is not null or undefined
+            (0, common_1.assertParamExists)('getContact', 'id', id);
+            const localVarPath = `/api/contacts/{id}`
+                .replace(`{${"id"}}`, encodeURIComponent(String(id)));
+            // use dummy base URL string because the URL constructor only accepts absolute URLs.
+            const localVarUrlObj = new URL(localVarPath, common_1.DUMMY_BASE_URL);
+            let baseOptions;
+            if (configuration) {
+                baseOptions = configuration.baseOptions;
+            }
+            const localVarRequestOptions = { method: 'GET', ...baseOptions, ...options };
+            const localVarHeaderParameter = {};
+            const localVarQueryParameter = {};
+            // authentication ServiceAccount required
+            // oauth required
+            await (0, common_1.setOAuthToObject)(localVarHeaderParameter, "ServiceAccount", [], configuration);
+            localVarHeaderParameter['Accept'] = 'application/json';
+            (0, common_1.setSearchParams)(localVarUrlObj, localVarQueryParameter);
+            let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
+            localVarRequestOptions.headers = { ...localVarHeaderParameter, ...headersFromBaseOptions, ...options.headers };
+            return {
+                url: (0, common_1.toPathString)(localVarUrlObj),
+                options: localVarRequestOptions,
+            };
+        },
+        /**
+         * Ordenação padrão: `fullname` crescente. Devolve só os registros ativos.  **Permissão do Service Account:** `contacts.list`
+         * @summary Listar contatos
+         * @param {number} [page] Página, a partir de 1. **Envie sempre**: sem `page`, a resposta vem como lista simples, sem o envelope de paginação, e `limit` é ignorado.
+         * @param {number} [limit] Registros por página. Padrão: 15, salvo indicação na operação. Máximo: 100 — acima disso a API usa 100.
+         * @param {string} [sortBy] Campo de ordenação. O padrão varia por recurso.
+         * @param {ListContactsSortTypeEnum} [sortType] Direção da ordenação.
+         * @param {Array<string>} [staffs] Usuários responsáveis. Lista de IDs: envie com colchetes, mesmo para um só valor (&#x60;?staffs[]&#x3D;id1&amp;staffs[]&#x3D;id2&#x60;).
+         * @param {string} [organization] ID da empresa vinculada.
+         * @param {string} [search] Busca em nome, e-mail, telefone e documento.
+         * @param {boolean} [emailsEmpty] Com &#x60;true&#x60;, só os sem e-mail.
+         * @param {boolean} [phonesEmpty] Com &#x60;true&#x60;, só os sem telefone.
+         * @param {ListContactsLifeCycleEnum} [lifeCycle] Fase do contato.
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        listContacts: async (page, limit, sortBy, sortType, staffs, organization, search, emailsEmpty, phonesEmpty, lifeCycle, options = {}) => {
+            const localVarPath = `/api/contacts`;
+            // use dummy base URL string because the URL constructor only accepts absolute URLs.
+            const localVarUrlObj = new URL(localVarPath, common_1.DUMMY_BASE_URL);
+            let baseOptions;
+            if (configuration) {
+                baseOptions = configuration.baseOptions;
+            }
+            const localVarRequestOptions = { method: 'GET', ...baseOptions, ...options };
+            const localVarHeaderParameter = {};
+            const localVarQueryParameter = {};
+            // authentication ServiceAccount required
+            // oauth required
+            await (0, common_1.setOAuthToObject)(localVarHeaderParameter, "ServiceAccount", [], configuration);
+            if (page !== undefined) {
+                localVarQueryParameter['page'] = page;
+            }
+            if (limit !== undefined) {
+                localVarQueryParameter['limit'] = limit;
+            }
+            if (sortBy !== undefined) {
+                localVarQueryParameter['sortBy'] = sortBy;
+            }
+            if (sortType !== undefined) {
+                localVarQueryParameter['sortType'] = sortType;
+            }
+            if (staffs) {
+                localVarQueryParameter['staffs[]'] = staffs;
+            }
+            if (organization !== undefined) {
+                localVarQueryParameter['organization'] = organization;
+            }
+            if (search !== undefined) {
+                localVarQueryParameter['search'] = search;
+            }
+            if (emailsEmpty !== undefined) {
+                localVarQueryParameter['emailsEmpty'] = emailsEmpty;
+            }
+            if (phonesEmpty !== undefined) {
+                localVarQueryParameter['phonesEmpty'] = phonesEmpty;
+            }
+            if (lifeCycle !== undefined) {
+                localVarQueryParameter['lifeCycle'] = lifeCycle;
+            }
+            localVarHeaderParameter['Accept'] = 'application/json';
+            (0, common_1.setSearchParams)(localVarUrlObj, localVarQueryParameter);
+            let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
+            localVarRequestOptions.headers = { ...localVarHeaderParameter, ...headersFromBaseOptions, ...options.headers };
+            return {
+                url: (0, common_1.toPathString)(localVarUrlObj),
+                options: localVarRequestOptions,
+            };
+        },
+        /**
+         * Envie só os campos que mudam.  **Permissão do Service Account:** `contacts.update`
+         * @summary Atualizar contato
+         * @param {string} id ID do registro.
+         * @param {ContactInput} contactInput
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        updateContact: async (id, contactInput, options = {}) => {
+            // verify required parameter 'id' is not null or undefined
+            (0, common_1.assertParamExists)('updateContact', 'id', id);
+            // verify required parameter 'contactInput' is not null or undefined
+            (0, common_1.assertParamExists)('updateContact', 'contactInput', contactInput);
+            const localVarPath = `/api/contacts/{id}`
+                .replace(`{${"id"}}`, encodeURIComponent(String(id)));
+            // use dummy base URL string because the URL constructor only accepts absolute URLs.
+            const localVarUrlObj = new URL(localVarPath, common_1.DUMMY_BASE_URL);
+            let baseOptions;
+            if (configuration) {
+                baseOptions = configuration.baseOptions;
+            }
+            const localVarRequestOptions = { method: 'PUT', ...baseOptions, ...options };
+            const localVarHeaderParameter = {};
+            const localVarQueryParameter = {};
+            // authentication ServiceAccount required
+            // oauth required
+            await (0, common_1.setOAuthToObject)(localVarHeaderParameter, "ServiceAccount", [], configuration);
+            localVarHeaderParameter['Content-Type'] = 'application/json';
+            localVarHeaderParameter['Accept'] = 'application/json';
+            (0, common_1.setSearchParams)(localVarUrlObj, localVarQueryParameter);
+            let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
+            localVarRequestOptions.headers = { ...localVarHeaderParameter, ...headersFromBaseOptions, ...options.headers };
+            localVarRequestOptions.data = (0, common_1.serializeDataIfNeeded)(contactInput, localVarRequestOptions, configuration);
+            return {
+                url: (0, common_1.toPathString)(localVarUrlObj),
+                options: localVarRequestOptions,
+            };
+        },
+    };
+};
+exports.ContactsApiAxiosParamCreator = ContactsApiAxiosParamCreator;
+/**
+ * ContactsApi - functional programming interface
+ */
+const ContactsApiFp = function (configuration) {
+    const localVarAxiosParamCreator = (0, exports.ContactsApiAxiosParamCreator)(configuration);
+    return {
+        /**
+         * O corpo não tem campo obrigatório fixo: o administrador da conta define quais são. `GET /api/customfields?feature=contact&required=true` devolve os campos obrigatórios da conta. Quando falta um deles, a API responde `400` com `code: MISSING_REQUIRED` e a lista em `fields`.  **Permissão do Service Account:** `contacts.create`
+         * @summary Criar contato
+         * @param {ContactInput} contactInput
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        async createContact(contactInput, options) {
+            const localVarAxiosArgs = await localVarAxiosParamCreator.createContact(contactInput, options);
+            const localVarOperationServerIndex = configuration?.serverIndex ?? 0;
+            const localVarOperationServerBasePath = base_1.operationServerMap['ContactsApi.createContact']?.[localVarOperationServerIndex]?.url;
+            return (axios, basePath) => (0, common_1.createRequestFunction)(localVarAxiosArgs, axios_1.default, base_1.BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
+        },
+        /**
+         * Exige a permissão de excluir.  **Permissão do Service Account:** `contacts.delete`
+         * @summary Excluir contato
+         * @param {string} id ID do registro.
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        async deleteContact(id, options) {
+            const localVarAxiosArgs = await localVarAxiosParamCreator.deleteContact(id, options);
+            const localVarOperationServerIndex = configuration?.serverIndex ?? 0;
+            const localVarOperationServerBasePath = base_1.operationServerMap['ContactsApi.deleteContact']?.[localVarOperationServerIndex]?.url;
+            return (axios, basePath) => (0, common_1.createRequestFunction)(localVarAxiosArgs, axios_1.default, base_1.BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
+        },
+        /**
+         * **Permissão do Service Account:** `contacts.read`
+         * @summary Obter contato
+         * @param {string} id ID do registro.
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        async getContact(id, options) {
+            const localVarAxiosArgs = await localVarAxiosParamCreator.getContact(id, options);
+            const localVarOperationServerIndex = configuration?.serverIndex ?? 0;
+            const localVarOperationServerBasePath = base_1.operationServerMap['ContactsApi.getContact']?.[localVarOperationServerIndex]?.url;
+            return (axios, basePath) => (0, common_1.createRequestFunction)(localVarAxiosArgs, axios_1.default, base_1.BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
+        },
+        /**
+         * Ordenação padrão: `fullname` crescente. Devolve só os registros ativos.  **Permissão do Service Account:** `contacts.list`
+         * @summary Listar contatos
+         * @param {number} [page] Página, a partir de 1. **Envie sempre**: sem &#x60;page&#x60;, a resposta vem como lista simples, sem o envelope de paginação, e &#x60;limit&#x60; é ignorado.
+         * @param {number} [limit] Registros por página. Padrão: 15, salvo indicação na operação. Máximo: 100 — acima disso a API usa 100.
+         * @param {string} [sortBy] Campo de ordenação. O padrão varia por recurso.
+         * @param {ListContactsSortTypeEnum} [sortType] Direção da ordenação.
+         * @param {Array<string>} [staffs] Usuários responsáveis. Lista de IDs: envie com colchetes, mesmo para um só valor (&#x60;?staffs[]&#x3D;id1&amp;staffs[]&#x3D;id2&#x60;).
+         * @param {string} [organization] ID da empresa vinculada.
+         * @param {string} [search] Busca em nome, e-mail, telefone e documento.
+         * @param {boolean} [emailsEmpty] Com &#x60;true&#x60;, só os sem e-mail.
+         * @param {boolean} [phonesEmpty] Com &#x60;true&#x60;, só os sem telefone.
+         * @param {ListContactsLifeCycleEnum} [lifeCycle] Fase do contato.
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        async listContacts(page, limit, sortBy, sortType, staffs, organization, search, emailsEmpty, phonesEmpty, lifeCycle, options) {
+            const localVarAxiosArgs = await localVarAxiosParamCreator.listContacts(page, limit, sortBy, sortType, staffs, organization, search, emailsEmpty, phonesEmpty, lifeCycle, options);
+            const localVarOperationServerIndex = configuration?.serverIndex ?? 0;
+            const localVarOperationServerBasePath = base_1.operationServerMap['ContactsApi.listContacts']?.[localVarOperationServerIndex]?.url;
+            return (axios, basePath) => (0, common_1.createRequestFunction)(localVarAxiosArgs, axios_1.default, base_1.BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
+        },
+        /**
+         * Envie só os campos que mudam.  **Permissão do Service Account:** `contacts.update`
+         * @summary Atualizar contato
+         * @param {string} id ID do registro.
+         * @param {ContactInput} contactInput
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        async updateContact(id, contactInput, options) {
+            const localVarAxiosArgs = await localVarAxiosParamCreator.updateContact(id, contactInput, options);
+            const localVarOperationServerIndex = configuration?.serverIndex ?? 0;
+            const localVarOperationServerBasePath = base_1.operationServerMap['ContactsApi.updateContact']?.[localVarOperationServerIndex]?.url;
+            return (axios, basePath) => (0, common_1.createRequestFunction)(localVarAxiosArgs, axios_1.default, base_1.BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
+        },
+    };
+};
+exports.ContactsApiFp = ContactsApiFp;
+/**
+ * ContactsApi - factory interface
+ */
+const ContactsApiFactory = function (configuration, basePath, axios) {
+    const localVarFp = (0, exports.ContactsApiFp)(configuration);
+    return {
+        /**
+         * O corpo não tem campo obrigatório fixo: o administrador da conta define quais são. `GET /api/customfields?feature=contact&required=true` devolve os campos obrigatórios da conta. Quando falta um deles, a API responde `400` com `code: MISSING_REQUIRED` e a lista em `fields`.  **Permissão do Service Account:** `contacts.create`
+         * @summary Criar contato
+         * @param {ContactsApiCreateContactRequest} requestParameters Request parameters.
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        createContact(requestParameters, options) {
+            return localVarFp.createContact(requestParameters.contactInput, options).then((request) => request(axios, basePath));
+        },
+        /**
+         * Exige a permissão de excluir.  **Permissão do Service Account:** `contacts.delete`
+         * @summary Excluir contato
+         * @param {ContactsApiDeleteContactRequest} requestParameters Request parameters.
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        deleteContact(requestParameters, options) {
+            return localVarFp.deleteContact(requestParameters.id, options).then((request) => request(axios, basePath));
+        },
+        /**
+         * **Permissão do Service Account:** `contacts.read`
+         * @summary Obter contato
+         * @param {ContactsApiGetContactRequest} requestParameters Request parameters.
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        getContact(requestParameters, options) {
+            return localVarFp.getContact(requestParameters.id, options).then((request) => request(axios, basePath));
+        },
+        /**
+         * Ordenação padrão: `fullname` crescente. Devolve só os registros ativos.  **Permissão do Service Account:** `contacts.list`
+         * @summary Listar contatos
+         * @param {ContactsApiListContactsRequest} requestParameters Request parameters.
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        listContacts(requestParameters = {}, options) {
+            return localVarFp.listContacts(requestParameters.page, requestParameters.limit, requestParameters.sortBy, requestParameters.sortType, requestParameters.staffs, requestParameters.organization, requestParameters.search, requestParameters.emailsEmpty, requestParameters.phonesEmpty, requestParameters.lifeCycle, options).then((request) => request(axios, basePath));
+        },
+        /**
+         * Envie só os campos que mudam.  **Permissão do Service Account:** `contacts.update`
+         * @summary Atualizar contato
+         * @param {ContactsApiUpdateContactRequest} requestParameters Request parameters.
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        updateContact(requestParameters, options) {
+            return localVarFp.updateContact(requestParameters.id, requestParameters.contactInput, options).then((request) => request(axios, basePath));
+        },
+    };
+};
+exports.ContactsApiFactory = ContactsApiFactory;
+/**
+ * ContactsApi - object-oriented interface
+ */
+class ContactsApi extends base_1.BaseAPI {
+    /**
+     * O corpo não tem campo obrigatório fixo: o administrador da conta define quais são. `GET /api/customfields?feature=contact&required=true` devolve os campos obrigatórios da conta. Quando falta um deles, a API responde `400` com `code: MISSING_REQUIRED` e a lista em `fields`.  **Permissão do Service Account:** `contacts.create`
+     * @summary Criar contato
+     * @param {ContactsApiCreateContactRequest} requestParameters Request parameters.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    createContact(requestParameters, options) {
+        return (0, exports.ContactsApiFp)(this.configuration).createContact(requestParameters.contactInput, options).then((request) => request(this.axios, this.basePath));
+    }
+    /**
+     * Exige a permissão de excluir.  **Permissão do Service Account:** `contacts.delete`
+     * @summary Excluir contato
+     * @param {ContactsApiDeleteContactRequest} requestParameters Request parameters.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    deleteContact(requestParameters, options) {
+        return (0, exports.ContactsApiFp)(this.configuration).deleteContact(requestParameters.id, options).then((request) => request(this.axios, this.basePath));
+    }
+    /**
+     * **Permissão do Service Account:** `contacts.read`
+     * @summary Obter contato
+     * @param {ContactsApiGetContactRequest} requestParameters Request parameters.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    getContact(requestParameters, options) {
+        return (0, exports.ContactsApiFp)(this.configuration).getContact(requestParameters.id, options).then((request) => request(this.axios, this.basePath));
+    }
+    /**
+     * Ordenação padrão: `fullname` crescente. Devolve só os registros ativos.  **Permissão do Service Account:** `contacts.list`
+     * @summary Listar contatos
+     * @param {ContactsApiListContactsRequest} requestParameters Request parameters.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    listContacts(requestParameters = {}, options) {
+        return (0, exports.ContactsApiFp)(this.configuration).listContacts(requestParameters.page, requestParameters.limit, requestParameters.sortBy, requestParameters.sortType, requestParameters.staffs, requestParameters.organization, requestParameters.search, requestParameters.emailsEmpty, requestParameters.phonesEmpty, requestParameters.lifeCycle, options).then((request) => request(this.axios, this.basePath));
+    }
+    /**
+     * Envie só os campos que mudam.  **Permissão do Service Account:** `contacts.update`
+     * @summary Atualizar contato
+     * @param {ContactsApiUpdateContactRequest} requestParameters Request parameters.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    updateContact(requestParameters, options) {
+        return (0, exports.ContactsApiFp)(this.configuration).updateContact(requestParameters.id, requestParameters.contactInput, options).then((request) => request(this.axios, this.basePath));
+    }
+}
+exports.ContactsApi = ContactsApi;
+exports.ListContactsSortTypeEnum = {
+    asc: 'asc',
+    desc: 'desc',
+};
+exports.ListContactsLifeCycleEnum = {
+    lead: 'lead',
+    prospect: 'prospect',
+    customer: 'customer',
+};

package/dist/generated/api/custom-fields-api.d.ts

@@ -0,0 +1,118 @@
+/**
+ * API da Magnet Customer
+ * A API REST da Magnet Customer permite ler e gravar os registros do CRM a partir dos seus sistemas.  # Comece aqui  ## 1. Crie um Service Account  No CRM, abra **Configurações › Service Accounts** (apenas administradores), clique em **Novo service account**, escolha a validade e as permissões, e copie o **Client ID** e o **Client Secret**. O secret aparece uma única vez.  ## 2. Solicite um token  ```bash curl -X POST https://magnetcustomer.net/realms/platform/protocol/openid-connect/token \\   -H \"Content-Type: application/x-www-form-urlencoded\" \\   -d \"grant_type=client_credentials\" \\   -d \"client_id=SEU_CLIENT_ID\" \\   -d \"client_secret=SEU_CLIENT_SECRET\" ```  ```json { \"access_token\": \"eyJhbGciOiJSUzI1NiIs...\", \"expires_in\": 900, \"token_type\": \"Bearer\" } ```  O token vale 15 minutos e este fluxo não tem refresh token: quando vencer, ou ao receber `401`, repita o pedido.  ## 3. Chame a API  Cada conta tem o seu endereço. Troque `sua-conta` pelo subdomínio que você usa para abrir o CRM:  ```bash curl \"https://sua-conta.platform-api.magnetcustomer.com/api/deals?page=1&limit=15\" \\   -H \"Authorization: Bearer SEU_TOKEN\" ```  Requisições com corpo levam também `Content-Type: application/json`.  # Convenções  ## Paginação  Envie sempre `page`. Com ele, toda listagem devolve o mesmo envelope:  ```json { \"docs\": [], \"total\": 132, \"pages\": 9, \"page\": 1, \"limit\": 15 } ```  | Parâmetro | Padrão | Descrição | |---|---|---| | `page` | — | Página, a partir de 1. **Obrigatório na prática** | | `limit` | 15 | Registros por página. Máximo 100: acima disso a API usa 100 | | `sortBy` | varia por recurso | Campo de ordenação | | `sortType` | `desc` | `asc` ou `desc` | | `search` | — | Busca textual, quando o recurso aceita |  Sem `page`, algumas listagens (Contatos, Pipelines, Campos personalizados e os cadastros de apoio, como tipos e situações) devolvem uma lista simples (`[...]`), sem o envelope, e ignoram `limit`. Para percorrer tudo, peça `page=1` e avance até `page` ser igual a `pages`. Uma página além do fim devolve `docs` vazio.  O tamanho de página padrão é 15, com duas exceções: 25 em Leads, Prospects e Clientes, e 100 em Usuários. Um `limit` inválido cai no padrão.  ## Identificadores e datas  Todo ID é um texto de 24 caracteres hexadecimais, como `507f1f77bcf86cd799439011`. Ao gravar, envie a referência como **ID em texto** — nunca o objeto.  Um ID fora desse formato hoje é respondido com `500`, não `400`: valide o formato antes de enviar.  No corpo e nas respostas, datas são ISO 8601 em UTC, como `2026-05-15T10:00:00Z`. Nos filtros de data da URL (`minDate`, `createdAt_minDate`, `dateOfExpires_minDate`...), envie um **timestamp em milissegundos**, como `1798761600000`.  ## Listas na URL  Filtros que aceitam vários valores levam colchetes no nome, mesmo quando o valor é um só:  ``` /api/contacts?page=1&staffs[]=507f191e810c19729de860eb&staffs[]=507f191e810c19729de860ec ```  Sem colchetes, um valor único é recusado com erro em parte das listagens.  ## Campos ausentes  Campo sem valor costuma vir **ausente** da resposta, não como `null`. Trate a falta da chave como vazio.  ## Campos personalizados  Os campos criados pelo administrador da conta vão na lista `customFields`:  ```json { \"customFields\": [ { \"customField\": \"507f1f77bcf86cd799439014\", \"k\": \"segmento\", \"v\": \"Tecnologia\" } ] } ```  O valor vai em **`v`**. Um item com `value` é aceito sem erro, mas o campo fica vazio. Descubra os campos e os IDs com `GET /api/customfields?page=1&feature=deal` (troque `deal` por `meeting`, `task`, `contact`...). Com `&required=true` vêm só os obrigatórios da conta.  ## Erros  ```json {   \"reason\": \"Missing required parameters\",   \"message\": \"Missing required parameters\",   \"code\": \"VALIDATION_ERROR\",   \"errors\": [ { \"field\": \"title\", \"message\": \"must NOT have fewer than 1 characters\", \"keyword\": \"minLength\" } ] } ```  | Status | Quando | |---|---| | `400` | Corpo inválido: campo obrigatório ausente, tipo errado, valor fora da lista | | `401` | Token ausente, inválido ou vencido. Corpo: `{\"reason\": \"Access Denied\"}` | | `403` | O Service Account não tem a permissão da rota (`type: SA_PERMISSION_DENIED`, com `requiredPermission`) | | `404` | Registro não encontrado | | `409` | O registro não está no estado que a operação exige | | `429` | Limite de requisições excedido. Espere o tempo de `Retry-After` |  ## Permissões  Um Service Account só chama as rotas que as permissões dele liberam. Cada operação desta referência informa a permissão exigida, quando há uma: marque-a ao criar o Service Account. Uma chamada sem a permissão devolve `403` com o nome dela em `requiredPermission`.  Rotas de administração da conta (usuários, perfis, criação de webhooks, configurações) exigem um usuário administrador e não estão disponíveis para Service Accounts; por isso não aparecem aqui.  ## Limite de requisições  Os limites são aplicados por conta. Ao receber `429`, espere os segundos indicados em `Retry-After` e tente de novo com intervalo crescente.  ## Área de trabalho  Em contas com áreas de trabalho, a API define a área do registro pela credencial ou pelo registro pai. Não envie `workspace`.  # Webhooks  Para ser avisado quando algo muda no CRM, em vez de consultar a API de tempos em tempos, use webhooks. Um administrador cria o webhook no CRM, em **Integrações › Webhooks**, informando a URL do seu sistema e os eventos. A lista de eventos está em `GET /api/webhooks/triggers`; o formato da entrega, a assinatura e os reenvios estão na seção Webhooks do portal.  # Cobertura  Esta referência cobre Contatos (leads, prospects e clientes), Empresas, Oportunidades, Pipelines, etapas e motivos de perda, Jornadas, Reuniões, Tarefas, Observações, Tickets, Atendimentos, Usuários, Equipes, Áreas de trabalho, Campos personalizados e os eventos de webhook.
+ *
+ * The version of the OpenAPI document: 2026-11
+ * Contact: suporte@magnetcustomer.com
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+import type { Configuration } from '../configuration';
+import type { AxiosPromise, AxiosInstance, RawAxiosRequestConfig } from 'axios';
+import { type RequestArgs, BaseAPI } from '../base';
+import type { ListCustomFields200Response } from '../models';
+/**
+ * CustomFieldsApi - axios parameter creator
+ */
+export declare const CustomFieldsApiAxiosParamCreator: (configuration?: Configuration) => {
+    /**
+     * Devolve os campos de um recurso: os criados pelo administrador e os de sistema. É aqui que você descobre os IDs para `customFields` e quais campos a conta exige (`settings.required: true`).
+     * @summary Listar campos personalizados
+     * @param {number} [page] Página, a partir de 1. **Envie sempre**: sem `page`, a resposta vem como lista simples, sem o envelope de paginação, e `limit` é ignorado.
+     * @param {number} [limit] Registros por página. Padrão: 15, salvo indicação na operação. Máximo: 100 — acima disso a API usa 100.
+     * @param {ListCustomFieldsFeatureEnum} [feature] Recurso.
+     * @param {boolean} [system] Com `true`, só os campos de sistema; com `false`, só os criados pelo administrador.
+     * @param {boolean} [required] Com `true`, só os obrigatórios.
+     * @param {string} [search] Busca no nome.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    listCustomFields: (page?: number, limit?: number, feature?: ListCustomFieldsFeatureEnum, system?: boolean, required?: boolean, search?: string, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+};
+/**
+ * CustomFieldsApi - functional programming interface
+ */
+export declare const CustomFieldsApiFp: (configuration?: Configuration) => {
+    /**
+     * Devolve os campos de um recurso: os criados pelo administrador e os de sistema. É aqui que você descobre os IDs para `customFields` e quais campos a conta exige (`settings.required: true`).
+     * @summary Listar campos personalizados
+     * @param {number} [page] Página, a partir de 1. **Envie sempre**: sem &#x60;page&#x60;, a resposta vem como lista simples, sem o envelope de paginação, e &#x60;limit&#x60; é ignorado.
+     * @param {number} [limit] Registros por página. Padrão: 15, salvo indicação na operação. Máximo: 100 — acima disso a API usa 100.
+     * @param {ListCustomFieldsFeatureEnum} [feature] Recurso.
+     * @param {boolean} [system] Com &#x60;true&#x60;, só os campos de sistema; com &#x60;false&#x60;, só os criados pelo administrador.
+     * @param {boolean} [required] Com &#x60;true&#x60;, só os obrigatórios.
+     * @param {string} [search] Busca no nome.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    listCustomFields(page?: number, limit?: number, feature?: ListCustomFieldsFeatureEnum, system?: boolean, required?: boolean, search?: string, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<ListCustomFields200Response>>;
+};
+/**
+ * CustomFieldsApi - factory interface
+ */
+export declare const CustomFieldsApiFactory: (configuration?: Configuration, basePath?: string, axios?: AxiosInstance) => {
+    /**
+     * Devolve os campos de um recurso: os criados pelo administrador e os de sistema. É aqui que você descobre os IDs para `customFields` e quais campos a conta exige (`settings.required: true`).
+     * @summary Listar campos personalizados
+     * @param {CustomFieldsApiListCustomFieldsRequest} requestParameters Request parameters.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    listCustomFields(requestParameters?: CustomFieldsApiListCustomFieldsRequest, options?: RawAxiosRequestConfig): AxiosPromise<ListCustomFields200Response>;
+};
+/**
+ * Request parameters for listCustomFields operation in CustomFieldsApi.
+ */
+export interface CustomFieldsApiListCustomFieldsRequest {
+    /**
+     * Página, a partir de 1. **Envie sempre**: sem &#x60;page&#x60;, a resposta vem como lista simples, sem o envelope de paginação, e &#x60;limit&#x60; é ignorado.
+     */
+    readonly page?: number;
+    /**
+     * Registros por página. Padrão: 15, salvo indicação na operação. Máximo: 100 — acima disso a API usa 100.
+     */
+    readonly limit?: number;
+    /**
+     * Recurso.
+     */
+    readonly feature?: ListCustomFieldsFeatureEnum;
+    /**
+     * Com &#x60;true&#x60;, só os campos de sistema; com &#x60;false&#x60;, só os criados pelo administrador.
+     */
+    readonly system?: boolean;
+    /**
+     * Com &#x60;true&#x60;, só os obrigatórios.
+     */
+    readonly required?: boolean;
+    /**
+     * Busca no nome.
+     */
+    readonly search?: string;
+}
+/**
+ * CustomFieldsApi - object-oriented interface
+ */
+export declare class CustomFieldsApi extends BaseAPI {
+    /**
+     * Devolve os campos de um recurso: os criados pelo administrador e os de sistema. É aqui que você descobre os IDs para `customFields` e quais campos a conta exige (`settings.required: true`).
+     * @summary Listar campos personalizados
+     * @param {CustomFieldsApiListCustomFieldsRequest} requestParameters Request parameters.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    listCustomFields(requestParameters?: CustomFieldsApiListCustomFieldsRequest, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<import("../models").Page, any, {}, any>>;
+}
+export declare const ListCustomFieldsFeatureEnum: {
+    readonly contact: "contact";
+    readonly organization: "organization";
+    readonly deal: "deal";
+    readonly task: "task";
+    readonly meeting: "meeting";
+    readonly ticket: "ticket";
+    readonly treatment: "treatment";
+    readonly staff: "staff";
+    readonly product: "product";
+};
+export type ListCustomFieldsFeatureEnum = typeof ListCustomFieldsFeatureEnum[keyof typeof ListCustomFieldsFeatureEnum];