@growsalesai/n8n-nodes-datacrazy 1.7.8 → 1.8.0

package/README.md

@@ -51,244 +51,273 @@ Este pacote instala **dois nós** no seu n8n:
 ## 📦 Módulos do CRM
 
 ### 🎯 Leads
+> `resources/leads/`
 
 Gerenciamento completo de leads no Datacrazy CRM.
 
-**Operações Disponíveis:**
-- **Listar Leads**: Lista todos os leads com paginação e busca por texto
-- **Buscar por ID**: Recupera um lead específico
-- **Criar Lead**: Cria um novo lead com nome, telefone, e-mail e campos extras
-- **Criar com Campos Personalizados**: Cria lead com campos adicionais via JSON
-- **Atualizar Lead**: Modifica dados de um lead existente
-- **Excluir Lead**: Remove um lead do sistema
+**Operações e rotas:**
 
-**Recursos:**
-- Filtros por texto com paginação (skip/take)
-- Suporte a tags, cidade, estado, endereço, empresa, CPF/CNPJ
-- Criação com campos personalizados via JSON livre
+| Operação | Método | Rota |
+|---|---|---|
+| Listar Leads | `GET` | `/api/v1/leads` |
+| Buscar por ID | `GET` | `/api/v1/leads/:id` |
+| Criar Lead | `POST` | `/api/v1/leads` |
+| Criar com Campos Personalizados | `POST` | `/api/v1/leads/additional-fields` |
+| Atualizar Lead | `PATCH` | `/api/v1/leads/:id` |
+| Excluir Lead | `DELETE` | `/api/v1/leads/:id` |
+
+**Recursos:** paginação (skip/take), busca por texto, suporte a tags, cidade, estado, endereço, empresa e CPF/CNPJ.
 
 ---
 
 ### 📁 Sub-recursos do Lead
+> `resources/leads/`
 
 Recursos associados diretamente a um lead:
 
 #### Negócios do Lead
-- **Listar Negócios**: Lista todos os negócios vinculados ao lead com filtros e paginação
+
+| Operação | Método | Rota |
+|---|---|---|
+| Listar Negócios | `GET` | `/api/v1/leads/:leadId/businesses` |
 
 #### Anexos do Lead
-- **Listar Anexos**: Lista arquivos anexados ao lead
-- **Criar Anexo**: Adiciona um arquivo ao lead via URL
-- **Excluir Anexo**: Remove um anexo do lead
+
+| Operação | Método | Rota |
+|---|---|---|
+| Listar Anexos | `GET` | `/api/v1/leads/:leadId/attachments` |
+| Criar Anexo | `POST` | `/api/v1/leads/:leadId/attachments` |
+| Excluir Anexo | `DELETE` | `/api/v1/leads/:leadId/attachments/:attachmentId` |
 
 #### Anotações do Lead
-- **Listar Anotações**: Lista notas/comentários do lead
-- **Criar Anotação**: Adiciona uma nova nota
-- **Atualizar Anotação**: Edita uma nota existente
-- **Excluir Anotação**: Remove uma nota
+
+| Operação | Método | Rota |
+|---|---|---|
+| Listar Anotações | `GET` | `/api/v1/leads/:leadId/notes` |
+| Criar Anotação | `POST` | `/api/v1/leads/:leadId/notes` |
+| Atualizar Anotação | `PUT` | `/api/v1/leads/:leadId/notes/:noteId` |
+| Excluir Anotação | `DELETE` | `/api/v1/leads/:leadId/notes/:noteId` |
 
 #### Histórico do Lead
-- **Listar Histórico**: Recupera o histórico de alterações do lead com paginação
+
+| Operação | Método | Rota |
+|---|---|---|
+| Listar Histórico | `GET` | `/api/v1/leads/:leadId/history` |
 
 #### Atividades do Lead
-- **Listar Atividades**: Lista atividades vinculadas ao lead com paginação
+
+| Operação | Método | Rota |
+|---|---|---|
+| Listar Atividades | `GET` | `/api/v1/leads/:leadId/activities` |
 
 ---
 
 ### 💼 Negócios
+> `resources/businesses/`
 
 Gestão completa do pipeline de vendas.
 
