Servidor MCP
Conecte ferramentas de IA ao Flowtly através do Model Context Protocol em mcp.flowtly.eu.
Conectar
claude mcp add --transport http flowtly https://mcp.flowtly.eu/mcp
Nesta página
Alocações_get
Ferramentas
| allocations_get | Uma alocação por id — a reserva de uma pessoa num projeto, com as suas datas e percentagem. allocations_list encontra o id; este devolve o registo completo. Uma alocação sem funcionário é um cargo EM ABERTO (procura não preenchida), não uma reserva. Requer o módulo de recursos. Apenas leitura. |
Alocações_list
Ferramentas
| allocations_list | Lista alocações de recursos — atribuições com intervalo de datas de uma posição num projeto a um funcionário (ou ainda a ninguém, um cargo em aberto). Sem filtros; pagine com cursor. Cada item traz employeeId/employeeName e projectId/projectName já resolvidos (employeeId nulo significa um cargo em aberto); positionId é simples — resolva o seu nome via positions_list. source distingue linhas importadas de folha das criadas diretamente no Flowtly. Use isto para reconciliar uma importação de folha de recursos: verifique o que ficou registado e compare com o que foi submetido. |
Contas Bancárias_get
Ferramentas
| bankAccounts_get | Obtenha uma conta bancária pelo id — nome, moeda, banco e o formato em que os extratos são importados. |
Contas Bancárias_list
Ferramentas
| bankAccounts_list | Lista as contas bancárias da organização. Filtre por banco, ou defina hidden para incluir as arquivadas. Use-a para resolver o id de bankAccount que transactions_list filtra. |
Clientes_get
Ferramentas
| clients_get | Obtenha um cliente pelo id — nome, país, moeda, número de contribuinte e estado. |
Clientes_list
Ferramentas
| clients_list | Lista clientes (os clientes da organização). Filtre por status, ou por externalPaymentCustomerId para encontrar o cliente por trás de um id de fornecedor de pagamento. Use-a para resolver o id de cliente que invoices_list, deals_list, projects_list e contracts_list filtram. |
Chaves de Configuração_catalog
Ferramentas
| configKeys_catalog | Lista todas as chaves de configuração da organização reconhecidas pelo backend, com o seu tipo e valores permitidos. Este é o catálogo do que é configurável — leia-o antes de configs_get ou configs_update em vez de adivinhar o nome de uma chave. A permissão é aplicada por chave pelo backend, pelo que uma chave aparecer aqui não garante que o utilizador ligado possa escrevê-la. |
Configurações_get
Ferramentas
| configs_get | Lê um valor de configuração da organização por id, onde o id é uma chave do configKeys_catalog (por exemplo, organization-logo-url, organization-icon-url). |
Contratos_get
Ferramentas
| contracts_get | Obtenha um contrato pelo id — partes, direção, valor, termos cíclicos e datas. |
Contratos_list
Ferramentas
| contracts_list | Lista contratos. Filtre por direção (recebido / emitido), contraparte, projeto, cíclico, nome ou etiquetas. Use-a para resolver o id de contrato que contracts_paymentScheduleLines lê e que deals_win pode associar a um negócio ganho. |
Contratos_payment Schedule Lines
Ferramentas
| contracts_paymentScheduleLines | Lista o plano de pagamentos de um contrato — as prestações em que se espera que seja faturado ou pago. Passe contractId de contracts_list. Este é o plano, não os valores reais: compare-o com transactions_list para ver o que foi efetivamente pago. |
Grupos de Custos_list
Ferramentas
| costGroups_list | Lista grupos de custos / centros de custo — os grupos sob os quais custos, fornecedores e faturas recebidas são arquivados. Use-a para resolver o id de costGroup que suppliers_create requer e que as sugestões de faturas recebidas propõem. |
Contrapartes_get
Ferramentas
| counterparties_get | Obtenha uma contraparte pelo id. |
Contrapartes_list
Ferramentas
| counterparties_list | Liste as contrapartes — todas as entidades com quem a organização transaciona. As flags supplier e client indicam que papel(is) uma contraparte desempenha, e um registo pode ser ambos. É esta a entidade numa transação bancária, pelo que é contra ela que as faturas recebidas e as transações são cruzadas. Filtre por type, supplier, client, cyclic ou budgetNeutral. |
Notas de CRM_get
Ferramentas
| crmNotes_get | Obtenha uma nota de CRM pelo id. |
Notas de CRM_list
Ferramentas
| crmNotes_list | Liste as notas escritas em leads e negócios. Filtre por lead ou deal para ler o histórico de comentários de um registo. |
Razões de Negócio Perdido_get
Ferramentas
| dealLostReasons_get | Obtenha um motivo de perda de negócio pelo id. |
Razões de Negócio Perdido_list
Ferramentas
| dealLostReasons_list | Lista, por ordem, as razões pelas quais um negócio pode ser marcado como perdido. deals_lose requer um lostReasonId daqui. |
Negócios_get
Ferramentas
| deals_get | Obtenha um negócio pelo id — título, cliente, fase, valor, responsável, contacto, e datas de fecho previstas e reais. |
Negócios_list
Ferramentas
| deals_list | Liste os negócios/oportunidades — o pipeline de vendas. Filtre por status (open / won / lost), stage, owner, client, lead, ou por intervalos de expectedCloseDate / closedAt. Os valores são em unidades menores com uma moeda explícita; não assuma a moeda predefinida da organização. |
Históricos de Fase de Negócio_get
Ferramentas
| dealStageHistories_get | Obtenha um registo de mudança de fase de negócio pelo id. |
Históricos de Fase de Negócio_list
Ferramentas
| dealStageHistories_list | Lista as transições de fase de um negócio, das mais recentes para as mais antigas. Filtre por negócio. Todo deals_update que move a fase é registado aqui automaticamente, pelo que é assim que se reconstrói quanto tempo um negócio esteve em cada fase — o próprio negócio guarda apenas a fase atual. |
Pedidos de Ausência_list
Ferramentas
| holidayRequests_list | PEDIDOS de ausência e o seu estado — pendente, aprovado, rejeitado. Distinto de holidays_list, que são ausências já registadas: um pedido ainda por decidir não é ainda uma ausência, por isso planeie com base em holidays_list e use este para ver o que está pendente de decisão. Fornece o holidayRequestId que holidays_approve e holidays_bulkApprove utilizam. Apenas leitura. |
Ausências_active
Ferramentas
| holidays_active | Quem está de folga AGORA MESMO — todas as ausências atualmente em curso, em toda a organização, para todos. Esta é a ferramenta para 'quem está fora hoje', e a que deve ser cruzada antes de tratar o freePercent de resourcingBench_get como disponibilidade, porque o banco de recursos não subtrai as ausências. Ao contrário de holidays_list, não aplica âmbito de projeto e não requer permissão além de estar autenticado, pelo que a sua resposta cobre toda a organização. Devolve cada ausência com o seu tipo e datas. Apenas leitura. |
Ausências_get
Ferramentas
| holidays_get | Um registo de ausência por id, com o seu tipo, datas e duração. Obtenha o id de holidays_list ou holidays_active. Apenas leitura. |
Ausências_list
Ferramentas
| holidays_list | Ausências registadas num período — a vista de planeamento, enquanto holidays_active responde apenas sobre hoje. Filtre por funcionário, por intervalo de datas ou por projeto. O QUE VÊ DEPENDE DAS SUAS PERMISSÕES, e uma lista curta não é prova de que ninguém está ausente: um gestor de ausências ou um utilizador de contabilidade vê toda a organização, enquanto um líder de projeto ou visualizador TEM de indicar um filtro de projeto (ou perguntar sobre si próprio) e é recusado sem um — essa recusa é um limite de permissão, não um calendário vazio. Apenas leitura. |
Faturas Recebidas_get
Ferramentas
| incomingInvoices_get | Obtenha uma fatura recebida (de fornecedor) ou documento de suporte pelo id, com os respetivos campos extraídos por OCR e o estado de correspondência atual. |
Faturas Recebidas_list
Ferramentas
| incomingInvoices_list | Lista faturas recebidas (de fornecedores) e documentos de suporte — a caixa de entrada de contabilidade. Uma fatura recebida É um documento anexado a uma transação bancária, pelo que exists.transaction=false é a forma de encontrar documentos ainda não associados a um pagamento. Filtre também por status, relatedMonth, contraparte, projeto, etiquetas ou hasDetectedProblems. Cada documento é identificado por externalId 'upload_sha256:<sha256 dos bytes>' — calcule o hash de um ficheiro e procure esse externalId aqui ANTES de incomingInvoices_create, ou vai arquivar um duplicado. |
Faturas Recebidas_match Candidates
Ferramentas
| incomingInvoices_matchCandidates | Liste as transações bancárias que podem ser o pagamento desta fatura recebida, ordenadas pelo próprio motor de correspondência do backend. Recorra a isto quando um documento não tiver transação associada e for preciso escolher uma; prefira estes candidatos a adivinhar pelos valores por conta própria. |
Faturas Recebidas_suggestions
Ferramentas
| incomingInvoices_suggestions | Lê as próprias propostas do Flowtly para uma fatura recebida — correspondência de fornecedor, grupo de custos, transação bancária correspondente, aviso de duplicado. São exatamente as propostas que um humano vê na aplicação. Leia-as primeiro e depois aplique uma por id com incomingInvoices_applySuggestion, ou aceite todas com acceptAllSuggestions. Passe refresh para recalcular em vez de servir o conjunto em cache. |
Faturas Recebidas_suggestions Debug
Ferramentas
| incomingInvoices_suggestionsDebug | Explica PORQUE é que as sugestões de uma fatura recebida saíram como saíram — a pontuação do motor de correspondência, para diagnosticar uma sugestão em falta ou errada. Apenas para diagnóstico; use incomingInvoices_suggestions no trabalho normal. |
Faturas_get
Ferramentas
| invoices_get | Obtenha uma fatura emitida (de venda) pelo id — cliente, linhas, totais, datas de venda e emissão, estado. |
Faturas_list
Ferramentas
| invoices_list | Lista faturas emitidas (de venda). Filtre por cliente, etiquetas, pesquisa ou um intervalo de saleDate. Note que saleDate — não a data de emissão nem a data de criação — é o campo que invoices_export filtra, por isso use o mesmo campo aqui ao reconciliar uma exportação. |
Atividades de Lead_get
Ferramentas
| leadActivities_get | Obtém uma atividade de lead (contacto de prospeção) por id. |
Atividades de Lead_list
Ferramentas
| leadActivities_list | Lista os contactos de prospeção de um lead — a sua linha temporal de atividade (convite enviado, respostas, chamadas, acompanhamentos). Filtre por lead para ler o histórico de um prospeto. Este é o equivalente estruturado de crmNotes_list: as atividades são o registo de contacto tipificado e datado; as notas são comentário livre. |
Contactos de Lead_get
Ferramentas
| leadContacts_get | Obtenha um contacto de lead pelo id. |
Contactos de Lead_list
Ferramentas
| leadContacts_list | Liste as pessoas de contacto associadas a leads. Filtre por lead para ler os contactos de um prospect, ou por email para descobrir de que lead veio uma mensagem. |
Associações a Listas de Leads_get
Ferramentas
| leadListMemberships_get | Obtenha uma associação de lead a lista pelo id. |
Associações a Listas de Leads_list
Ferramentas
| leadListMemberships_list | Liste quais leads estão em quais listas de prospeção outbound, com o estado de contacto de cada um (contacted / replied / bounced). Filtre por list, lead ou status — é assim que lê o estado de uma campanha. |
Listas de Leads_get
Ferramentas
| leadLists_get | Obtenha uma lista de prospeção outbound pelo id. |
Listas de Leads_list
Ferramentas
| leadLists_list | Lista listas de prospeção de saída. Use-a para resolver o id de lista que leadListMemberships_create utiliza. |
Razões de Lead Perdido_get
Ferramentas
| leadLostReasons_get | Obtenha um motivo de perda de lead pelo id. |
Razões de Lead Perdido_list
Ferramentas
| leadLostReasons_list | Liste os motivos pelos quais um lead pode ser marcado como perdido, por ordem. |
Leads_dedupe Check
Ferramentas
| leads_dedupeCheck | Verifica se um prospeto já existe no CRM, usando os mesmos filtros de leads_list (companyName, source, owner, …). Chame isto ANTES de leads_create: um lead duplicado divide o histórico de contacto entre dois registos, e nada a jusante os fundirá por si. |
Leads_get
Ferramentas
| leads_get | Obtenha um lead pelo id — empresa, website, origem, estado, responsável e o cliente para o qual foi convertido, se aplicável. |
Leads_list
Ferramentas
| leads_list | Lista leads — alvos de prospeção, antes da qualificação. Filtre por status, source, owner, client, companyName, ou intervalos de createdAt/closedAt. Um lead qualificado torna-se um Cliente mais um Negócio em aberto via leads_convert; até lá vive apenas aqui, não em clients_list. |
Fases de Lead_get
Ferramentas
| leadStages_get | Obtenha uma fase de lead pelo id. |
Fases de Lead_list
Ferramentas
| leadStages_list | Lista, por ordem, as fases pelas quais um lead passa. Os leads têm o seu próprio conjunto de fases — os negócios usam stages_list, que é uma coisa diferente. |
Organizações_get
Ferramentas
| organizations_get | Obtém uma organização por id. AVISO — isto NÃO indica a que organização está ligado. Uma ligação OAuth está fixada exatamente a uma organização (associada ao token), mas este endpoint devolve qualquer organização de que o UTILIZADOR ligado seja membro, pelo que uma leitura bem-sucedida aqui pode parecer confirmação de que está a trabalhar nessa organização, quando pode não estar. Para verificar o inquilino em que está realmente a operar, leia dados delimitados ao inquilino — people_list ou clients_list — e nunca inicie uma escrita em massa apenas com base nesta chamada. |
Pessoas_get
Ferramentas
| people_get | Obtenha um registo de pessoa/colaborador pelo id — nomes, emails, telefone, gestor, e se está ativo. |
Pessoas_list
Ferramentas
| people_list | Liste as pessoas/colaboradores. Filtre por isActive, reportsTo (o id de um gestor), projectMembers.project, ou search; pagine com cursor. Pessoas e colaboradores partilham o mesmo id, pelo que é assim que resolve o id de colaborador esperado pelas ferramentas de horas de trabalho, responsabilidades, membros de projeto e permissões. |
Grupos de Permissões_get
Ferramentas
| permissionGroups_get | Obtenha um grupo de permissões pelo id, incluindo as strings ROLE_* que concede. |
Grupos de Permissões_list
Ferramentas
| permissionGroups_list | Lista os grupos de permissões da organização e os papéis que cada um concede — por exemplo, o grupo "Business Owner" concede ROLE_ADMIN. Leia isto antes de people_setPermissionGroups: os papéis na resposta são a autoridade sobre o que um grupo realmente permite, pelo que nunca precisa de adivinhar pelo nome. |
Pipelines_get
Ferramentas
| pipelines_get | Obtenha um pipeline de vendas pelo id. |
Pipelines_list
Ferramentas
| pipelines_list | Lista pipelines de vendas. Um pipeline é dono de um conjunto ordenado de fases — leia-as com stages_list filtrado por pipeline. |
Posições_list
Ferramentas
| positions_list | Lista posições — os papéis nomeados (por exemplo, "Backend Engineer") que uma alocação de projeto preenche. Sem filtros; Position tem a paginação desativada, pelo que isto devolve sempre o catálogo completo de papéis da organização numa única chamada. Cada item é {id, name, roles}. Use-a para resolver o nome da posição por trás do positionId de uma linha de allocations_list, e para encontrar o id de posição com que uma importação de recursos deve corresponder. |
Projetos_get
Ferramentas
| projects_get | Obtenha um projeto pelo id — nome, tipo, cliente, datas, descrição e preço. |
Projetos_list
Ferramentas
| projects_list | Liste os projetos. Filtre por type (fixed-price | time-and-material | non-billable | internal), client.name, employee, name, ou intervalos de dateFrom/dateTo. Use-o para resolver o id de projeto exigido por tarefas, registo de horas de trabalho, orçamentos e contratos. |
Candidatos a Pedido de Recurso_get
Ferramentas
| resourceRequestCandidates_get | Um candidato de recrutamento por id. O id vem de resourceRequestCandidates_list. Requer ROLE_HR_MANAGER. Apenas leitura. |
Candidatos a Pedido de Recurso_list
Ferramentas
| resourceRequestCandidates_list | Os candidatos apresentados para pedidos de contratação — pessoas num pipeline de recrutamento, não funcionários disponíveis para alocação. Filtre pelo id do pedido de resourceRequests_list. Requer ROLE_HR_MANAGER. Apenas leitura. |
Pedidos de Recurso_get
Ferramentas
| resourceRequests_get | Um pedido de contratação por id, com a sua posição e estado. Obtenha o id de resourceRequests_list. RH/recrutamento, não alocação de recursos. Requer ROLE_HR_MANAGER. Apenas leitura. |
Pedidos de Recurso_list
Ferramentas
| resourceRequests_list | Pedidos de contratação em aberto — um pedido para recrutar para uma posição, no domínio de RH. Apesar do nome, isto NÃO é procura de alocação de recursos: é recrutamento. Devolve a coleção; resourceRequests_get lê um, e resourceRequestCandidates_list dá as pessoas apresentadas para ele. Requer ROLE_HR_MANAGER. Apenas leitura. |
Pedidos de Recursos_list
Ferramentas
| resourcingRequests_list | Pedidos de recursos em aberto — alguém a pedir que uma pessoa seja alocada a um projeto, o que constitui o lado da procura em recursos. Este é o fluxo que a vista de Pedidos da interface de Recursos apresenta. NÃO confunda com resourceRequests_list: esse é RECRUTAMENTO de RH (contratação para uma posição). Combine-o com resourcingRequestsHistory_list para o que já foi decidido, e resourcingBench_get para quem poderia satisfazer um pedido. Requer o módulo de recursos e ROLE_RESOURCING_MANAGER. Apenas leitura. |
Histórico de Pedidos de Recursos_list
Ferramentas
| resourcingRequestsHistory_list | O que já aconteceu aos pedidos de recursos — o rasto de decisões (confirmado, recusado, alterado) por trás dos pedidos em aberto em resourcingRequests_list. Recorra a isto para responder 'isto já foi pedido e recusado?' antes de propor de novo a mesma alocação. Requer o módulo de recursos e ROLE_RESOURCING_MANAGER. Apenas leitura. |
Responsabilidades_get
Ferramentas
| responsibilities_get | Obtenha uma responsabilidade pelo id. |
Responsabilidades_list
Ferramentas
| responsibilities_list | Liste as responsabilidades dentro de um grupo RACI. Filtre por responsibilityGroup. As responsabilidades podem aninhar-se através de parent; as pessoas são atribuídas a elas através de responsibilityEmployees, não diretamente. |
Funcionários de Responsabilidade_get
Ferramentas
| responsibilityEmployees_get | Obtenha uma atribuição de responsabilidade pelo id. |
Funcionários de Responsabilidade_list
Ferramentas
| responsibilityEmployees_list | Liste quem está atribuído a que responsabilidade, e em que percentagem. Filtre por employee para ler toda a carga RACI de uma pessoa em todos os grupos. |
Grupos de Responsabilidade_get
Ferramentas
| responsibilityGroups_get | Obtenha um grupo de responsabilidades pelo id. |
Grupos de Responsabilidade_list
Ferramentas
| responsibilityGroups_list | Liste os grupos de responsabilidades / áreas RACI — os itens de topo "Odpowiedzialności", cada um com uma pessoa responsável. As responsabilidades individuais ficam abaixo deles. |
Funcionários de Cronograma_get
Ferramentas
| scheduleEmployees_get | Uma atribuição de cronograma a funcionário por id. O id vem de scheduleEmployees_list. Requer ROLE_SCHEDULES_MANAGER. Apenas leitura. |
Funcionários de Cronograma_list
Ferramentas
| scheduleEmployees_list | Que funcionários estão atribuídos a que cronogramas de horário de trabalho. Use-a para ir de um cronograma (schedules_list) até às suas pessoas, ou para encontrar o cronograma que um dado funcionário segue. Requer ROLE_SCHEDULES_MANAGER. Apenas leitura. |
Plano de Cronograma_list
Ferramentas
| schedulePlan_list | Os cronogramas em vigor numa ÚNICA data — passe a data no caminho. Recorra a isto para responder 'quem está a trabalhar hoje / nesta data' sem ter de ler todos os cronogramas e resolver os seus intervalos por conta própria. Ao contrário das outras leituras de cronogramas, esta requer apenas ROLE_USER, sendo por isso a que está disponível a um funcionário comum. Apenas leitura. |
Intervalos de Cronograma_get
Ferramentas
| scheduleRanges_get | Um intervalo de tempo de cronograma por id. O id vem de scheduleRanges_list. Requer ROLE_SCHEDULES_MANAGER. Apenas leitura. |
Intervalos de Cronograma_list
Ferramentas
| scheduleRanges_list | Os intervalos de tempo que compõem os cronogramas de horário de trabalho — as horas efetivas que um cronograma cobre. Leia primeiro o registo principal com schedules_get; este expande os seus intervalos. Requer ROLE_SCHEDULES_MANAGER. Apenas leitura. |
Cronogramas_get
Ferramentas
| schedules_get | Um cronograma de horário de trabalho por id, com os seus intervalos e funcionários atribuídos. O id vem de schedules_list; scheduleRanges_list e scheduleEmployees_list leem as suas partes. Requer ROLE_SCHEDULES_MANAGER. Apenas leitura. |
Cronogramas_list
Ferramentas
| schedules_list | Cronogramas de horário de trabalho — os padrões de turnos/trabalho que uma organização define, NÃO alocação de projeto. Use resourcingSchedule_get para saber quem está reservado em quê; use este para os próprios padrões de trabalho. schedules_get lê um por id. Requer ROLE_SCHEDULES_MANAGER. Apenas leitura. |
Fases_get
Ferramentas
| stages_get | Obtenha uma fase de negócio pelo id. |
Fases_list
Ferramentas
| stages_list | Lista fases de negócio, por ordem. Filtre por pipeline. deals_create requer um id de fase daqui, e mover um negócio entre fases é o que dealStageHistories regista. |
Fornecedores_list
Ferramentas
| suppliers_list | Liste os fornecedores/contratados — servidos a partir de /contractors, pelo que "supplier" e "contractor" são o mesmo registo. Filtre por cyclic para fornecedores recorrentes. Use-o para resolver o fornecedor contra o qual um custo, um contrato ou uma fatura recebida é arquivado. |
Definições de Etiquetas_list
Ferramentas
| tagDefinitions_list | Lista definições de etiquetas — as etiquetas que podem ser associadas a registos, cada uma dentro de um grupo de etiquetas. tags_create utiliza um id de tagDefinition daqui, mais o registo a que se associa. |
Grupos de Etiquetas_list
Ferramentas
| tagGroups_list | Liste os grupos de etiquetas — os contentores que organizam as definições de etiquetas. |
Comentários de Tarefa_list
Ferramentas
| taskComments_list | Liste os comentários em tarefas de projeto, dos mais antigos para os mais recentes. Filtre por task para ler a discussão de uma tarefa. |
Listas de Tarefas_list
Ferramentas
| taskLists_list | Lista listas de tarefas — as colunas/secções do quadro onde as tarefas são arquivadas. Filtre por projeto. tasks_create utiliza um id de lista daqui. |
Tarefas_get
Ferramentas
| tasks_get | Obtenha uma tarefa de projeto pelo id — título, projeto, estado, lista, responsáveis, datas e recorrência. |
Tarefas_list
Ferramentas
| tasks_list | Lista tarefas de projeto. Filtre por projeto, lista, status, responsáveis, isTemplate, ou intervalos de startAt/dueAt. As tarefas recorrentes expõem recurrenceParent e recurrenceRule, pelo que uma ocorrência gerada pode ser reconduzida à regra que a produziu. Para decidir se uma tarefa está CONCLUÍDA, compare o seu status com taskStatuses_list (isClosed) em vez de comparar pelo nome do status. |
Estados de Tarefa_list
Ferramentas
| taskStatuses_list | Liste os estados de tarefa de projeto, pela ordem do quadro. isClosed assinala os estados de concluído e isDefault o estado atribuído a uma nova tarefa. Consulte isto antes de interpretar o estado de uma tarefa — os nomes são configuráveis pela organização, pelo que "Done" não é uma string fiável para comparar. |
Grupos Fiscais_list
Ferramentas
| taxGroups_list | Lista grupos fiscais. Use-a para resolver o id de taxGroup que taxRules_list filtra e que as linhas de fatura transportam. |
Regras Fiscais_list
Ferramentas
| taxRules_list | Liste as regras fiscais — as taxas e os períodos a que se aplicam. Filtre por taxGroup. |
Transações_list
Ferramentas
| transactions_list | Liste as transações bancárias — o feed bancário contra o qual as faturas recebidas são cruzadas. Filtre por bankAccount, counterpartyRole, cost, ignored, hasDetectedProblems, um intervalo de orderDate/execDate, ou amount.between. Note que orderDate e execDate são diferentes: um pagamento pode ser ordenado num mês e executado no seguinte. |
Transações_suggestions
Ferramentas
| transactions_suggestions | Lê as propostas do Flowtly para uma transação bancária — a que contraparte, grupo de custos ou documento deve ser arquivada. A imagem espelhada de incomingInvoices_suggestions, do lado do dinheiro. |
Registos de Horas_get
Ferramentas
| workTimes_get | Obtenha uma única entrada de horas de trabalho pelo id — data, minutos, projeto, notas e o colaborador a que pertence. |
Registos de Horas_list
Ferramentas
| workTimes_list | Liste as entradas de horas de trabalho (horas registadas). Filtre por intervalo de datas (date.after / date.before, YYYY-MM-DD) e, opcionalmente, por employee ou project; pagine com cursor. Cada linha transporta employeeId/employeeName e projectId/projectName, pelo que é assim que exporta todas as horas registadas de um período. IMPORTANTE: resultados ao nível da organização exigem ROLE_WORKING_HOURS_VIEWER. Sem essa permissão, o backend NÃO devolve erro — devolve silenciosamente apenas as entradas do próprio utilizador ligado, pelo que uma exportação de "horas de todos" pode voltar a conter apenas uma pessoa e parecer perfeitamente normal. Se todas as linhas pertencerem a um único colaborador e não tiver filtrado por employee, a resposta transporta um scopeWarning a avisar disso — mostre-o ao utilizador em vez de apresentar o resultado como sendo ao nível da organização. |
Registos de Horas_log
Ferramentas
| workTimes_log | Registe uma entrada de horas de trabalho para o utilizador Flowtly ligado (date, durationMinutes, project, notes). Escrita. |
Tarefas_create
Ferramentas
| tasks_create | Crie uma tarefa de projeto (title + project obrigatórios; status, list, assignees, dueAt, priority opcionais). Escrita. |
Tarefas_update
Ferramentas
| tasks_update | Atualize uma tarefa de projeto pelo id — altere status (incl. marcar como concluída), assignees, dueAt, title, etc. Escrita. |
Comentários de Tarefa_create
Ferramentas
| taskComments_create | Adicione um comentário a uma tarefa de projeto (id da task + content). Escrita. |
Fornecedores_create
Ferramentas
| suppliers_create | Crie um novo registo de fornecedor/contratado (name, tinType, costGroup obrigatórios). Escrita. |
Fornecedores_update
Ferramentas
| suppliers_update | Atualize os dados de um fornecedor/contratado (nome, número de contribuinte, condições de pagamento, etc.) pelo id. Escrita. |
Pessoas_create
Ferramentas
| people_create | Crie um registo de pessoa/colaborador (firstname + lastname obrigatórios; companyEmail, contactEmail, contactPhone opcionais). Escrita. |
Pessoas_update
Ferramentas
| people_update | Atualize um registo de pessoa/colaborador pelo id (name, companyEmail, contactEmail, contactPhone, etc.). Escrita. |
Pessoas_delete
Ferramentas
| people_delete | Elimine um registo de colaborador/pessoa pelo id (por exemplo, para remover um colaborador fictício/placeholder). Exige ROLE_EMPLOYEES_MANAGER; o backend executa um processador de eliminação que também desassocia registos relacionados. Alto impacto, irreversível. Escrita. |
Grupos de Custos_create
Ferramentas
| costGroups_create | Crie um grupo de custos / centro de custo (name + type obrigatórios). Escrita. |
Grupos de Custos_update
Ferramentas
| costGroups_update | Atualize o nome ou o tipo de um grupo de custos / centro de custo pelo id. Escrita. |
Grupos de Etiquetas_create
Ferramentas
| tagGroups_create | Crie um grupo de etiquetas (name obrigatório) para organizar definições de etiquetas relacionadas. Escrita. |
Definições de Etiquetas_create
Ferramentas
| tagDefinitions_create | Crie uma definição de etiqueta (name, level, tagGroup obrigatórios) dentro de um grupo de etiquetas. Escrita. |
Clientes_create
Ferramentas
| clients_create | Crie um novo registo de cliente (name, country, currency, status, tinType obrigatórios). Escrita. |
Clientes_update
Ferramentas
| clients_update | Atualize um registo de cliente pelo id. Escrita. |
Contactos de Cliente_create
Ferramentas
| clientContacts_create | Crie uma pessoa de contacto para um cliente (client, type, name, email obrigatórios). Escrita. |
Contas Bancárias_create
Ferramentas
| bankAccounts_create | Crie uma conta bancária (type, name, currency, defaultImportFormat obrigatórios). Escrita. |
Contas Bancárias_update
Ferramentas
| bankAccounts_update | Atualize uma conta bancária pelo id. Escrita. |
Contas Bancárias da Contraparte_create
Ferramentas
| counterpartyBankAccounts_create | Associe uma conta bancária a uma contraparte (counterparty + accountNumber). Escrita. |
Contratos_create
Ferramentas
| contracts_create | Crie um contrato. Escrita. |
Contratos_update
Ferramentas
| contracts_update | Atualize um contrato pelo id. Escrita. |
Contratos_delete
Ferramentas
| contracts_delete | Elimine um contrato pelo id. Escrita. |
Grupos Fiscais_create
Ferramentas
| taxGroups_create | Crie um grupo fiscal (name + type obrigatórios). Escrita. |
Grupos Fiscais_update
Ferramentas
| taxGroups_update | Atualize o nome ou o tipo de um grupo fiscal pelo id. Escrita. |
Regras Fiscais_create
Ferramentas
| taxRules_create | Crie uma regra fiscal. Escrita. |
Regras Fiscais_update
Ferramentas
| taxRules_update | Atualize uma regra fiscal pelo id. Escrita. |
Configurações_update
Ferramentas
| configs_update | Atualize um valor de configuração da organização pelo id (type + name obrigatórios; a permissão é aplicada por chave de configuração pelo backend). Escrita. |
Grupos de Permissões_create
Ferramentas
| permissionGroups_create | Crie um grupo de permissões (name obrigatório; roles = lista de strings ROLE_* que concede). Escrita. |
Grupos de Permissões_update
Ferramentas
| permissionGroups_update | Atualize o nome, a descrição ou os papéis concedidos de um grupo de permissões pelo id. Escrita. |
Pessoas_set Permission Groups
Ferramentas
| people_setPermissionGroups | Define (substitui) os grupos de permissões de uma pessoa por ids numéricos de grupo (ver permissionGroups_list — por exemplo, o grupo "Business Owner" concede ROLE_ADMIN). Concede acesso; NÃO cria um início de sessão nem envia email à pessoa. Escrita. |
Projetos_create
Ferramentas
| projects_create | Crie um projeto (name + type obrigatórios; type = fixed-price|time-and-material|non-billable|internal; dateFrom/dateTo, client, publicDescription, notes, priceNet opcionais). Escrita. |
Projetos_update
Ferramentas
| projects_update | Atualize um projeto pelo id (name, type, dates, description, etc.). Escrita. |
Grupos de Responsabilidade_create
Ferramentas
| responsibilityGroups_create | Cria um grupo de responsabilidade / área RACI (name obrigatório; description e responsibleEmployee opcionais = a pessoa responsável, indicada como um id de funcionário simples, como 6 (de people_list), ou o IRI /people/6). Este é o item de topo 'Odpowiedzialności'. Adicione responsabilidades individuais sob ele via responsibilities_create. Escrita. |
Grupos de Responsabilidade_update
Ferramentas
| responsibilityGroups_update | Atualize um grupo de responsabilidades pelo id (name, description, responsibleEmployee = id de colaborador ou IRI). Escrita. |
Responsabilidades_create
Ferramentas
| responsibilities_create | Cria uma responsabilidade dentro de um grupo (responsibilityGroup = id ou IRI do grupo, + name, obrigatórios; description opcional; parent opcional = outro IRI de responsabilidade para aninhamento). Atribua pessoas a ela via responsibilityEmployees_create. Escrita. |
Responsabilidades_update
Ferramentas
| responsibilities_update | Atualize uma responsabilidade pelo id (name, description, parent, responsibilityGroup = id de grupo ou IRI). Escrita. |
Funcionários de Responsabilidade_create
Ferramentas
| responsibilityEmployees_create | Atribua um colaborador a uma responsabilidade (responsibility = id de responsabilidade ou IRI, employee = id de colaborador ou IRI, percentage 0-100, todos obrigatórios; targets e description opcionais). Escrita. |
Funcionários de Responsabilidade_update
Ferramentas
| responsibilityEmployees_update | Atualize uma atribuição de responsabilidade pelo id (percentage, targets, description). Escrita. |
Funcionários de Responsabilidade_delete
Ferramentas
| responsibilityEmployees_delete | Remova a atribuição de um colaborador a uma responsabilidade pelo id. Escrita. |
Leads_create
Ferramentas
| leads_create | Crie um lead (alvo de prospeção outbound/inbound; companyName, source, status, owner, linked client opcionais). Escrita. |
Leads_update
Ferramentas
| leads_update | Atualize um lead pelo id (company, website, source, status, owner, linked client). Escrita. |
Leads_delete
Ferramentas
| leads_delete | Elimine um lead pelo id (eliminação reversível). Escrita. |
Leads_convert
Ferramentas
| leads_convert | Converta um lead qualificado num Cliente + um contacto por cada lead-contact + um Negócio aberto. Exige um cliente existente (o cliente do lead ou um clientId no corpo do pedido). Escrita. |
Atividades de Lead_create
Ferramentas
| leadActivities_create | Regista UM contacto de prospeção num lead — um convite enviado, um convite aceite, uma mensagem, uma resposta, uma chamada, um acompanhamento (lead + type + occurredAt obrigatórios; channel, contact, body opcionais). É AQUI que pertence o histórico de contacto de um prospeto: uma crmNote é comentário livre, uma atividade é o registo de contacto estruturado e filtrável que a linha temporal da fila de prospeção apresenta. NÃO narre contactos numa nota. type: invite_sent | invite_accepted | message_sent | reply_received | call | meeting | follow_up | …; channel: linkedin | email | phone | …. Escrita. |
Atividades de Lead_update
Ferramentas
| leadActivities_update | Atualiza uma atividade de contacto registada por id (type, channel, occurredAt, body). Escrita. |
Atividades de Lead_delete
Ferramentas
| leadActivities_delete | Elimina uma atividade de contacto registada por id. Escrita. |
Contactos de Lead_create
Ferramentas
| leadContacts_create | Adiciona uma pessoa de contacto a um lead (lead + name obrigatórios; email, phone, role, linkedinUrl, isPrimary opcionais). O URL do LinkedIn de um contacto pertence a linkedinUrl, NÃO a uma crmNote. Escrita. |
Contactos de Lead_update
Ferramentas
| leadContacts_update | Atualiza um contacto de lead por id — por exemplo, define linkedinUrl / email / phone assim que os encontrar. Escrita. |
Contactos de Lead_delete
Ferramentas
| leadContacts_delete | Elimine um contacto de lead pelo id. Escrita. |
Negócios_create
Ferramentas
| deals_create | Crie um negócio/oportunidade (title, client, stage obrigatórios; amountMinor, currency, expectedCloseDate, owner, contact opcionais). Escrita. |
Negócios_update
Ferramentas
| deals_update | Atualize um negócio pelo id (title, stage, amount, close date, owner, contact). A mudança de fase é registada automaticamente. Escrita. |
Negócios_delete
Ferramentas
| deals_delete | Elimine um negócio pelo id (eliminação reversível). Escrita. |
Negócios_win
Ferramentas
| deals_win | Marque um negócio como ganho — move-o para uma fase de ganho e assinala-o como fechado; contractId opcional associa um contrato existente. Escrita. |
Negócios_lose
Ferramentas
| deals_lose | Marca um negócio como perdido — requer lostReasonId (de dealLostReasons_list); lostReasonNote opcional. Escrita. |
Negócios_reopen
Ferramentas
| deals_reopen | Reabra um negócio ganho/perdido, devolvendo-o ao estado aberto. Escrita. |
Listas de Leads_create
Ferramentas
| leadLists_create | Crie uma lista de prospeção outbound (name obrigatório). Escrita. |
Listas de Leads_update
Ferramentas
| leadLists_update | Atualize uma lista outbound pelo id. Escrita. |
Listas de Leads_delete
Ferramentas
| leadLists_delete | Elimine uma lista outbound pelo id. Escrita. |
Associações a Listas de Leads_create
Ferramentas
| leadListMemberships_create | Adicione um lead a uma lista outbound (list + lead obrigatórios; status opcional). Escrita. |
Associações a Listas de Leads_update
Ferramentas
| leadListMemberships_update | Atualize a associação de um lead a uma lista — por exemplo, defina o estado de contacto (contacted/replied/bounced). Escrita. |
Associações a Listas de Leads_delete
Ferramentas
| leadListMemberships_delete | Remova um lead de uma lista outbound. Escrita. |
Notas de CRM_create
Ferramentas
| crmNotes_create | Adicione uma nota a um lead ou a um negócio (body + exatamente um de lead/deal). O autor é o utilizador ligado. Escrita. |
Notas de CRM_update
Ferramentas
| crmNotes_update | Atualize o corpo de uma nota de CRM pelo id. Escrita. |
Notas de CRM_delete
Ferramentas
| crmNotes_delete | Elimine uma nota de CRM pelo id. Escrita. |
Logótipo da Organização_upload
Ferramentas
| organizationLogo_upload | Carrega/substitui o logótipo da organização (imagem base64 + contentType + filename). Leia o atual via configs_get organization-logo-url. Escrita. |
Ícone da Organização_upload
Ferramentas
| organizationIcon_upload | Carrega/substitui o ícone/favicon da organização (imagem base64 + contentType + filename). Leia o atual via configs_get organization-icon-url. Escrita. |
Faturas Recebidas_create
Ferramentas
| incomingInvoices_create | Arquiva uma fatura recebida (de fornecedor) ou documento de suporte na contabilidade — passe os bytes em base64 com um fileName e receivedAt. O Flowtly aplica OCR e sugere um fornecedor e uma transação bancária correspondente. O ficheiro é identificado por externalId 'upload_sha256:<sha256 dos bytes>': para evitar um duplicado, calcule o hash dos bytes e verifique incomingInvoices_list quanto a esse externalId ANTES de carregar. Escrita. |
Faturas_export
Ferramentas
| invoices_export | Inicia uma exportação zip de faturas EMITIDAS para um período (from/to, ambos em YYYY-MM-DD, inclusive) filtrado por DATA DE VENDA — não data de emissão nem de criação. Apenas faturas EMITIDAS são incluídas; rascunhos e faturas não enviadas ficam excluídos, mas as retificações SÃO incluídas. O parâmetro opcional client restringe a um cliente (id ou IRI de clients_list). Máximo de 200 faturas por exportação — se o período tiver mais, reduza-o (por exemplo, exporte um mês de cada vez); um período com 0 faturas emitidas também é recusado. Esta chamada apenas enfileira a tarefa (a renderização de um mês pode demorar minutos) — NÃO devolve uma ligação de transferência. Consulte invoices_exportStatus com o exportId devolvido até reportar "ready". Escrita. |
Faturas_export Status
Ferramentas
| invoices_exportStatus | Consulta o estado de uma exportação zip iniciada por invoices_export, pelo exportId. Assim que o status for "ready", a resposta inclui downloadUrl (uma ligação assinada de curta duração — expira em 1 hora, ver expiresAt), filename e byteSize; os bytes do ficheiro nunca são devolvidos por esta ferramenta. Se o status for "failed", failureReason explica o motivo. |
Faturas_import
Ferramentas
| invoices_import | Arquiva uma fatura emitida (de venda) JÁ EMITIDA na organização — para trazer histórico de faturação durante a integração inicial. O número de fatura externo que fornecer é preservado tal e qual, o comprador é resolvido pelo número fiscal (criado se ausente), e a fatura fica registada como emitida SEM renderizar um PDF, enviar email ao cliente ou submeter ao KSeF. Importar um número que já existe é uma operação sem efeito que reporta a fatura existente, pelo que uma importação em massa pode ser executada de novo em segurança — mas essa garantia só é válida para chamadas sequenciais; duas importações genuinamente concorrentes do mesmo número podem ambas ser registadas. Passe expectedGrossTotal (o total bruto impresso no documento de origem) e a importação é recusada se este divergir do total calculado a partir das linhas. buyer.tin é obrigatório — o comprador nunca é correspondido pelo nome. Use invoices_create, não este, para emitir uma fatura genuinamente nova. Escrita. |
Transações de Fatura_create
Ferramentas
| invoiceTransactions_create | Regista um pagamento contra uma fatura emitida (de venda). `invoice` é um IRI de fatura de invoices_list; `date` é a data em que o pagamento é considerado efetuado. `transaction` é opcional — omita-o para registar liquidação sem linha bancária, o que é o que se pretende para faturas históricas cujo extrato bancário nunca foi importado. `amount` é opcional e assume por defeito o valor em dívida da fatura. Registar um pagamento é o que impede uma fatura emitida e vencida de ser tratada como não paga, sendo também o que impede que lembretes de pagamento sejam colocados na fila para ela. Nada impede o registo de dois pagamentos contra uma fatura, por isso leia primeiro invoices_get se não tiver a certeza de que já está liquidada. Escrita. |
Transações de Fatura_update
Ferramentas
| invoiceTransactions_update | Atualiza um registo de pagamento de fatura existente por id (de invoiceTransactions em invoices_get, ou paginando invoiceTransactions). O uso mais comum: associar um pagamento registado sem linha bancária a uma transação que acabou de importar via transactions_importStatement, definindo `transaction` para um IRI/id de transação de transactions_list. A ARMADILHA: isto é um PATCH, mas o backend continua a exigir `invoice` e `date` em cada chamada — NÃO junta os valores existentes por si. Leia primeiro o registo (ou já os tenha da chamada de criação) e reenvie o seu `invoice` e `date` inalterados juntamente com o que pretende realmente alterar, ou a atualização é recusada. `transaction` aceita null para desassociar um pagamento de uma linha bancária. `amount` é opcional. Escrita. |
Faturas Recebidas_apply Suggestion
Ferramentas
| incomingInvoices_applySuggestion | Aceita uma das próprias sugestões do Flowtly numa fatura recebida — as mesmas propostas que um humano vê na aplicação (correspondência de fornecedor, grupo de custos, transação bancária correspondente, aviso de duplicado). Leia-as primeiro com incomingInvoices_suggestions, e depois aplique uma pelo seu id. Prefira isto a adivinhar: é o motor de correspondência do Flowtly, não o agente, que decide o que é plausível. Escrita. |
Faturas Recebidas_accept All Suggestions
Ferramentas
| incomingInvoices_acceptAllSuggestions | Aceite todas as sugestões pendentes de uma fatura recebida numa única chamada — o que um humano faz com o botão "aceitar tudo" da aplicação. O servidor aplica, reconstrói, e aplica novamente até não surgir nada de novo: a correspondência de transação NÃO existe até o fornecedor e o valor serem aplicados, pelo que uma única passagem deixaria o documento por associar. Devolve um relatório (o que foi aplicado, o que foi recusado e porquê, e a transação contra a qual acabou por ser arquivado). Passe dryRun para pré-visualizar sem escrever. Nunca aceita supplier_create nem um aviso de duplicado. Escrita. |
Faturas Recebidas_check EInvoices
Ferramentas
| incomingInvoices_checkEInvoices | Obtém quaisquer novas e-faturas do KSeF para a organização — o que faz o botão "Sprawdź e-faktury" da aplicação. Chame isto antes de concluir que falta a fatura de um fornecedor: sem isto não é possível distinguir "o fornecedor nunca a enviou" de "a nossa sincronização ainda não correu". Devolve assim que a obtenção é colocada em fila; releia incomingInvoices_list depois para ver o que chegou. Escrita. |
Recursos_import Timeline
Ferramentas
| resourcing_importTimeline | Importa uma folha de cronograma de alocação de recursos (obtenha-a via o MCP do Drive, passe o seu CSV tal e qual). Este é um espelho de SUBSTITUIÇÃO TOTAL das linhas de Alocação da organização para `year`: as linhas na folha são criadas/atualizadas, e qualquer linha existente para esse ano ausente da folha é ELIMINADA — não é uma fusão. SIMULAÇÃO POR DEFEITO: um dryRun omitido pré-visualiza e não escreve nada; passe dryRun:false para aplicar. O relatório dá `created` / `replaced` mais `unmatchedPeople` / `unmatchedProjects`. DUAS COISAS FÁCEIS DE PASSAR DESPERCEBIDAS: uma linha da folha cujo projeto não é resolvido é IGNORADA enquanto a chamada continua a reportar sucesso, pelo que um resultado positivo pode esconder uma importação parcial; e um código de papel que o catálogo de posições ainda não tenha é CRIADO como uma nova posição em vez de ser recusado — ver `createdPositions`. Ambos são assinalados em `warnings` quando ocorrem; transmita isso ao utilizador em vez de reportar apenas `created`. Uma folha que resulte em zero linhas é recusada (parece exatamente uma leitura incorreta prestes a apagar todo o cronograma) a menos que passe force:true. Leia allocations_list depois para ver o que ficou registado. Alto impacto. Escrita. |
Transações_import Statement
Ferramentas
| transactions_importStatement | Importa um ficheiro de extrato bancário (por exemplo, um ficheiro .sta MT940) — passe o conteúdo de texto em bruto de cada ficheiro tal e qual (NÃO em base64) com um filename. NÃO HÁ PARÂMETRO bankAccount: o backend encaminha um ficheiro removendo todos os carateres não numéricos dos números das suas contas bancárias e dos bytes do ficheiro, importando para todas as contas cujos dígitos apareçam em qualquer parte do ficheiro — pelo que um ficheiro pode ser registado em várias contas, e um extrato para uma conta que não esteja configurada no Flowtly (ou cujo número esteja registado de forma diferente da que o banco escreve) não é importado para nenhuma delas, falhando com um erro que explica exatamente porquê — leia essa mensagem, é o único diagnóstico que este endpoint fornece. Em caso de sucesso, a resposta é `{ imported, matching }`: `matching: "in_progress"` significa que a correspondência de fornecedor/anexo para as novas linhas ainda está em execução depois de esta chamada retornar, pelo que um transactions_list imediato pode mostrar linhas ainda não correspondidas — releia um pouco mais tarde para o estado final. Reimportar o mesmo extrato não cria linhas duplicadas; o importador reconhece transações já vistas. Assim que um extrato estiver importado, associe um pagamento existente sem linha bancária a uma das suas linhas com… |
Organização_whoami
Ferramentas
| organization_whoami | Devolve a organização a que esta ligação MCP está associada — { orgId, name, slug, userId }. Chame-a para confirmar A QUE inquilino está prestes a escrever antes de qualquer create/update: a ligação está fixada exatamente a uma organização pelo token, e escrever prospetos/registos na organização errada é um incidente real. Apenas leitura. |
Valores Reais de Recursos_get
Ferramentas
| resourcingActuals_get | Horas reportadas vs. o plano, por pessoa por semana, ao longo de uma janela from/to — a pergunta 'a equipa está realmente conforme o plano?', à qual NENHUMA outra ferramenta de recursos responde: as alocações dizem o que foi PLANEADO, esta diz o que foi ENTREGUE. Devolve colunas de semana mais uma linha por pessoa (% planeada, % reportada, variação, totais e uma repartição por projeto). reportedPercent nulo significa 'sem contrato nessa semana' e 0 significa 'existia um contrato e nada foi reportado' — NÃO junte os dois. Passe financials para receita/custo/margem, que são omitidos caso contrário. Requer o módulo de recursos e ROLE_RESOURCING_MANAGER. Apenas leitura. |
Banco de Recursos_get
Ferramentas
| resourcingBench_get | Quem NÃO está alocado numa janela from/to — o banco de recursos. Recorra a isto quando perguntarem quem colocar num novo projeto ou onde a capacidade está a ser desperdiçada; resourcingActuals_get diz quão carregadas as pessoas estão, este diz quem não tem carga nenhuma. NÃO SABE NADA SOBRE AUSÊNCIAS: freePercent é 100 menos as alocações confirmadas, nada mais, pelo que alguém em três semanas de férias aprovadas aparece como 100% livre, sem nenhum campo na resposta a indicar o contrário. Responder a 'quem está disponível' apenas com isto vai colocar pessoas em projetos enquanto estão ausentes — cruze com holidays_active ou holidays_list. Requer o módulo de recursos. Apenas leitura. |
Cronograma de Recursos_get
Ferramentas
| resourcingSchedule_get | O cronograma de recursos planeado ao longo de uma janela from/to — a linha temporal de alocação tal como o planeador a mostra. Use-a para o que está RESERVADO para o futuro; use resourcingActuals_get para o que foi efetivamente reportado contra ela. Requer o módulo de recursos e ROLE_RESOURCING_MANAGER. Apenas leitura. |
Leads_bulk Import
Ferramentas
| leads_bulkImport | Importa muitos leads numa ÚNICA chamada, cada um com os seus contactos, associação a listas e atividades de contacto aninhados — o servidor cria o lead e depois enfia o seu id nos filhos, pelo que nunca tem de gerir IRIs intermédios. Idempotente por chaves naturais (companyName / email / (list,lead) / (type,occurredAt,contact)): seguro de executar de novo e de dividir em partes (≤100 leads/chamada). Este é o caminho em massa que uma importação de campanha deve usar em vez de N chamadas a leads_create. Escrita. |