> For the complete documentation index, see [llms.txt](https://docs.hablla.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.hablla.com/fluxos-de-automacoes/todos-os-componentes/hablla/organizacoes.md). # Organizações O componente **Organizações** permite gerenciar os registros de empresas no sistema, possibilitando **criação, atualização, remoção e associação de contatos** a uma organização. ### 📂 **Operações Disponíveis** Aqui estão as operações que podem ser realizadas com este componente: | Operação | Descrição | | --------------------------------------------- | -------------------------------------------------------------------------- | | **Criar** (`create`) | Cria uma nova organização. | | **Atualizar** (`update`) | Atualiza os dados de uma organização existente. | | **Criar ou Atualizar** (`create_or_update`) | Se a organização existir, atualiza; se não existir, cria um novo registro. | | **Deletar** (`delete`) | Remove uma organização do sistema. | | **Buscar todas** (`get_all`) | Obtém uma lista de todas as organizações cadastradas. | | **Buscar pessoas vinculadas** (`get_persons`) | Retorna todas as pessoas associadas a uma organização. | | **Adicionar pessoas** (`add_persons`) | Adiciona uma ou mais pessoas a uma organização. | | **Remover pessoas** (`remove_persons`) | Remove uma ou mais pessoas de uma organização. | *** ### 🎯 **Como Configurar uma Operação** #### 1️⃣ **Acesse o Componente** * No **Hablla Studio**, abra o fluxo de automação onde deseja incluir a ação. * Adicione o bloco **"Organizações"**. * No **painel lateral direito**, configure a operação desejada. *** ### 📝 **Detalhamento das Operações** #### **1. Criar Organização** 💡 **O que faz?**\ Essa operação permite criar um novo registro de organização no sistema. 🔹 **Campos obrigatórios:** * **Nome da organização** * **CNPJ (se aplicável)** 🔹 **Campos opcionais:** * **Sobre** (Descrição da organização) * **Endereço** * **Telefones** * **E-mails** * **Dono da organização** * **Tags personalizadas** ✅ **Passo a passo:** 1. Escolha a operação **"Criar"**. 2. Preencha os campos obrigatórios e opcionais. 3. Clique em **Salvar** ✅. *** #### **2. Atualizar Organização** 💡 **O que faz?**\ Atualiza as informações de uma organização existente. 🔹 **Campos obrigatórios:** * **ID da organização** (pode ser recuperado de outra etapa da automação). ✅ **Passo a passo:** 1. Escolha a operação **"Atualizar"**. 2. Insira o ID da organização e os campos a serem alterados. 3. Clique em **Salvar** ✅. *** #### **3. Criar ou Atualizar Organização** 💡 **O que faz?**\ Verifica se a organização já existe: * Se **existir**, **atualiza os dados**. * Se **não existir**, **cria um novo registro**. ✅ **Passo a passo:** 1. Escolha a operação **"Criar ou Atualizar"**. 2. Preencha os dados da organização. 3. Defina a **regra de identificação**: * **Mais antiga** (mantém o primeiro registro). * **Mais recente** (mantém o mais atualizado). 4. Clique em **Salvar** ✅. *** #### **4. Deletar Organização** 💡 **O que faz?**\ Remove permanentemente uma organização do sistema. 🔹 **Campos obrigatórios:** * **ID da organização** ✅ **Passo a passo:** 1. Escolha a operação **"Deletar"**. 2. Informe o ID da organização. 3. Confirme a ação e clique em **Salvar** ✅. *** #### **5. Buscar Todas as Organizações** 💡 **O que faz?**\ Recupera uma lista de todas as organizações cadastradas. 🔹 **Filtros opcionais:** * **Busca por nome** * **CNPJ** * **Status (ativo, inativo, etc.)** * **Tags** * **Usuário vinculado** ✅ **Passo a passo:** 1. Escolha a operação **"Buscar Todas"**. 2. Aplique filtros, se necessário. 3. Clique em **Salvar** ✅. *** #### **6. Buscar Pessoas Vinculadas a uma Organização** 💡 **O que faz?**\ Obtém a lista de pessoas associadas a uma organização. 🔹 **Campos obrigatórios:** * **ID da organização** ✅ **Passo a passo:** 1. Escolha a operação **"Buscar Pessoas"**. 2. Insira o ID da organização. 3. Clique em **Salvar** ✅. *** #### **7. Adicionar Pessoas a uma Organização** 💡 **O que faz?**\ Vincula uma ou mais pessoas a uma organização. 🔹 **Campos obrigatórios:** * **ID da organização** * **IDs das pessoas a serem adicionadas** ✅ **Passo a passo:** 1. Escolha a operação **"Adicionar Pessoas"**. 2. Insira o ID da organização e os IDs das pessoas. 3. Clique em **Salvar** ✅. *** #### **8. Remover Pessoas de uma Organização** 💡 **O que faz?**\ Remove uma ou mais pessoas de uma organização. 🔹 **Campos obrigatórios:** * **ID da organização** * **IDs das pessoas a serem removidas** ✅ **Passo a passo:** 1. Escolha a operação **"Remover Pessoas"**. 2. Insira o ID da organização e os IDs das pessoas. 3. Clique em **Salvar** ✅. *** ### ⚙️ **Filtros e Personalizações** Além das operações básicas, você pode aplicar **filtros** e **adicionar campos personalizados**: ✅ **Filtros disponíveis para busca:** * **Nome** * **CNPJ** * **Status** * **Tags** * **Dono da organização** * **Campos personalizados** ✅ **Campos personalizáveis:** * **E-mails** * **Endereços** * **Telefones** * **Tags** * **Usuários responsáveis** *** ### 🚀 **Exemplo de Uso no Fluxo de Automação** 📌 **Cenário:** Você deseja criar um fluxo onde um novo lead é cadastrado e automaticamente vinculado a uma organização. 1. **Bloco 1** → Criar um novo **Lead**. 2. **Bloco 2** → Buscar a organização pelo **CNPJ**. 3. **Bloco 3** → Se a organização existir, **adicionar a pessoa**. 4. **Bloco 4** → Se a organização não existir, **criá-la automaticamente**. Resultado: 📊 **A organização estará sempre atualizada e associada aos leads certos!** *** ### 📌 **Conclusão** O componente **Organizações** permite **criar, gerenciar e associar contatos a empresas** dentro do Hablla Studio. Com as automações corretas, você pode **otimizar a segmentação e garantir um fluxo de vendas eficiente**. Se precisar de mais suporte, entre em contato com nossa equipe! 🚀 --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.hablla.com/fluxos-de-automacoes/todos-os-componentes/hablla/organizacoes.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.