# 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.