> 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/pessoas/adicionar-organizacoes.md).

# Adicionar Organizações

A operação Adicionar Organização permite vincular um registro de pessoa a um ou mais registros de organização (empresa). Esta associação é a base para o gerenciamento de contas em um ambiente B2B.

Ao conectar uma pessoa a uma organização, você estabelece a relação de que aquele indivíduo trabalha ou está associado àquela empresa. Isso permite agrupar múltiplos contatos sob a mesma conta, visualizar um histórico de interações a nível de empresa e criar automações baseadas na organização do contato.

Esta ação adiciona o vínculo com a organização, mantendo as associações que já existiam.

#### Como Configurar

1. No Hablla Studio, adicione o bloco "Pessoas" ao seu fluxo de automação.
2. No campo "Operação", selecione a opção "Adicionar Organização".
3. No campo "ID da Pessoa" (`personId`), insira o identificador do contato ao qual a organização será associada.
4. No campo "Organização", selecione a organização desejada na lista.

### Parâmetros

| Campo        | Tipo                  | Obrigatório? | Descrição                                                        |
| ------------ | --------------------- | ------------ | ---------------------------------------------------------------- |
| ID da Pessoa | Texto                 | ✅ Sim        | O ID único da pessoa (contato) que será vinculada à organização. |
| Organização  | Lista de Organizações | ✅ Sim        | A organização a ser associada a esta pessoa.                     |

### Estrutura (Usando JSON)

O corpo da requisição JSON deve conter um array chamado `organizations` com o(s) ID(s) da(s) organização(ões) a ser(em) adicionada(s).

JSON

```
{
  "organizations": [
    "organization_id_abc123"
  ]
}
```

***

### 🚀 Exemplo de Caso de Uso

Objetivo: Quando um novo lead se cadastra com um e-mail corporativo (ex: `contato@empresa.com`), verificar se a organização "Empresa" já existe na base e, em caso afirmativo, associar o novo lead a ela.

1. Crie um fluxo que começa com o gatilho de "Nova Pessoa Criada".
2. Adicione um passo para extrair o domínio do e-mail da pessoa (ex: `empresa.com`).
3. Use a operação "Obter Todas as Organizações" com um filtro para buscar uma organização cujo "Domínio do Site" seja igual ao extraído no passo anterior.
4. Adicione uma Condição (If) para verificar se uma organização foi encontrada (`{{steps.3.result.data.length}} > 0`).
5. Se a condição for verdadeira, adicione o bloco "Pessoas" com a operação "Adicionar Organização".
   * ID da Pessoa: Use o ID da pessoa vindo do gatilho (`{{trigger.person.id}}`).
   * Organização: Selecione o ID da organização encontrado na busca (`{{steps.3.result.data[0].id}}`).

Com esta automação, seus contatos são automaticamente organizados em contas, economizando tempo manual de associação e garantindo que sua estrutura B2B esteja sempre correta.


---

# 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/pessoas/adicionar-organizacoes.md?ask=<question>
```

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.