-**Operações Disponíveis:**
-- **Listar Negócios**: Lista todos os negócios com filtros avançados
-- **Buscar por ID**: Recupera um negócio específico
-- **Criar Negócio**: Cria um novo negócio vinculado a um lead e pipeline
-- **Atualizar Negócio**: Modifica dados do negócio
-- **Excluir Negócio**: Remove um negócio
-- **Adicionar Produto**: Vincula um produto a um negócio
-
-**Recursos:**
-- Associação com leads e pipelines
-- Definição de valor e estágio
-- Vinculação de produtos
+| Operação | Método | Rota |
+|---|---|---|
+| Listar Negócios | `GET` | `/api/v1/businesses` |
+| Buscar por ID | `GET` | `/api/v1/businesses/:id` |
+| Criar Negócio | `POST` | `/api/v1/businesses` |
+| Atualizar Negócio | `PATCH` | `/api/v1/businesses/:id` |
+| Excluir Negócio | `DELETE` | `/api/v1/businesses/:id` |
+| Adicionar Produto | `PATCH` | `/api/v1/businesses/:id` |
 
 ---
 
 ### 🎬 Ações de Negócio
+> `resources/businessActions/`
 
 Operações de transição de estado para negócios.
 
-**Operações Disponíveis:**
-- **Mover**: Move o negócio para outro estágio ou pipeline
-- **Ganhar**: Marca o negócio como ganho
-- **Perder**: Marca o negócio como perdido com motivo de perda
-- **Restaurar**: Restaura um negócio para estado ativo
+| Operação | Método | Rota |
+|---|---|---|
+| Mover | `POST` | `/api/v1/businesses/actions/move` |
+| Ganhar | `POST` | `/api/v1/businesses/actions/win` |
+| Perder | `POST` | `/api/v1/businesses/actions/lose` |
+| Restaurar | `POST` | `/api/v1/businesses/actions/restore` |
 
 ---
 
 ### ❌ Motivos de Perda
+> `resources/businessLossReasons/`
 
 Gerenciamento dos motivos de perda de negócios.
 
-**Operações Disponíveis:**
-- **Listar**: Lista todos os motivos cadastrados
-- **Buscar por ID**: Recupera um motivo específico
-- **Criar**: Cria um novo motivo de perda
-- **Atualizar**: Modifica um motivo existente
-- **Excluir**: Remove um motivo
+| Operação | Método | Rota |
+|---|---|---|
+| Listar | `GET` | `/api/v1/business-loss-reasons` |
+| Buscar por ID | `GET` | `/api/v1/business-loss-reasons/:id` |
+| Criar | `POST` | `/api/v1/business-loss-reasons` |
+| Atualizar | `PUT` | `/api/v1/business-loss-reasons/:id` |
+| Excluir | `DELETE` | `/api/v1/business-loss-reasons/:id` |
 
 ---
 
 ### 🏷️ Tags
+> `resources/tags/`
 
 Sistema de etiquetas para categorização de leads.
 
-**Operações Disponíveis:**
-- **Listar Todas**: Lista todas as tags disponíveis
-- **Buscar por ID**: Recupera uma tag específica
-- **Criar**: Cria nova tag
-- **Atualizar**: Modifica tag existente
-- **Excluir**: Remove tag do sistema
-- **Adicionar ao Lead**: Vincula uma tag a um lead
-- **Remover do Lead**: Desvincula uma tag de um lead
-
-**Recursos:**
-- Cores personalizáveis
-- Associação direta com leads
+| Operação | Método | Rota |
+|---|---|---|
+| Listar Todas | `GET` | `/api/v1/tags` |
+| Buscar por ID | `GET` | `/api/v1/tags/:id` |
+| Criar | `POST` | `/api/v1/tags` |
+| Atualizar | `PUT` | `/api/v1/tags/:id` |
+| Excluir | `DELETE` | `/api/v1/tags/:id` |
+| Adicionar ao Lead | `PATCH` | `/api/v1/leads/:leadId` |
+| Remover do Lead | `PATCH` | `/api/v1/leads/:leadId` |
 
 ---
 
 ### 📋 Listas
+> `resources/lists/`
 
 Gerenciamento de listas de segmentação.
 
