--- title: "Métricas do funil" method: GET path: "/api/management/project-funnels/{project_funnel_id}/metrics" tags: ["project-funnels", "Métricas"] --- # Métricas do funil `GET /api/management/project-funnels/{project_funnel_id}/metrics` Consolida os números do funil no período: contagens de projetos e etapas, distribuição e ocupação por etapa, tempo médio no funil e por etapa, atividade recente, uso de etiquetas e status e os anexos do funil. Sem `start_date` e `end_date` o período são os últimos 30 dias; o intervalo informado não pode passar de 3 meses e as datas devem estar em `YYYY-MM-DD`. Ver [Métricas e tempo por etapa](https://docs.olie.ai/guides/funnels/metrics). ## Query parameters - `start_date` string, date - `end_date` string ## Response `200` Sucesso - object - `response` boolean, required — Indica se a requisição foi bem-sucedida - `metrics` object, required - `period` object, required - `start_date` string, date, required — Data inicial do período analisado (formato: Y-m-d) - `end_date` string, date, required — Data final do período analisado (formato: Y-m-d) - `is_default` boolean, required — Indica se o período é o padrão ou foi customizado - `basic` object, required - `id` integer, required — ID do funil - `name` string, required — Nome do funil - `condition` 'active' | 'inactive', required — Condição do funil (ativo ou inativo) - `steps` object[], required - `id` integer, required — ID da etapa - `name` string, required — Nome da etapa - `form_id` integer — ID do formulário associado à etapa (null se não houver) - `funnel_form` object — Formulário associado ao funil (null se não houver) - `id` integer - `title` string - `business_area` object — Área de negócio associada ao funil (null se não houver) - `id` integer - `name` string - `created_at` string, date-time — Data de criação do funil (ISO 8601) - `updated_at` string, date-time — Data de última atualização do funil (ISO 8601) - `counts` object, required - `total_steps` integer, required — Total de etapas no funil - `total_projects` integer, required — Total de projetos vinculados ao funil - `active_projects` integer, required — Total de projetos no funil com status = em andamento - `tags_count` integer, required — Total de tags do funil - `attachments_count` integer, required — Total de anexos do funil - `steps_distribution` object[], required — Distribuição de projetos por etapa, ordenada por quantidade de projetos (maior para menor) - `step_id` integer, required — ID da etapa - `step_name` string, required — Nome da etapa - `projects_count` integer, required — Quantidade atual de projetos na etapa - `projects_entry_in_period` integer, required — Quantidade de projetos que entraram na etapa no período analisado - `projects_exit_in_period` integer, required — Quantidade de projetos que saíram da etapa no período analisado - `steps_summary` object, required - `most_occupied_step` object, required — Etapa com maior quantidade de projetos (null se não houver projetos) - `step_id` integer - `step_name` string - `step_form_id` integer - `projects_count` integer - `empty_steps_ids` integer[], required — Array com IDs das etapas que não possuem projetos - `empty_steps_count` integer, required — Quantidade de etapas vazias - `time_metrics` object, required - `average_time_in_funnel_minutes` number, required — Tempo médio (em minutos) que projetos ficam no funil, baseado em transições completas no período - `average_time_per_step_minutes` object[], required — Tempo médio por etapa - `step_id` integer, required - `step_name` string, required - `average_time_minutes` number, required — Tempo médio (em minutos) que projetos ficam nesta etapa, baseado em transições completas no período - `oldest_project_id` string, uuid, required — ID do projeto mais antigo vinculado ao funil (null se não houver projetos) - `newest_project_id` string, uuid, required — ID do projeto mais recente vinculado ao funil (null se não houver projetos) - `oldest_project_minutes` number, required — Tempo em minutos desde a criação do projeto mais antigo até agora - `newest_project_minutes` number, required — Tempo em minutos desde a criação do projeto mais recente até agora - `activity` object, required - `last_activity_at` string, date-time, required — Data e hora da última atividade no funil (transição de etapa) no período analisado (ISO 8601, null se não houver atividade) - `projects_added_in_period` integer, required — Quantidade de projetos adicionados ao funil no período analisado - `tags` object[], required — Lista de tags do funil com contagem de projetos - `id` integer, required — ID da tag - `name` string, required — Nome da tag - `color` string, required — Cor da tag em formato hexadecimal (#RRGGBB) - `projects_count` integer, required — Quantidade de projetos que possuem esta tag - `funnel_status` object[], required — Lista de status do funil com contagem de projetos - `id` integer, required — ID do status - `name` string, required — Nome do status - `color` string, required — Cor do status em formato hexadecimal (#RRGGBB) - `is_conclusive` boolean, required — Indica se este é um status conclusivo - `projects_count` integer, required — Quantidade de projetos com este status - `attachments` object[], required — Lista de anexos do funil - `id` integer, required — ID do anexo - `name` string, required — Nome do anexo - `technical_name` string, required — Nome técnico do arquivo - `extension` string, required — Extensão do arquivo - `file_url` string, uri, required — URL do arquivo - `user` object — Informações do usuário que fez upload do anexo (null se não disponível) - `id` string, uuid - `name` string - `avatar_url` string, uri --- [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/revisions/063de6e2e93c/schema)