# Subflow Call

{% hint style="info" %}
O conector Subflow Call faz parte de um conjunto de conectores para chamada de subfluxos e retorno de dados para o fluxo principal. Acesse a documentação dos conectores [Subflow Input](/guia/conectores/categorias/filas-e-eventos/subflow-input.md) e [Subflow Output](/guia/conectores/categorias/filas-e-eventos/subflow-output.md) para saber mais sobre como utilizá-los em seu ambiente.
{% endhint %}

{% tabs %}
{% tab title="Parâmetros" %}

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXe3ufyseSIKMu3D2a9ZMOycMW6U33OG1_LG6TsLV3-Wu0Yh9w9LPekNht-JQTa12Om6b5pnIs4NvHUxw4ZOPu7faQBtTuxx5-t4tkNbFZO6cIkm-GkHYO0Pgl-H7wcHZBN1pfqIqA?key=yLogrgEbXy0K_a4zmB9ApgKO" alt=""><figcaption><p>Parâmetros de configuração</p></figcaption></figure>

| Campo                     | Tipo           | Descrição                                                                                                                                                                      |
| ------------------------- | -------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Descrição                 | Campo de texto | Descrição visual do conector na construção do fluxo.                                                                                                                           |
| Identificador do subfluxo | Campo de texto | Define um identificador de um subfluxo a ser acionado. O identificador inserido nesta configuração deverá também ser inserido no conector Subflow Input dentro do mesmo fluxo. |
| {% endtab %}              |                |                                                                                                                                                                                |

{% tab title="Payload" %}

## Sucesso

O conector Subflow Call, ao identificar um subfluxo através do identificador parametrizado, irá dar início a execução do subfluxo.&#x20;

No exemplo abaixo, um fluxo percorre uma lista de usuários e chama um subfluxo responsável por verificar se cada usuário está cadastrado em um banco de dados interno. Se o usuário já existir, seus dados serão atualizados; caso contrário, um novo registro será criado. Após isso será retornado para o fluxo principal, onde os demais conectores serão executados.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXdGgc7GMX8tf3gz2G1G2ryHiH4CqVg_j_JM5ZX5BUQOrBHTgEHfr5v8gLrP3poAJofbWH5AKlyBegfTby0pbJuyZv5cgj1Yi7djHJ5V8VB6FawiQofeEGA5cv3fWjbchLbrAw0zeg?key=yLogrgEbXy0K_a4zmB9ApgKO" alt=""><figcaption><p>Exemplo de subfluxo</p></figcaption></figure>

Quando o conector é executado, ele cria uma estrutura específica dentro do objeto msg, que é o principal repositório de dados da execução. Dentro dessa estrutura, o campo identifier representa o identificador definido na configuração do conector, permitindo distinguir diferentes execuções. Já o objeto message contém as informações que serão enviadas para o subfluxo chamado, garantindo que os dados necessários sejam transmitidos corretamente para o processamento subsequente.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXcI5esmUhd3juGHUlTOSqsyu-gjaI6azQJ7uzLeZPK0-3DTXETiuKeXB_LCi5C8xbGNiDAkVkYqvVTQm12ZzgO1Ahn6FvPwK3XILVcVIZJgVyhDqMnQ3YT7LX_BVyoDL0RtPDfg?key=yLogrgEbXy0K_a4zmB9ApgKO" alt=""><figcaption><p>Transmissão de dados para subfluxo</p></figcaption></figure>

## Erro

Caso o subfluxo não seja encontrado, ou esteja parametrizado de forma incorreta, a execução irá retornar uma mensagem de erro da seguinte forma.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXebqBiNGeMHA_4ALvjCig3r-U08vv5qHZTks-_lkHMU-ctCHrM2sTWxodfN86K4_bjameoZblmlcXXoPcNU1dydh_tI5JaU_N_TbWZmNeOGI3u1xpV1FyR1U41rPoVVvq8uoXZH5w?key=yLogrgEbXy0K_a4zmB9ApgKO" alt=""><figcaption><p>Erro ao iniciar subfluxo</p></figcaption></figure>
{% endtab %}
{% endtabs %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.floui.io/guia/conectores/categorias/filas-e-eventos/subflow-call.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.