Installations

Installations (Instalações) representam a configuração ativa de um cliente na plataforma Integrações Inteligentes. É através de uma instalação que nosso sistema sabe quem é o cliente, qual provedor ele está conectando e quais regras devem ser aplicadas.

O que é uma Instalação?

Uma instalação é o vínculo oficial entre a conta de um cliente e um Driver específico. Ela armazena:

• Credenciais de Acesso: Tokens e chaves necessárias para autenticar no provedor externo.
• Configurações de Driver: Parâmetros específicos exigidos pelo Driver (ex: ID da loja, região, webhooks secrets).
• Estado da Conexão: Status atual (Ativo, Pausado, Erro de Autenticação).

Uma instalação é criada “on behalf of a customer” (em nome de um cliente), garantindo que os dados fluam de forma segura e isolada.

Ciclo de Vida

1. Provisionamento: O cliente autoriza a conexão (via OAuth ou chave de API).
2. Validação: O sistema testa as credenciais com o Driver.
3. Ativação: Se válido, a instalação torna-se ativa e começa a processar dados.