> 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-no-code.md).

# Integrações No-code

A Integração No-Code é a forma mais rápida de colocar em operação um Fluxo de verificação. IDV Suite gera uma experiência web hospedada e gerenciada integralmente pela plataforma: você configura a aparência, o idioma e o comportamento, e obtém uma URL ou um código incorporável pronto para usar.

Sem desenvolvimento próprio. Sem infraestrutura adicional.

**Quando usar No-Code?** Ideal para pilotos, POCs, campanhas pontuais ou qualquer caso em que você precise de velocidade de implantação e a Personalização de UX não seja um requisito crítico.

***

{% hint style="info" %}

### Pré-requisitos

Antes de criar uma Integração No-Code, certifique-se de ter:

* Acesso ao módulo **Fluxos & Integrações** na plataforma IDV Suite.
* Um **tenant** ativo com as licenças correspondentes.
* Um **Fluxo publicado** no Designer de fluxos (com seu Workflow ID).
  {% endhint %}

***

### Criar uma Integração No-Code

A partir do módulo **Fluxos & Integrações**, clique em **+ Nova Integração**. A plataforma exibirá um modal com dois passos:

#### **Passo 1 — Escolher o tipo de Integração**

Selecione **No-Code** entre as opções disponíveis e clique em **Continuar**.

![Seletor de tipo de Integração — No-Code vs. Low-Code](/files/5f00baaef57ea574ceecf3540b50605c35fd70a4)

#### **Passo 2 — Selecionar o Fluxo**

Escolha o Fluxo publicado ao qual você quer associar a Integração. Você pode buscar por nome ou filtrar por tipo e estado. Somente os fluxos no estado **Publicado** estarão disponíveis.

![Seleção do Fluxo para a Integração No-Code](/files/8fe9b32b330234cff46e698974edf726ca49bde3)

Uma vez confirmado, a Integração será criada com um nome automático do tipo `INT-NOCODE-001` e ficará no estado **Rascunho**. A partir daqui, o processo de configuração tem três passos: **Customise → Connect → Set up**.

***

### Configuração visual (Customise)

A aba **Customise** permite adaptar a aparência do Fluxo à identidade visual do cliente. As alterações são refletidas em tempo real no painel **Preview** da direita.

![Tela Customise — estado inicial e com logo carregado](/files/93ab7f8fd7c750be935347c5f8be242eac3ff1c9)

#### Imagens

| Elemento    | Obrigatório | Descrição                                                                                                        |
| ----------- | ----------- | ---------------------------------------------------------------------------------------------------------------- |
| **Logo**    | ✅ Sim       | Logotipo que aparece no cabeçalho do Fluxo. Formato PNG ou JPG.                                                  |
| **Favicon** | ❌ Não       | Ícone da aba do navegador. Ative o toggle **Usar seu logo como favicon** para reutilizar o logo automaticamente. |

{% hint style="info" %}
Se você ativar **Usar seu logo como favicon**, o espaço do favicon ficará oculto. Ao desativá-lo, voltará a ser exibido com a imagem que estava carregada.
{% endhint %}

#### Tipografia

Selecione a fonte aplicada a todo o Fluxo. Há diferentes tipos:

<div align="left"><img src="/files/7b70182d90a80167becf8e8e942b4828d704341a" alt="Seletor de tipografia expandido" width="375"></div>

#### Cores

| Campo          | Obrigatório | Descrição                         |
| -------------- | ----------- | --------------------------------- |
| **Primário**   | ✅ Sim       | Botões e elementos principais.    |
| **Secundário** | ✅ Sim       | Fundos secundários e links.       |
| **Terciário**  | ✅ Sim       | Etiquetas e elementos de suporte. |
| **Fundo**      | ❌ Não       | Cor de fundo geral do Fluxo.      |

Todas as cores devem ser inseridas em formato hexadecimal (`#RRGGBB`). Você pode remover uma cor usando a **X** ao lado do campo; o Preview refletirá o estado resultante.

![Customise com as cores aplicadas — resultado no Preview](/files/9cebd037be9b182b5ce552492e831596036630be)

{% hint style="warning" %}
Os campos **Primário**, **Secundário** e **Terciário** são obrigatórios. Sem eles, você não poderá avançar para a próxima etapa
{% endhint %}

Depois de configurar a aparência, clique em **Próxima etapa** para continuar.

***

### Configuração de webhook (Connect)

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 **Set up**.

