Files
upstream-twenty/packages/twenty-docs/l/pt/user-guide/views-pipelines/how-tos/show-expected-amount-in-pipeline.mdx
upstream-mirror e7da97194a
Some checks failed
App Prod-Parity E2E Dispatch / dispatch (push) Failing after 10s
CD Storybook UI / build (push) Failing after 3m25s
CD Storybook UI / dispatch (push) Has been skipped
CD deploy main / website-changed-files (push) Successful in 18m8s
CI Agent Skills / changed-files-check (push) Successful in 18m9s
CI Create App E2E minimal / changed-files-check (push) Successful in 24s
CI Create App / changed-files-check (push) Successful in 26s
CI Docs / changed-files-check (push) Successful in 26s
CI Emails / changed-files-check (push) Successful in 28s
CI Example App Hello World / changed-files-check (push) Successful in 23s
CI Front / changed-files-check (push) Has been skipped
CI Example App Postcard / changed-files-check (push) Successful in 27s
CI UI / changed-files-check (push) Has been skipped
CI Utils Test / changed-files-check (push) Successful in 45s
CI Twenty Apps / discover (push) Successful in 1m3s
CD deploy main / deploy-main (push) Failing after 3s
CI Agent Skills / agent-skills-validate (push) Has been skipped
CI Create App / create-app-test (lint) (push) Has been skipped
CI Emails / emails-test (push) Has been skipped
CI Front / front-task (lingui:compile) (push) Has been skipped
CI Front / front-task (lint) (push) Has been skipped
CI Example App Postcard / example-app-postcard (push) Has been skipped
CI UI / ui-task (lint) (push) Has been skipped
CI UI / ui-task (pack-size) (push) Has been skipped
CI UI / ui-task (size) (push) Has been skipped
CI UI / ui-task (test) (push) Has been skipped
CI UI / ui-task (typecheck) (push) Has been skipped
CI Utils Test / utils-test (push) Has been skipped
CI Twenty Apps / ${{ matrix.app.name }} (push) Has been skipped
CI Emails / ci-emails-status-check (push) Successful in 2s
CI Example App Hello World / ci-example-app-hello-world-status-check (push) Successful in 2s
CI Example App Postcard / ci-example-app-postcard-status-check (push) Successful in 3s
CI UI / ui-sb-test (push) Has been skipped
CI Utils Test / ci-utils-test-status-check (push) Successful in 2s
CI Twenty Apps / ci-twenty-apps-status-check (push) Successful in 2s
CI UI / ci-ui-status-check (push) Successful in 2s
CI Desktop / desktop (push) Failing after 1m8s
Push docs to Crowdin / Push documentation to Crowdin (push) Failing after 55s
Push translations to Crowdin / Extract and upload translations (push) Failing after 5s
Push website translations to Crowdin / Extract and upload website translations (push) Failing after 5s
CI Create App / create-app-test (test) (push) Has been skipped
CI Create App / create-app-test (typecheck) (push) Has been skipped
CI Docs / docs-lint (push) Has been skipped
CI Example App Hello World / example-app-hello-world (push) Has been skipped
CI Front / front-task (lingui:extract) (push) Has been skipped
CI Front / front-task (test) (push) Has been skipped
CI Front / front-task (typecheck) (push) Has been skipped
CI UI / ui-sb-build (push) Failing after 1m32s
CI Twenty Apps / ${{ matrix.app.name }} (${{ matrix.server-source }}) (push) Has been skipped
CI Agent Skills / agent-skills-publish (push) Has been skipped
CI Create App / ci-create-app-status-check (push) Successful in 2s
CI Agent Skills / agent-skills-remote-source (push) Has been skipped
CI Create App E2E minimal / create-app-e2e-minimal (push) Has been cancelled
CI E2E Main / e2e-test (push) Has been cancelled
CI Front / front-sb-build (push) Has been cancelled
CI Front / front-build (push) Has been cancelled
CI Create App E2E minimal / ci-create-app-e2e-minimal-status-check (push) Has been cancelled
CI E2E Main / ci-e2e-main-status-check (push) Has been cancelled
CI E2E Main / notify-main-ci-failure (push) Has been cancelled
CI E2E Main / qa-scout-comment (push) Has been cancelled
CI Front / front-sb-test (push) Has been cancelled
CI Front / front-sb-screenshots (push) Has been cancelled
CI Front / ci-front-status-check (push) Has been cancelled
DPA Sub-Processor Sync / sync-subprocessors (push) Failing after 3s
AI Catalog Sync / sync-catalog (push) Failing after 3s
snapshot of https://github.com/twentyhq/twenty.git (main, 2026-09-17; blobs > 131072B omitted)
2026-09-17 23:28:13 +05:00

