Customers

12 min

Objetivo

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.

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:

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

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

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.

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.