> For the complete documentation index, see [llms.txt](https://docs.facephi.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.facephi.com/docs.facephi-pt-br/produtos/idv-suite/flujos-and-integraciones/integraciones-no-code-low-code/integraciones-low-code.md). # Integrações Low-Code A integração Low-Code permite incorporar um fluxo de verificação diretamente na sua própria aplicação web ou móvel. Ao contrário da integração No-Code, aqui é o cliente quem gerencia a experiência em seu canal, enquanto o IDV Suite orquestra a lógica do fluxo a partir da plataforma. O resultado do processo de configuração é um **Integration ID** que sua equipe técnica usará para inicializar o SDK Web ou Mobile e executar o fluxo. {% hint style="info" %} **Quando usar Low-Code?** Ideal quando você precisa de integração nativa no seu web ou app, maior controle sobre a UX ou conexão com sistemas internos do cliente. Requer um perfil técnico básico para a implementação do SDK. {% endhint %} *** ### Pré-requisitos Antes de criar uma integração Low-Code, certifique-se de ter: * Acesso ao módulo **Fluxos & Integrações** na plataforma IDV Suite. * Um **Fluxo publicado** no Designer de fluxos (com seu Workflow ID). * Uma equipe técnica que fará a implementação do SDK no canal do cliente. *** ### Criar uma integração Low-Code A partir do módulo **Fluxos & Integrações**, clique em **+ Nova integração**. No modal de seleção de tipo, escolha **Low Code** e clique em **Continuar**.

Seletor de tipo de integração — Low-Code vs No-code

Em seguida, selecione o fluxo publicado ao qual você quer associar a integração. Apenas os fluxos em estado **Publicado** estarão disponíveis.

modal de seleção de fluxo

Uma vez confirmado, a Integração será criada com um nome automático do tipo `XXXXXXXX` e ficará no estado **Rascunho**. O processo de configuração tem quatro etapas: **Escolher → Personalizar → Conectar → Configurar**. *** ### Configuração visual (Personalizar) A aba **Personalizar** permite adaptar a aparência do Fluxo à identidade visual do cliente. As alterações são refletidas em tempo real no painel **Preview**, que mostra como a experiência será exibida no dispositivo do usuário final.

Tela de personalização: seleção de cores

Ao contrário da integração No-Code, a Personalização do Low-Code inclui uma paleta de cores mais completa, organizada em três grupos: #### Cores principais | Campo | Obrigatório | Descrição | | -------------- | ----------- | ----------------------------------------------------------- | | **Primário** | ✅ Sim | Cor principal da interface: botões e elementos em destaque. | | **Secundário** | ✅ Sim | Cor secundária para destacar conteúdo ou botões. | | **Fundo** | ✅ Sim | Cor de fundo geral da experiência. | | **Neutro** | ✅ Sim | Cor neutra para elementos de fundo ou texto secundário. | | **Destaque** | ✅ Sim | Cor de destaque para elementos secundários. | #### Cores de estado | Campo | Obrigatório | Descrição | | ----------- | ----------- | ----------------------------------------------- | | **Error** | ✅ Sim | Cor para indicar erros no fluxo. | | **Success** | ✅ Sim | Cor para indicar etapas concluídas com sucesso. | #### Cores de texto | Campo | Obrigatório | Descrição | | ------------------- | ----------- | -------------------------------------- | | **Texto do título** | ✅ Sim | Cor do título da tela ou das seções. | | **Texto do corpo** | ✅ Sim | Cor do texto principal. | | **Texto do botão** | ✅ Sim | Cor do texto dentro dos botões do SDK. | {% hint style="info" %} O painel **Preview** mostra simultaneamente o caso de sucesso e o caso de erro do fluxo, refletindo em tempo real como as cores configuradas ficarão na experiência do usuário final. {% endhint %} {% hint style="warning" %} Todas as cores devem ser inseridas em formato hexadecimal válido (`#RRGGBB`). Valores malformados impedirão salvar a configuração. {% endhint %} Depois de configurar a aparência, clique em **Próxima etapa** para continuar. *** ### Configuração de webhook (Conectar) A etapa **Conectar** permite configurar um webhook para que seu backend receba notificações em tempo real sobre os eventos do Fluxo (início, OCR, validação, resultado final etc.). Esta etapa é **opcional**. Se você não precisa de notificações em tempo real, pode ir diretamente para **Configurar**.

tela Conectar — webhook desativado e ativado com campos visíveis

Ao ativar o toggle **Webhook**, aparecerão os campos de configuração: | Campo | Descrição | | -------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **URL** | Endpoint do seu backend que receberá os eventos. | | **Cabeçalho do webhook** | Cabeçalhos personalizados (chave/valor) para autenticar ou identificar as chamadas. | | **OAuth Authentication** | Ative a autenticação OAuth no webhook. | | **URL de verificação de status** | URL de verificação de status do Endpoint. | | **Eventos** | Selecione quais eventos acionam o webhook: `Início`, `Alteração de etapas`, `OCR`, `Ativos`, `Liveness passiva`, `Matching facial`, `Resultados da operação`. | {% hint style="info" %} A documentação detalhada do payload de cada evento e a morfologia das notificações está disponível na seção [**Webhooks**](/docs.facephi-pt-br/produtos/idv-suite/flujos-and-integraciones/configuracion-tecnica-del-cliente/webhook.md) desta documentação. {% endhint %} Clique em **Próxima etapa** para continuar. *** ### Configuração do aplicativo (Configurar) A etapa **Configurar** é onde a integração Low-Code se diferencia mais claramente da No-Code. Em vez de gerar uma URL pública, aqui são definidos os parâmetros que o SDK da sua aplicação precisa para executar o fluxo corretamente.

tela Configurar — campos Idioma, Plataforma e Bundle ID

| Campo | Obrigatório | Descrição | | -------------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | **Idioma** | ✅ Sim | Idioma principal do Fluxo (`Espanhol`, `Inglês`, etc.). | | **Plataforma** | ✅ Sim | Plataforma do aplicativo do cliente: `Android`, `iOS` ou `Web`. | | **Bundle ID** | ✅ Sim | Identificador único do aplicativo móvel (por exemplo: `com.empresa.app`). Necessário para validar que o SDK que executa o fluxo pertence ao aplicativo autorizado. | Depois de preencher os campos, clique em **Finalizar integração**. A integração passará para o estado **Configurado**. {% hint style="info" %} Uma vez concluída a configuração, o **Integration ID** estará disponível na lista de integrações. Esse identificador é a peça-chave que sua equipe técnica precisa para inicializar o SDK e vincular o app ao fluxo definido na plataforma. {% endhint %} *** ### Estados e ações disponíveis Na lista de **Integrações** você pode ver o estado de cada integração e as ações disponíveis.

lista de integrações com badge Low Code e coluna Integration ID visível

| Estado | Descrição | Ações disponíveis | | --------------- | --------------------------------------------------------- | -------------------------------------------- | | **Rascunho** | Em configuração. Não acessível externamente. | Editar fluxo · Editar configuração · Excluir | | **Configurado** | Configuração concluída, pendente de publicação. | Editar fluxo · Editar configuração · Excluir | | **Em revisão** | Solicitação de publicação enviada, pendente de aprovação. | — (sem ações disponíveis) | | **Publicado** | Ativo e operacional. O SDK pode executar o fluxo. | Editar configuração · Despublicar | {% hint style="info" %} Ao contrário da integração No-Code, a integração Low-Code não dispõe da ação **Executar** uma vez publicada, pois a execução do fluxo ocorre no aplicativo do cliente por meio do SDK. {% endhint %} *** ### Próximo passo: implementação no canal Uma vez publicada a integração, sua equipe técnica pode começar a implementação do SDK usando o **Integration ID** obtido. * Se você for integrar em uma **aplicação web**, consulte [SDK Web (Loader)](/docs.facephi-pt-br/produtos/idv-suite/flujos-and-integraciones/configuracion-tecnica-del-cliente/solucion-web/sdk-loader-idv.md). * Se você for integrar em uma **aplicativo móvel**, consulte [SDK Mobile](/docs.facephi-pt-br/produtos/idv-suite/flujos-and-integraciones/configuracion-tecnica-del-cliente/sdk-mobile.md). *** ### Resumo Com uma integração Low-Code, você conecta seu aplicativo a um fluxo de verificação gerenciado a partir do IDV Suite: 1. **Crie** a integração selecionando o tipo Low-Code e o fluxo publicado. 2. **Personalize** — ajuste as cores principais, de estado e de texto. 3. **Conecte** — configure o webhook se precisar de notificações em tempo real. 4. **Configure** — defina idioma, plataforma e Bundle ID, e finalize a integração. 5. **Implemente** o SDK no seu canal usando o Integration ID e a licença (api-key) que a equipe de suporte lhe entregará. 6. **Monitore** as operações pelo módulo de Operações.