Customers

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