-**Operações Disponíveis:**
-- **Listar Todas**: Lista todas as listas cadastradas
-- **Buscar por ID**: Recupera uma lista específica
-- **Criar**: Cria uma nova lista
-- **Atualizar**: Modifica uma lista existente
-- **Excluir**: Remove uma lista
+| Operação | Método | Rota |
+|---|---|---|
+| Listar Todas | `GET` | `/api/v1/lists` |
+| Buscar por ID | `GET` | `/api/v1/lists/:id` |
+| Criar | `POST` | `/api/v1/lists` |
+| Atualizar | `PUT` | `/api/v1/lists/:id` |
+| Excluir | `DELETE` | `/api/v1/lists/:id` |
 
 ---
 
 ### 📦 Produtos
+> `resources/products/`
 
 Catálogo de produtos do CRM.
 
-**Operações Disponíveis:**
-- **Listar Todos**: Lista todos os produtos
-- **Buscar por ID**: Recupera um produto específico
-- **Criar**: Cadastra um novo produto
-- **Atualizar**: Modifica um produto existente
-- **Excluir**: Remove um produto
+| Operação | Método | Rota |
+|---|---|---|
+| Listar Todos | `GET` | `/api/v1/products` |
+| Buscar por ID | `GET` | `/api/v1/products/:id` |
+| Criar | `POST` | `/api/v1/products` |
+| Atualizar | `PUT` | `/api/v1/products/:id` |
+| Excluir | `DELETE` | `/api/v1/products/:id` |
 
 ---
 
 ### 📅 Atividades
+> `resources/activities/`
 
 Gerenciamento de atividades e tarefas do CRM.
 
-**Operações Disponíveis:**
-- **Listar Todas**: Lista todas as atividades com paginação e busca
-- **Buscar por ID**: Recupera uma atividade específica
-- **Criar**: Cria uma nova atividade
-- **Atualizar**: Modifica uma atividade existente
-- **Excluir**: Remove uma atividade
+| Operação | Método | Rota |
+|---|---|---|
+| Listar Todas | `GET` | `/api/v1/activities` |
+| Buscar por ID | `GET` | `/api/v1/activities/:id` |
+| Criar | `POST` | `/api/v1/activities` |
+| Atualizar | `PATCH` | `/api/v1/activities/:id` |
+| Excluir | `DELETE` | `/api/v1/activities/:id` |
 
 ---
 
 ### 💬 Conversas
+> `resources/conversations/`
 
 Sistema de messaging e atendimento ao cliente.
 
-**Operações Disponíveis:**
-- **Listar Conversas**: Lista conversas com paginação e busca
-- **Buscar Mensagens**: Recupera mensagens de uma conversa específica
-- **Enviar Mensagem**: Envia mensagem em uma conversa
-- **Finalizar Conversa**: Encerra o atendimento de uma conversa
+| Operação | Método | Rota |
+|---|---|---|
+| Listar Conversas | `GET` | `/api/v1/conversations` |
+| Buscar Mensagens | `GET` | `/api/v1/conversations/:id/messages` |
+| Enviar Mensagem | `POST` | `/api/v1/conversations/:id/messages` |
+| Finalizar Conversa | `POST` | `/api/v1/conversations/:id/finish` |
 
-**Recursos:**
-- Suporte a anexos e arquivos
-- Mensagens internas e agendadas
-- Resposta a mensagens específicas (reply)
+**Recursos:** suporte a anexos, mensagens internas e agendadas, resposta a mensagens específicas (reply).
 
 ---
 
 ### 🖥️ Instâncias
+> `resources/instances/`
 
 Gerenciamento de instâncias de mensageria.
 
-**Operações Disponíveis:**
-- **Listar Todas**: Lista todas as instâncias disponíveis
-- **Buscar por ID**: Recupera uma instância específica
+| Operação | Método | Rota |
+|---|---|---|
+| Listar Todas | `GET` | `/api/v1/instances` |
+| Buscar por ID | `GET` | `/api/v1/instances/:id` |
 
 ---
 
 ### 👥 Atendentes
+> `resources/attendants/`
 
 Gerenciamento de atendentes do CRM e do multiatendimento.
 
-**Operações Disponíveis (Multiatendimento e CRM):**
-- **Listar Todos**: Lista os atendentes do módulo selecionado
-- **Buscar por ID**: Recupera um atendente específico
+| Operação | Método | Rota |
+|---|---|---|
+| Listar Todos | `GET` | `/api/v1/attendants/crm` ou `/api/v1/attendants/multi` |
+| Buscar por ID | `GET` | `/api/v1/attendants/crm/:id` ou `/api/v1/attendants/multi/:id` |
 
 ---
 
 ### 🔧 Pipelines