150 lines
5.6 KiB
Plaintext
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
---
title: Mostrar o Valor Esperado no seu pipeline
description: Calcule e exiba valores ponderados de negócios com base na probabilidade da etapa.
---
O Valor Esperado é um valor calculado: **Amount × Probability**. Isso ajuda você a prever a receita, ponderando os negócios com base na probabilidade de fechamento.
<Tip>
Este é um exemplo de criação de [Campos de fórmula](/l/pt/user-guide/workflows/how-tos/crm-automations/formula-fields) usando fluxos de trabalho.
</Tip>
Este guia orienta você na configuração dos campos personalizados e fluxos de trabalho necessários para calcular e exibir valores esperados no seu pipeline.
## Etapa 1: Criar campos personalizados
Você precisa de dois campos personalizados no objeto Oportunidades.
### Crie o campo Probability
1. Acesse **Configurações → Modelo de Dados → Oportunidades**
2. Clique em **+ Adicionar campo**
3. Configurar:
* **Nome**: Probability
* **Tipo**: Número
* **Descrição**: Probabilidade baseada na etapa (0-100%)
4. Clique em **Salvar**
### Crie o campo Expected Amount
1. Clique em **+ Adicionar campo**
2. Configurar:
* **Nome**: Expected Amount
* **Tipo**: Moeda
* **Descrição**: Calculado: Amount × Probability
3. Clique em **Salvar**
### Opcional: tornar os campos somente leitura para os usuários
Se você não quiser que os usuários editem manualmente esses campos calculados:
1. Vá para **Configurações → Membros → Funções**
2. Selecione a função a configurar
3. Encontre o objeto Oportunidades
4. Defina os campos **Probability** e **Expected Amount** como somente leitura
Isso garante que apenas os fluxos de trabalho possam atualizar esses valores.
## Etapa 2: Criar o fluxo de trabalho nº 1 — Atualizar Probability na alteração de etapa
Este fluxo de trabalho define automaticamente o campo Probability quando uma oportunidade é movida para uma nova etapa.
### Criar o fluxo de trabalho
1. Acesse **Fluxos de trabalho**
2. Clique em **+ Novo fluxo de trabalho**
3. Nomeie como "Update Probability on Stage Change"
### Configurar o gatilho
1. Adicione um gatilho **Registro criado ou atualizado**
2. Selecione **Oportunidades** como o objeto
3. Filtre por: o campo **Stage** é atualizado
### Adicione ramificações para cada etapa
Crie uma ramificação para cada etapa com sua probabilidade:
| Etapa | Probabilidade |
| ----------- | ------------- |
| Novo | 10% |
| Qualificado | 25% |
| Meeting | 40% |
| Proposal | 60% |
| Negotiation | 80% |
| Closed Won | 100% |
| Closed Lost | 0% |
<Note>
Para criar uma nova ramificação, clique com o botão direito na tela do fluxo de trabalho e clique em **Nova ação**. Em seguida, vincule essa ação ao nó anterior arrastando a seta do nó anterior para esta nova ação.
</Note>
Para cada etapa:
1. Adicione um nó **Filtro**: Stage = [nome da etapa]
2. Adicione uma ação **Atualizar registro**:
* Registro: a Oportunidade que acionou
* Campo: Probability
* Valor: [probabilidade para essa etapa]
### Calcular o Valor Esperado
Depois que as ramificações se unirem:
1. Adicione um nó **Filtro**: Amount não está vazio
2. Adicione uma ação **Atualizar registro**:
* Registro: a Oportunidade que acionou
* Campo: Expected Amount
* Valor: Amount × Probability
## Etapa 3: Criar o fluxo de trabalho nº 2 — Recalcular na alteração de Amount
Este fluxo de trabalho atualiza o campo Expected Amount quando o Amount do negócio é alterado.
### Criar o fluxo de trabalho
1. Acesse **Fluxos de trabalho**
2. Clique em **+ Novo fluxo de trabalho**
3. Nomeie como "Recalculate Expected Amount on Amount Change"
### Configurar o gatilho
1. Adicione um gatilho **Registro criado ou atualizado**
2. Selecione **Oportunidades** como o objeto
3. Filtre por: o campo **Amount** é atualizado
### Adicione a lógica
1. Adicione um nó **Filtro**: Amount não está vazio
2. Adicione uma ação **Atualizar registro**:
* Registro: a Oportunidade que acionou
* Campo: Expected Amount
* Valor: Amount × Probability
## Etapa 4: Exibir no seu pipeline
Agora mostre os totais de Expected Amount na sua visualização Kanban:
1. Abra a visualização Kanban do seu **Pipeline de Vendas**
2. Clique no **número** ao lado de qualquer nome de Stage no topo de uma coluna
3. Selecione **Soma**
4. Escolha **Expected Amount**
Cada coluna agora mostra o valor total ponderado do pipeline para essa etapa.
## Resumo
| Componente | Finalidade |
| -------------------------- | --------------------------------------------------------------------------------- |
| **Campo Probability** | Armazena a probabilidade de ganho baseada na etapa |
| **Campo Expected Amount** | Armazena Amount × Probability |
| **Fluxo de trabalho nº 1** | Atualiza Probability quando a Stage muda e, em seguida, recalcula Expected Amount |
| **Fluxo de trabalho nº 2** | Recalcula Expected Amount quando Amount muda |
| **Agregação** | Exibe a soma de Expected Amount por etapa |
## Relacionados
* [Campos de fórmula](/l/pt/user-guide/workflows/how-tos/crm-automations/formula-fields) — crie campos calculados usando fluxos de trabalho
* [Visualizações de Kanban](/l/pt/user-guide/views-pipelines/capabilities/kanban-views) — agregações por coluna
* [Como criar campos personalizados](/l/pt/user-guide/data-model/how-tos/create-custom-fields) — configuração de campos