> ## Documentation Index
> Fetch the complete documentation index at: https://suporte.deumboom.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Conector BOOM: Sensor de Jornada

> Tools somente leitura do conector BOOM para consultar o Sensor de Jornada: visão geral, triggers e disparos.

O conector BOOM expõe o Sensor de Jornada por três tools **somente leitura**. Elas chamam a [Sensor de Jornada API](https://suporte.deumboom.com/api/jornada-v1.md), que traz as regras completas de acesso, enums, erros e exemplos.

> [!NOTE]
>
> O conector aceita JWT (`eyJ…`) e token OAuth (`mct_…`) nestas tools. Token de API V2 (`bvt_…`) não autentica o Sensor de Jornada.

Nenhuma tool cria, edita, duplica ou exclui triggers, dispara manualmente, reenvia ou envia notificações.

***

## Tools

| Tool | Endpoint | Retorno |
| - | - | - |
| `core_jornada_overview` | `POST /core/v1/employee/read-filter/journey-sensor` | Página de colaboradores |
| `core_jornada_triggers_list` | `GET /core/v1/journey-trigger/{companyId}` | Lista de triggers da empresa |
| `core_jornada_disparos_list` | `GET /core/v1/journey-dispatch/{companyId}` | Lista de disparos, com status e score |

O conector só deixa passar estes três caminhos e métodos. Qualquer outro path de Jornada é bloqueado antes de chegar à API.

### Parâmetros

| Tool | Parâmetros |
| - | - |
| `core_jornada_overview` | `companyId` (obrigatório), `name`, `active`, `employeeClassificationList`, `departmentIdList`, `directorateIdList`, `businessUnitIdList`, `page` (padrão `0`), `size` (padrão `20`) |
| `core_jornada_triggers_list` | `companyId` (obrigatório) |
| `core_jornada_disparos_list` | `companyId` (obrigatório) |

Triggers e disparos devolvem a lista completa da empresa, sem paginação nem filtros. Filtre depois, no seu lado, por `status`, `onBehalfOfEmployeeId` ou `triggerName`.

### Campos sensíveis

A visão geral do conector remove campos sensíveis da resposta: CPF (hash), WhatsApp, observações e contato alternativo.

***

## O que cada perfil enxerga

| Perfil | Visão geral | Triggers | Disparos |
| - | - | - | - |
| Admin Cliente | Organização inteira | Todos | Toda a empresa |
| RH Estratégico | Organização inteira | Todos | Toda a empresa |
| RH Business Partner | Árvore do Colaborador vinculado | Todos | Somente o recorte |
| Liderança | Árvore do Colaborador vinculado | Todos | Somente o recorte |
| GPS Admin Cliente | Sem acesso | `403` | `403` |

Para saber o que o token atual pode ler, use `gps_whoami`: o campo `jornadaAccess` indica o acesso do usuário ao Sensor de Jornada.

***

## Como ler o resultado

* `score` vai de 0 a 1000 e só vem em disparos `ANSWERED`. **O score por pergunta não é retornado.**
* **Líder não precisa responder:** não existe linha de disparo do líder para aquele colaborador e trigger.
* **Líder não respondeu:** existe linha com `onBehalfOfEmployeeId` preenchido e `status` diferente de `ANSWERED`, com `score = null`.
* A fase da jornada (Entrada, Desenvolvimento, Saída) não vem na resposta. Veja a [tabela tipo → fase](https://suporte.deumboom.com/api/jornada-v1.md#fases-da-jornada).

## Erros comuns

| Erro | Quando acontece |
| - | - |
| Mensagem iniciada por `Jornada API` | A API recusou a chamada. O texto traz o HTTP e a mensagem original (veja a [tabela de erros](https://suporte.deumboom.com/api/jornada-v1.md#erros)) |
| `401` com `companyId` de outra empresa | O `companyId` não é o da empresa do usuário autenticado |
| `403` | Perfil sem acesso, como GPS Admin Cliente |

***

## Em breve

O **perfil do colaborador** (respostas de um disparo) já existe na API (`POST /core/v1/journey-trigger-audience/answers`), mas **ainda não há tool no conector** para ele.

## Pergunte ao Claude

* "Quantos colaboradores estão em onboarding na minha empresa?"
* "Quais triggers de jornada estão ativos?"
* "Quais disparos de Onboarding 30 dias estão pendentes ou expirados?"


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.