+> `resources/pipelines/`
 
 Gerenciamento de pipelines de vendas e seus estágios.
 
-**Operações Disponíveis:**
-- **Listar Todas**: Lista todos os pipelines
-- **Buscar por ID**: Recupera um pipeline específico
-- **Listar Estágios**: Lista os estágios de um pipeline
+| Operação | Método | Rota |
+|---|---|---|
+| Listar Todas | `GET` | `/api/v1/pipelines` |
+| Buscar por ID | `GET` | `/api/v1/pipelines/:id` |
+| Listar Estágios | `GET` | `/api/v1/pipelines/:id/stages` |
 
 ---
 
 ### ➕ Campos Personalizados
+> `resources/additionalFields/`
 
 Sistema flexível de campos customizados para leads.
 
-**Operações Disponíveis:**
-- **Listar Todos**: Lista todos os campos cadastrados
-- **Criar**: Cria um novo campo personalizado
-- **Atualizar**: Modifica um campo existente
-- **Excluir**: Remove um campo
-- **Definir Valor no Lead**: Atribui um valor de campo personalizado a um lead específico
-
-**Recursos:**
-- Carregamento dinâmico de opções nos dropdowns
-- Busca por nome ou slug
+| Operação | Método | Rota |
+|---|---|---|
+| Listar Todos | `GET` | `/api/crm/additionalFields` |
+| Criar | `POST` | `/api/crm/additionalFields` |
+| Atualizar | `PUT` | `/api/crm/additionalFields/:id` |
+| Excluir | `DELETE` | `/api/crm/additionalFields/:id` |
+| Definir Valor no Lead | `POST` | `/api/crm/additional-fields/lead/:leadId/:fieldId` |
 
 ---
 
 ### 📊 Métricas de Negócios
+> `resources/businessMetrics/`
 
 Relatórios e métricas do CRM.
 
-**Operações Disponíveis:**
-- **Funil**: Dados do funil de vendas por pipeline e período
-- **Resumo de Atendentes**: Métricas por atendente
-- **Resumo Geral**: Visão consolidada de negócios
-- **Listar Negócios**: Lista negócios com filtros de métricas
-- **Resumo Diário**: Métricas agrupadas por dia
-- **Resumo de Produtos**: Métricas por produto vendido
+| Operação | Método | Rota |
+|---|---|---|
+| Funil | `GET` | `/api/crm/businesses/metrics/funnel` |
+| Resumo de Atendentes | `GET` | `/api/crm/businesses/metrics/summary/attendants` |
+| Resumo Geral | `GET` | `/api/crm/businesses/metrics/summary` |
+| Listar Negócios | `GET` | `/api/v1/businesses` |
+| Resumo Diário | `GET` | `/api/crm/businesses/metrics/summary/daily` |
+| Resumo de Produtos | `GET` | `/api/crm/businesses/metrics/summary/products` |
 
 ---
 
 ### ⚡ Flows
+> `resources/flows/`
 
 Gerenciamento de automações e fluxos do Datacrazy.
 
-**Operações Disponíveis:**
-- **Listar Todos**: Lista todos os flows com paginação
-- **Buscar por ID**: Recupera um flow específico
-- **Listar Grupos**: Lista grupos de flows disponíveis
-- **Atualizar**: Modifica configurações de um flow
-- **Excluir**: Remove um flow
-- **Ativar**: Ativa um flow
-- **Desativar**: Desativa um flow
-- **Métricas de Versão**: Recupera métricas de execução de uma versão do flow
+| Operação | Método | Rota |
+|---|---|---|
+| Listar Todos | `GET` | `/api/crm/flows` |
+| Buscar por ID | `GET` | `/api/crm/flows/:id` |
+| Listar Grupos | `GET` | `/api/crm/flows/groups` |
+| Atualizar | `PATCH` | `/api/crm/flows/:id` |
+| Excluir | `DELETE` | `/api/crm/flows/:id` |
+| Ativar | `PATCH` | `/api/crm/flows/:id` |
+| Desativar | `PATCH` | `/api/crm/flows/:id` |
+| Métricas de Versão | `GET` | `/api/crm/flows/:id/versions/:versionId/metrics` |
 
 ---
 