![Tela Connect — webhook desativado (esquerda) e ativado com campos visíveis (direita)](/files/5ad3240d0f06d1471d9f7f5c3b1367a935e3da2e)

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** desta documentação.
{% endhint %}

{% hint style="warning" %}
As integrações No-Code utilizam exclusivamente **fluxos públicos**. Se o seu caso de uso requer o envio de dados sensíveis do backend antes de iniciar o Fluxo, entre em contato com seu interlocutor na Facephi para avaliar a modalidade adequada.
{% endhint %}

Clique em **Próxima etapa** para continuar.

***

### 1.3.4 Configuração da Landing e publicação (Set up)

A etapa **Set up** reúne os parâmetros funcionais do Fluxo e gera a Integração pronta para publicar.

![Tela Set up — configuração da Landing page](/files/0d233c0b64f3e9bb599c53064c5b4ee557fee254)

| Campo                                         | Obrigatório | Descrição                                                                            |
| --------------------------------------------- | ----------- | ------------------------------------------------------------------------------------ |
| **Título**                                    | ✅ Sim       | Título visível no cabeçalho do Fluxo.                                                |
| **URL de saída**                              | ❌ Não       | URL para a qual o usuário será redirecionado ao concluir o Fluxo.                    |
| **Idioma**                                    | ✅ Sim       | Idioma principal do Fluxo (`Inglês`, `Espanhol`, etc.).                              |
| **Restringir acesso por URLs**                | ❌ Não       | Lista de domínios a partir dos quais o Fluxo pode ser iniciado (controle de origem). |
| **API Key**                                   | ✅ Sim       | É gerado automaticamente. Identifica a Integração nas chamadas ao sistema.           |
| **Mostrar Código QR para ver a versão móvel** | ❌ Não       | Mostra um Código QR para iniciar o Fluxo a partir de um dispositivo móvel.           |

{% hint style="warning" %}
A **API Key** é gerada automaticamente ao criar a Integração e não deve ser compartilhada publicamente. Não existe motivo técnico para que o usuário final a conheça.
{% endhint %}

Depois de preencher os campos, clique em **Publicar Integração**. A plataforma exibirá uma confirmação e a Integração passará para o estado **Configurado**, iniciando o processo de solicitação de publicação.

{% hint style="info" %}
Ao clicar em ***Publicar*** não publica a Integração imediatamente. O estado passa para **Configurado** e é gerada uma solicitação de publicação que deve ser aprovada. Até que não esteja no estado **Publicado** o Fluxo não ficará acessível externamente.
{% endhint %}

Depois de publicada, na lista de Integrações você poderá ver e copiar o **Integration ID** associado a esta Integração. Esse identificador é o que vincula seu canal ao Fluxo e aparece no registro das operações geradas.

![Integration ID visível na lista de integrações](/files/1386a1f4405e9a98a9af21036d8ade6d775a591f)

***

### 1.3.5 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 em cada momento.

![Lista de integrações com estados e menu de ações](/files/f6518e34fd6028a808eb1b8c587d60311b9789d6)

| 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         |
| **Aguardando aprovação** | Solicitação de publicação enviada, pendente de revisão. | — (sem ações disponíveis)                            |
| **Publicado**            | Ativa e em operação. Os usuários podem acessar o Fluxo. | Editar Configuração · Cancelar publicação · Executar |

{% hint style="info" %}
A ação **Executar** (disponível apenas em No-Code, depois de publicada) permite pré-visualizar e testar o Fluxo diretamente pela plataforma.
{% endhint %}

***

### Acompanhamento das operações

Cada vez que um usuário conclui ou abandona o Fluxo, IDV Suite registra uma **operação** no módulo de Operações. A partir daí, você pode:

* Ver o estado e o resultado de cada verificação.
* Revisar os dados capturados (documento, biometria, validações).
* Encaminhar para revisão manual, se isso estiver configurado no Fluxo.

***

### Resumo

Com uma Integração No-Code, você tem um fluxo de verificação operacional em minutos:

1. **Crie** a Integração selecionando o tipo No-Code e o Fluxo publicado.
2. **Personalize** — ajuste o logo, as cores e a tipografia.
3. **Conecte** — configure o webhook se precisar de notificações em tempo real.
4. **Configure** — defina o título, o idioma, a URL de saída e publique.
5. **Monitore** as operações pelo módulo de Operações.

Precisa de Integração nativa no seu site ou app? Consulte [Integração Low-Code.](/docs.facephi-pt-br/produtos/idv-suite/flujos-and-integraciones/integraciones-no-code-low-code/integraciones-low-code.md)
