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

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

automationsboolean

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

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

step_assistantsboolean

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

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

funnel_step_blockingsboolean

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

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

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

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

funnel_config_templatesboolean

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

permissionsboolean

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

template_projectsboolean

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 6 of the 98 revisions of this API.22720

    • ▲

      the request property became not nullable

      request-property-became-not-nullable

    • ▲

      the request property became not nullable

      request-property-became-not-nullable

    • ▲

      the request property became not nullable

      request-property-became-not-nullable

    • ▲

      the request property became not nullable

      request-property-became-not-nullable

    • ▲

      the request property became not nullable

      request-property-became-not-nullable

    • ▲

      the request property became not nullable

      request-property-became-not-nullable

    • ▲

      the request property became not nullable

      request-property-became-not-nullable

    • ▲

      the request property became not nullable

      request-property-became-not-nullable

    • ▲

      the request property became not nullable

      request-property-became-not-nullable

    • ▲

      the request property became not nullable

      request-property-became-not-nullable

    • ▲

      the request property became not nullable

      request-property-became-not-nullable

    • ▲

      the request property became not nullable

      request-property-became-not-nullable

  • 8c9bac94e5ad511See the full diff
    • ●

      the 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 response property for the response status

      response-property-enum-value-added

    • ●

      added the new funnel_clone_missing_funnel enum value to the response property for the response status

      response-property-enum-value-added

    • ●

      added the new funnel_clone_partial_failure enum value to the response property for the response status

      response-property-enum-value-added

    • ●

      added the new validation_errors enum value to the response property for the response status

      response-property-enum-value-added

    • ○

      added the new optional request property

      new-optional-request-property

    • ○

      added the new optional request property

      new-optional-request-property

    • ○

      added the new optional request property

      new-optional-request-property

    • ○

      added the new optional request property

      new-optional-request-property

    • ○

      added the new optional request property

      new-optional-request-property

    • ○

      added the new optional request property

      new-optional-request-property

    • ○

      added the new optional request property

      new-optional-request-property

    • ○

      added the new optional request property

      new-optional-request-property

    • ○

      added the new optional request property

      new-optional-request-property

    • ○

      added the new optional request property

      new-optional-request-property

    • ○

      added the new optional request property

      new-optional-request-property

  • 3c590152d5b51024See the full diff
    • ▲

      the request property became not nullable

      request-property-became-not-nullable

    • ▲

      the request property became required

      request-property-became-required

    • ▲

      the request property type changed from no type to string

      request-property-type-changed

    • ▲

      the request property type changed from no type to integer

      request-property-type-changed

    • ▲

      the response property / became nullable for the status

      response-property-became-nullable

    • ▲

      the response property / became nullable for the status

      response-property-became-nullable

    • ▲

      the / response's property type changed from no type to string, and format from no format to date-time for status

      response-property-type-changed

    • ▲

      the / response's property type changed from no type to integer for status

      response-property-type-changed

    • ▲

      the / response's property type changed from no type to integer for status

      response-property-type-changed

    • ▲

      the / response's property type changed from no type to object for status

      response-property-type-changed

    • ●

      added the new active enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new inactive enum value to the / response property for the response status

      response-property-enum-value-added

    • ○

      the response property became required for the status

      response-property-became-required

    • ○

      the response property became required for the status

      response-property-became-required

    • ○

      the response property became required for the status

      response-property-became-required

    • ○

      the response property became required for the status

      response-property-became-required

    • ○

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

      response-media-type-added

    • ○

      added the non-success response with the status

      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