@@ -297,55 +326,101 @@ Gerenciamento de automações e fluxos do Datacrazy.
 O nó **Datacrazy Automações** oferece utilitários inteligentes para construir fluxos com webhooks e lógica de CRM sem precisar escrever código.
 
 ### ⚡ Analisar Webhook Datacrazy
+> `automations/webhookParser/`
+
 Normaliza o payload recebido de um webhook do Datacrazy e extrai os campos principais: provedor, tipo de mensagem, texto, mídia, lead, token, conversa e muito mais.
 
 - Detecção automática de provedor (WhatsApp Cloud API, Instagram API, UAZAP)
 - Extração de `leadId`, `token_datacrazy`, `conversationId`, `contactPhone`
 - Suporte a detecção de anúncios (referral/CTWA)
 
+---
+
 ### ⚡ Switch Tipo de Mensagem
+> `automations/messageTypeSwitch/`
+
 Roteia o item para a saída correta com base no tipo da mensagem recebida.
 
 **Saídas:** Texto · Imagem · Vídeo · Áudio · Arquivo · Outro
 
+---
+
 ### ⚡ É Mensagem Referenciada?
+> `automations/replyChecker/`
+
 Verifica se a mensagem recebida é uma resposta (reply) a outra mensagem.
 
 **Saídas:** Sim · Não
 
+---
+
 ### ⚡ Detectar Provedor do Webhook
+> `automations/providerDetector/`
+
 Identifica o provedor de origem do webhook.
 
 **Provedores suportados:** WhatsApp Cloud API · Instagram API · UAZAP · Desconhecido
 
+---
+
 ### ⚡ Extrair Info do Webhook
+> `automations/webhookExtractor/`
+
 Estrutura todos os campos do payload em objetos aninhados e organizados: `contact`, `message`, `attachment`, `referral`, `instance`, `conversation`.
 
+---
+
 ### ⚡ Contexto de Mensagem Referenciada
+> `automations/messageContext/`
+
 Verifica se a mensagem é um reply e, se for, busca o conteúdo da mensagem original na conversa do Datacrazy.
 
+| Rota usada | Método | Descrição |
+|---|---|---|
+| `/api/v1/conversations/:id/messages` | `GET` | Busca mensagens da conversa para encontrar o contexto |
+
+---
+
 ### ⚡ Mover Lead na Pipeline
+> `automations/leadMover/`
+
 Busca os negócios do lead, filtra pela pipeline desejada e move para a etapa destino.
 
-**Recursos:**
-- Seleção de negócio mais recente ou todos os negócios da pipeline
-- Criação automática de anotação ao mover
-- Dropdowns dinâmicos de pipelines e etapas
+| Rota usada | Método | Descrição |
+|---|---|---|
+| `/api/v1/leads/:leadId/businesses` | `GET` | Lista negócios do lead |
+| `/api/v1/businesses/:id` | `PATCH` | Move o negócio para o novo estágio |
+| `/api/v1/leads/:leadId/notes` | `POST` | Cria anotação opcional ao mover |
+
+**Recursos:** seleção do negócio mais recente ou todos, dropdowns dinâmicos de pipelines e etapas.
+
+---
 
 ### ⚡ If Condicional do Lead
+> `automations/leadIfCondition/`
+
 Verifica uma condição no lead e roteia para **Sim** ou **Não**.
 
-**Condições suportadas:**
-- Possui / não possui uma tag específica
-- Campo personalizado igual a valor
-- Campo personalizado contém valor
-- Está em determinada pipeline
-- Está em determinado estágio
-- Está em pipeline **e** estágio específicos
+| Rota usada | Método | Descrição |
+|---|---|---|
+| `/api/v1/leads/:leadId` | `GET` | Lê dados do lead |
+| `/api/crm/additionalFields` | `GET` | Busca definições de campos (cache por execução) |
+| `/api/crm/additional-fields/lead/:leadId/:fieldId` | `GET` | Lê valor do campo no lead |
+| `/api/v1/leads/:leadId/businesses` | `GET` | Verifica pipeline/estágio |
+
+**Condições suportadas:** possui/não possui tag · campo personalizado igual/contém valor · está em pipeline · está em estágio · está em pipeline e estágio.
+
+---
 
 ### ⚡ Tracker do Lead
