---
title: Customers
slug: customers
docTags: 
createdAt: 2026-04-24T13:28:28.023Z
---

## Objetivo

:::hint{type="info"}
Customers permitem que sua aplicação represente os clientes finais que acessam a Fluid via SDK ou Embedded, mantendo isolamento e rastreabilidade dentro de um workspace.
:::

Customers são a representação dos clientes do seu cliente dentro da Fluid. Enquanto Workspaces segmentam organizações e Membros representam usuários internos, Customers identificam as empresas ou usuários finais do produto construído sobre a plataforma — o terceiro nível do modelo multi-tenant da Fluid.

A tela de Customers fica em **Gestão → Customers** e exibe todos os registros já provisionados no workspace, com informações de identificação, data de criação e data do último acesso.

:::hint{type="info"}
Use Customers para representar os clientes finais do seu produto dentro da Fluid. Em integrações Embedded ou SDK, seu backend informa qual usuário está acessando e a qual Customer ele pertence. A Fluid provisiona essa relação automaticamente e exibe no Console quem já ativou a integração, quando acessou pela primeira vez e quando acessou pela última vez.
:::

***

## O que é um Customer?

Um Customer é criado automaticamente na Fluid na primeira vez que um Bootstrap Token é emitido para um `external_id` novo por meio de uma [Credencial](#). Ele representa o CNPJ, organização ou conta do usuário final que acessa o produto integrado via SDK ou Embedded.

Para entender onde Customers se encaixam na hierarquia da plataforma:

```javascript
Fluid (plataforma)
└── Organização (seu tenant)
    └── Workspace (espaços de trabalho)
        ├── Membros (usuários internos — org_admin, member)
        └── Customers (clientes do seu cliente — CNPJ)
            └── Usuários com escopo Customer
```

:::hint{type="info"}
**Customers não substituem Membros**. Membros são usuários internos da sua organização que operam a Fluid diretamente. Customers são entidades externas, os CNPJs ou contas que seu produto atende e seus usuários acessam a plataforma de forma mediada, via token.
:::

***

## Como Customers são criados

O provisionamento é automático e ocorre no momento em que o back-end do seu sistema emite um Bootstrap Token via Credencial M2M informando um `customer_external_id` ainda não registrado na Fluid e, opcionalmente, `customer_external_name`.

A partir desse momento, o Customer passa a aparecer na listagem com:

- `customer_external_id` — identificador único fornecido pelo seu sistema (ex.: CNPJ, UUID, ID interno)
- `customer_external_name` — nome legível para exibição no painel
- **Data de criação** — momento do primeiro provisionamento
- **Último acesso** — data e hora do token mais recente emitido para aquele Customer

Emissões subsequentes de token para o mesmo `customer_external_id` atualizam o campo de último acesso, mas não criam um novo Customer.

***

## Visualizando Customers no console

Acesse **Gestão → Customers** no menu lateral. A listagem exibe todos os Customers provisionados no workspace com as colunas:

| Coluna            | Descrição                                                    |
| ----------------- | ------------------------------------------------------------ |
| **Nome**          | `external_name` fornecido no momento do provisionamento      |
| **ID externo**    | `external_id` do Customer no seu sistema                     |
| **Criado em**     | Data do primeiro provisionamento                             |
| **Último acesso** | Data e hora do token mais recente emitido para este Customer |

:::hint{type="info"}
Use o campo de busca no topo da listagem para localizar Customers pelo nome ou ID externo.
:::

***

## Relação com Credenciais

Cada Customer é sempre originado por uma Credencial. A Credencial fornece a identidade M2M do sistema integrador; o `external_id` dentro do Bootstrap Token identifica o Customer específico.

Isso significa que:

- Diferentes Credenciais podem provisionar Customers no mesmo workspace.
- O mesmo `external_id` emitido por Credenciais distintas resulta no mesmo Customer — a Fluid resolve a identidade pelo `external_id`, não pela Credencial de origem.
- Revogar uma Credencial não remove os Customers já criados por ela, apenas impede novos provisionamentos por aquela Credencial.

:::hint{type="info"}
Ou seja:

`external_id` identifica o usuário final;

`customer_external_id` identifica a organização/customer.
:::

Consulte a página [Credenciais](#) para entender como configurar e gerenciar o acesso M2M.

***

## Casos de uso

**Produto SaaS com integração embedded**
Um parceiro OEM constrói um produto de integração sobre a Fluid. Cada empresa cliente do parceiro é representada como um Customer. O painel de Customers permite ao parceiro acompanhar quais clientes já ativaram a integração, quando fizeram o primeiro acesso e quando acessaram pela última vez.

**Plataforma com múltiplos clientes por workspace**
Em vez de criar um Workspace por cliente, um operador opta por manter todos os clientes no mesmo Workspace e os representa como Customers. Essa abordagem é adequada quando os clientes compartilham a mesma configuração de integração e não precisam de isolamento de fluxos.

**Modelo de três níveis**
Um cliente da Fluid (ex.: empresa de logística) tem seus próprios clientes (embarcadores). O workspace da empresa de logística representa a organização; cada embarcador é um Customer dentro desse workspace. Usuários do embarcador acessam apenas os fluxos e dados do seu próprio Customer.

***

## Boas práticas

- **Use **`customer_external_id`** imutáveis.** Prefira IDs internos estáveis do seu sistema (UUID, ID de banco de dados) em vez de campos que possam mudar, como razão social ou e-mail. O `customer_external_id` é o vínculo permanente entre a Fluid e o seu sistema.
- **Use **`customer_external_name`** legível.** O nome é exibido no painel e facilita a identificação rápida. Prefira o nome fantasia ou razão social resumida da empresa.
- **Monitore o campo "Último acesso".** Customers sem acesso recente podem indicar integrações inativas, churns potenciais ou problemas na emissão de tokens pelo seu back-end.
- **Não crie Customers manualmente.** O provisionamento é feito exclusivamente via token. Tentativas de criar Customers por outros meios não são suportadas nesta versão.

***

## Perguntas frequentes

**O que acontece se eu emitir um token para o mesmo **`customer_external_id`** mais de uma vez?**
O Customer já existente é reutilizado e o campo "Último acesso" é atualizado. Não há criação de duplicatas.

**Posso editar o **`customer_external_name`** de um Customer pelo console?**
Não nesta versão. O `customer_external_name` é definido no momento do provisionamento e atualizado a cada novo token emitido para aquele `external_id`. Para alterar o nome exibido, atualize o campo na próxima emissão de Bootstrap Token.