project-funnels
Ciclo de vida

Clonar um funil

Cria uma cópia do funil com toda a configuração — etapas, checklists, restrições, etiquetas, status, anexos, automações, assistentes, modelos de configurações de visualização, permissões e templates de projeto (sem trazer os projetos reais). Sem name, a cópia recebe o nome do original seguido de (Clone). Funis arquivados não podem ser clonados.

O que clonar: cada categoria pode ser desligada individualmente pelas flags booleanas do corpo. Flag omitida ou null equivale a true, então uma chamada sem flags clona tudo.

Dependências forçadas: algumas categorias são ligadas automaticamente quando outra depende delas. Se automations, step_restrictions ou funnel_step_blockings estiver true, então funnel_tags e funnel_statuses viram true mesmo que enviados como false. Se automations estiver true, step_assistants também vira true. Ou seja, desligar etiquetas/status só tem efeito quando os três primeiros estão false.

O funil, as etapas, os vínculos de formulário e a área de negócio são sempre clonados e não têm flag. Formulários, agentes de IA e áreas de negócio são reaproveitados (não duplicados).

Ver Criar e configurar um funil.

post/api/management/clone-funnel

Request body

project_funnel_idinteger required

ID do funil a clonar. Obrigatório.

namestring nullable

Nome do funil clonado. Sem ele, o nome vira o do original seguido de (Clone). Máximo de 255 caracteres.

automationsboolean nullable

Automações: copia as automações ligadas às etapas deste funil. Quando true, força funnel_tags, funnel_statuses e step_assistants. Padrão true.

step_restrictionsboolean nullable

Restrições: copia as restrições das etapas. Quando true, força funnel_tags e funnel_statuses. Padrão true.

step_assistantsboolean nullable

Assistentes: copia os vínculos de assistente nas etapas (os agentes existentes são reutilizados). Forçado para true quando automations é true. Padrão true.

step_checklistsboolean nullable

Checklists: copia os checklists das etapas. Padrão true.

funnel_step_blockingsboolean nullable

Bloqueio de etapas: copia os bloqueios de etapas das etiquetas/status do funil. Quando true, força funnel_tags e funnel_statuses. Padrão true.

funnel_tagsboolean nullable

Etiquetas: copia as etiquetas do funil. Obrigatório enquanto automações, restrições ou bloqueios estiverem marcados — só tem efeito como false quando automations, step_restrictions e funnel_step_blockings estão todos false. Padrão true.

funnel_statusesboolean nullable

Status: copia os status do funil. Obrigatório enquanto automações, restrições ou bloqueios estiverem marcados — só tem efeito como false quando automations, step_restrictions e funnel_step_blockings estão todos false. Padrão true.

funnel_attachmentsboolean nullable

Anexos: copia anexos do funil e vínculos de anexo nas etapas. Padrão true.

funnel_config_templatesboolean nullable

Modelos de configurações de visualização: copia modelos de configurações de visualização do funil. Padrão true.

permissionsboolean nullable

Permissões: replica permissões de acesso do funil original para o clone. Padrão true.

template_projectsboolean nullable

Templates de projeto: copia os vínculos com templates de projeto do funil original. Padrão true.

Response

Sucesso

responseboolean required

Sempre true quando a operação é concluída.

Changes

Changed in 5 of the 79 revisions of this API.10720

  • 8c9bac94e5ad511See the full diff
    • the name request property's maxLength was set to 255

      request-property-max-length-set

    • added the new cant_clone_archived_project_funnel enum value to the message response property for the response status 422

      response-property-enum-value-added

    • added the new funnel_clone_missing_funnel enum value to the message response property for the response status 422

      response-property-enum-value-added

    • added the new funnel_clone_partial_failure enum value to the message response property for the response status 422

      response-property-enum-value-added

    • added the new validation_errors enum value to the message response property for the response status 422

      response-property-enum-value-added

    • added the new optional request property automations

      new-optional-request-property

    • added the new optional request property funnel_attachments

      new-optional-request-property

    • added the new optional request property funnel_config_templates

      new-optional-request-property

    • added the new optional request property funnel_statuses

      new-optional-request-property

    • added the new optional request property funnel_step_blockings

      new-optional-request-property

    • added the new optional request property funnel_tags

      new-optional-request-property

    • added the new optional request property permissions

      new-optional-request-property

    • added the new optional request property step_assistants

      new-optional-request-property

    • added the new optional request property step_checklists

      new-optional-request-property

    • added the new optional request property step_restrictions

      new-optional-request-property

    • added the new optional request property template_projects

      new-optional-request-property

  • 3c590152d5b51024See the full diff
    • the request property project_funnel_id became not nullable

      request-property-became-not-nullable

    • the request property project_funnel_id became required

      request-property-became-required

    • the name request property type/format changed from / to string/

      request-property-type-changed

    • the project_funnel_id request property type/format changed from / to integer/

      request-property-type-changed

    • the response property project_funnel/business_area_id became nullable for the status 200

      response-property-became-nullable

    • the response property project_funnel/prefix became nullable for the status 200

      response-property-became-nullable

    • the project_funnel/deleted_at response's property type/format changed from / to string/date-time for status 200

      response-property-type-changed

    • the project_funnel/form_id response's property type/format changed from / to integer/ for status 200

      response-property-type-changed

    • the project_funnel/funnel_config_template_id response's property type/format changed from / to integer/ for status 200

      response-property-type-changed

    • the project_funnel/project_term response's property type/format changed from / to object/ for status 200

      response-property-type-changed

    • added the new active enum value to the project_funnel/condition response property for the response status 200

      response-property-enum-value-added

    • added the new inactive enum value to the project_funnel/condition response property for the response status 200

      response-property-enum-value-added

    • the response property message became required for the status 422

      response-property-became-required

    • the response property project_funnel became required for the status 200

      response-property-became-required

    • the response property response became required for the status 200

      response-property-became-required

    • the response property response became required for the status 422

      response-property-became-required

    • added the media type application/json for the response with the status 200

      response-media-type-added

    • added the non-success response with the status 422

      response-non-success-status-added

    • added optional request body

      request-body-added-optional

    • api tag Ciclo de vida added

      api-tag-added

    • api tag {project_funnel_id} removed

      api-tag-removed