+> `automations/leadTracker/`
+
 Define múltiplos campos personalizados em um lead de uma só vez, com controle de erro por campo.
 
+| Rota usada | Método | Descrição |
+|---|---|---|
+| `/api/crm/additional-fields/lead/:leadId/:fieldId` | `POST` | Define valor de cada campo |
+
 ---
 
 ## 🛠️ Desenvolvimento
@@ -382,11 +457,87 @@ nodes/Datacrazy/
 ├── DatacrazyUtils.node.ts         # Nó de automações utilitárias
 ├── DatacrazyMsgSwitch.node.ts     # Switch de tipo de mensagem (standalone)
 ├── DatacrazyReplyCheck.node.ts    # Verificador de reply (standalone)
-├── descriptions/                  # Definições de campos e operações por recurso
-├── handlers/                      # Lógica de execução por recurso
-│   └── utils/                     # Handlers dos nós utilitários
+│
+├── resources/                     # Recursos da API CRM (cada um com description + handler)
+│   ├── leads/
+│   │   ├── lead.description.ts
+│   │   ├── lead.handler.ts
+│   │   ├── leadSubResource.description.ts
+│   │   └── leadSubResources.handler.ts
+│   ├── businesses/
+│   │   ├── business.description.ts
+│   │   └── business.handler.ts
+│   ├── businessActions/
+│   │   ├── businessAction.description.ts
+│   │   └── businessAction.handler.ts
+│   ├── businessLossReasons/
+│   │   ├── businessLossReason.description.ts
+│   │   └── businessLossReason.handler.ts
+│   ├── businessMetrics/
+│   │   ├── businessMetrics.description.ts
+│   │   └── businessMetrics.handler.ts
+│   ├── tags/
+│   │   ├── tag.description.ts
+│   │   └── tag.handler.ts
+│   ├── lists/
+│   │   ├── list.description.ts
+│   │   └── list.handler.ts
+│   ├── products/
+│   │   ├── product.description.ts
+│   │   └── product.handler.ts
+│   ├── activities/
+│   │   ├── activity.description.ts
+│   │   └── activity.handler.ts
+│   ├── conversations/
+│   │   ├── conversation.description.ts
+│   │   └── conversation.handler.ts
+│   ├── instances/
+│   │   ├── instance.description.ts
+│   │   └── instance.handler.ts
+│   ├── attendants/
+│   │   ├── attendant.description.ts
+│   │   └── attendant.handler.ts
+│   ├── pipelines/
+│   │   ├── pipeline.description.ts
+│   │   └── pipeline.handler.ts
+│   ├── additionalFields/
+│   │   ├── additionalField.description.ts
+│   │   └── additionalField.handler.ts
+│   └── flows/
+│       ├── flow.description.ts
+│       └── flow.handler.ts
+│
+├── automations/                   # Nós utilitários de automação (cada um com description + handler)
+│   ├── webhookParser/
+│   │   ├── webhookParser.description.ts
+│   │   └── webhookParser.handler.ts
+│   ├── webhookExtractor/
+│   │   ├── webhookExtractor.description.ts
+│   │   └── webhookExtractor.handler.ts
+│   ├── providerDetector/
+│   │   ├── providerDetector.description.ts
+│   │   └── providerDetector.handler.ts
+│   ├── messageContext/
+│   │   ├── messageContext.description.ts
+│   │   └── messageContext.handler.ts
+│   ├── messageTypeSwitch/
+│   │   ├── messageTypeSwitch.description.ts
+│   │   └── messageTypeSwitch.handler.ts
+│   ├── replyChecker/
+│   │   ├── replyChecker.description.ts
+│   │   └── replyChecker.handler.ts
+│   ├── leadMover/
+│   │   ├── leadMover.description.ts
+│   │   └── leadMover.handler.ts
+│   ├── leadIfCondition/
+│   │   ├── leadIfCondition.description.ts
+│   │   └── leadIfCondition.handler.ts
+│   └── leadTracker/
+│       ├── leadTracker.description.ts
+│       └── leadTracker.handler.ts
+│
 ├── methods/
-│   └── loadOptions.ts             # Funções de carregamento dinâmico de dropdowns
+│   └── loadOptions.ts             # Carregamento dinâmico de dropdowns
 └── utils/
     └── request.ts                 # Camada de requisições HTTP autenticadas
 credentials/