--- title: "Criar ou atualizar um funil de projeto" method: POST path: "/api/management/project-funnel" tags: ["project-funnels"] --- # Criar ou atualizar um funil de projeto `POST /api/management/project-funnel` Criar ou atualizar funil de projeto. ## Request body - object — Estrutura principal para criação ou edição de um funil. - `id` integer — ID do funil. Deve ser null na criação e preenchido em operações de atualização. - `name` string, required — Nome do funil. Campo obrigatório na criação. - `prefix` string — Prefixo utilizado para geração automática de códigos dos projetos criados dentro do funil. - `steps` object[], required — Lista de etapas que do funil. - `name` string, required — Nome da etapa do funil. - `step_forward` integer — ID da próxima etapa permitida. - `step_backward` integer — ID da etapa anterior permitida. - `show_contact_form` boolean — Define se o formulário de contato deve ser exibido ao mover um projeto para essa etapa. - `hide_contact_form_when_linked` boolean — Não exibe o formulário de contato quando já existir um contato vinculado ao projeto. - `show_customer_form` boolean — Define se o formulário de cliente deve ser exibido ao mover um projeto para essa etapa. - `hide_customer_form_when_linked` boolean — Não exibe o formulário de cliente quando já existir um cliente vinculado ao projeto. - `sensation_amount` integer — Percentual de progresso da etapa. - `help_text` string — Texto de orientação exibido ao usuário nesta etapa. - `allow_execution` boolean — Define se é permitido executar projetos nesta etapa. - `checklists` object[] — Lista de checklists obrigatórias ou opcionais da etapa. - `name` string, required — Nome da checklist. - `info` string — Descrição ou orientação da checklist. - `required` boolean, required — Indica se a checklist é obrigatória. - `order` integer, required — Ordem de exibição da checklist dentro da etapa. - `attachments` object[] — Lista de anexos vinculados à etapa. - `id` integer - `restrictions` object[] — Lista de restrições aplicadas à etapa. - `sort_config` object — Configuração de ordenação dos itens dentro da etapa. - `form` object — Formulário associado à etapa. - `id` integer - `title` string - `tags` object[] — Lista de etiquetas disponíveis no funil. - `name` string - `color` string — Cor da etiqueta em formato hexadecimal. - `funnel_step_blockings` object[] — Lista de bloqueios de etapas associados à etiqueta. - `dynamic_form` object — Formulário dinâmico associado ao funil. - `business_area` object — Área de negócio vinculada ao funil. - `id` integer - `name` string - `frame_id` string, uuid - `allow_multi_step` boolean — Permite que um projeto esteja em múltiplas etapas simultaneamente. - `project_term` object — Configuração dos termos de projeto por idioma. - `key` string — Chave de identificação da configuração de termo. Valores possíveis: custom, ticket, called, issue, deal, opportunity, lead, task, service, case, request, demand, order, process. - `en` object - `project_term` object - `singular` string, required - `plural` string, required - `pt_br` object - `project_term` object - `singular` string, required - `plural` string, required - `show_cost_info` boolean — Define se informações de custo devem ser exibidas no funil. - `form` object — Formulário principal associado ao funil. - `id` integer - `title` string - `attachments` object[] — Lista de anexos vinculados ao funil. - `id` integer - `access` object[] — Lista de usuários com acesso ao funil. - `id` string, uuid - `name` string - `avatar_url` string - `index_all` boolean — Permissão para visualizar todos os projetos. - `index_assigned` boolean — Permissão para visualizar apenas projetos atribuídos. - `index_created` boolean — Permissão para visualizar projetos criados pelo usuário. - `funnel_status` object[] — Lista de status possíveis dentro do funil. - `name` string - `color` string - `is_conclusive` boolean — Indica se o status representa conclusão. - `funnel_step_blockings` object[] - `condition` string — Condição do funil. Exemplo: active, inactive. - `allow_execution` boolean — Define se o funil permite execução de projetos. - `template_projects` object[] — Lista de projetos modelo vinculados ao funil. - `id` string, uuid ## Response `200` Funil criado com sucesso - object - `response` boolean - `project_funnel` object - `order` integer - `name` string - `condition` string - `allow_multi_step` boolean - `show_cost_info` boolean - `frame_id` string - `allow_execution` boolean - `prefix` string - `form_id` integer - `updated_at` string, date-time - `created_at` string, date-time - `id` integer - `business_area_id` integer - `business_area` object - `id` integer - `name` string - `order` integer - `frame_id` string - `steps` object[] - `id` integer - `name` string - `project_funnel_id` integer - `sensation_amount` integer - `show_contact_form` boolean - `hide_contact_form_when_linked` boolean - `show_customer_form` boolean - `hide_customer_form_when_linked` boolean - `order` integer - `help_text` string - `form_id` integer - `allow_execution` boolean - `created_at` string, date-time - `updated_at` string, date-time - `checklists` object[] - `id` integer - `name` string - `info` string - `funnel_step_id` integer - `required` boolean - `order` integer - `attachments` object[] - `id` integer - `name` string - `technical_name` string - `extension` string - `file_url` string, uri - `popup_video` integer - `watch` boolean - `user_id` string - `frame_id` string - `created_at` string, date-time - `updated_at` string, date-time - `pivot` object - `funnel_step_id` integer - `step_attachment_id` integer - `form` object - `id` integer - `title` string - `frame_id` string - `created_at` string, date-time - `updated_at` string, date-time - `restrictions` unknown[] - unknown - `tags` object[] - `id` integer - `name` string - `color` string - `project_funnel_id` integer - `attachments` unknown[] - unknown - `funnel_status` object[] - `id` integer - `name` string - `color` string - `project_funnel_id` integer - `is_conclusive` boolean - `created_at` string, date-time - `updated_at` string, date-time - `objects_above_limit` unknown[] - unknown ## Other responses - `401` — Não autorizado - `422` — Campos obrigatórios --- [API](https://skmtc.net/olie-ai/apis/olie-api.md) · [All operations](https://skmtc.net/olie-ai/apis/olie-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/olie-ai/olie-api/versions/4859f7ec8b64/schema)