> 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 uso.

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 mostrará um modal com duas etapas:

#### **Etapa 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)

#### **Etapa 2 — Selecionar o Fluxo**

Escolha o Fluxo publicado ao qual deseja associar a Integração. Você pode pesquisar 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 **Draft**. A partir daqui, o processo de configuração tem três etapas: **Personalizar → Conectar → Configurar**.

***

### 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** à 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 **Use seu logotipo como favicon** para reutilizar o logo automaticamente. |

{% hint style="info" %}
Se você ativar **Use seu logotipo como favicon**, o espaço do favicon ficará oculto. Ao desativá-lo, ele 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                       |
| -------------- | ----------- | ------------------------------- |
| **Principal**  | ✅ Sim       | Botões e elementos principais.  |
| **Secundária** | ✅ Sim       | Fundos secundários e links.     |
| **Terciária**  | ✅ Sim       | Etiquetas e elementos de apoio. |
| **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 **Principal**, **Secundária** e **Terciária** 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 precisar de notificações em tempo real, pode ir diretamente para **Configurar**.

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

Ao ativar o toggle **Webhook**, os campos de configuração aparecerã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** | Ativa autenticação OAuth no webhook.                                                                                                                        |
| **Health URL**           | URL de verificação de estado do Endpoint.                                                                                                                   |
| **Eventos**              | Selecione quais eventos acionam o webhook: `Início`, `Mudança de Etapas`, `OCR`, `Assets`, `Liveness passivo`, `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 exigir 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óximo passo** para continuar.

***

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

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

![Tela Configurar — 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.                    |
| **Language**                                  | ✅ Sim       | Idioma principal do Fluxo (`English`, `Spanish`, 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       | É gerada 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 há 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 mostrará uma confirmação e a Integração passará para o estado **Configurado**, iniciando o processo de solicitação de publicação.

{% hint style="info" %}
Clicar em ***Publicar*** não publica a Integração imediatamente. O estado passa a **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 será acessível externamente.
{% endhint %}

Uma vez publicada, na lista de Integrações você poderá ver e copiar o **Integration ID** associado a esta Integração. Este 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

A partir da 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                            |
| ------------------------ | ------------------------------------------------------- | -------------------------------------------- |
| **Draft**                | 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 operante. Os usuários podem acessar o Fluxo.    | Editar configuração · Despublicar · 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 %}

***

### Monitoramento de operações

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

* Ver o estado e o resultado de cada verificação.
* Revisar os dados capturados (documento, biometria, validações).
* Escalar para revisão manual se estiver configurada 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 logo, cores e tipografia.
3. **Conecte** — configure o webhook se precisar de notificações em tempo real.
4. **Configure** — defina título, idioma, URL de saída e publique.
5. **Monitore** as operações no 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)
