> ## Documentation Index
> Fetch the complete documentation index at: https://docs.whatabot.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Criar Sessão

> Crie uma nova sessão de conversa para um fluxo.

Crie uma nova sessão de conversa para o fluxo especificado. O motor de fluxos começa o processamento a partir do **nó Início** e entrega a resposta inicial para a URL de callback configurada na chave de API.

<ParamField header="X-Api-Key" type="string" required>
  Sua chave de API (prefixada com `wh_`).
</ParamField>

<ParamField path="flowId" type="string" required>
  O UUID do fluxo a ser iniciado.
</ParamField>

### Body

<ParamField body="variables" type="object">
  Valores iniciais para variáveis do fluxo. As chaves devem corresponder aos nomes das variáveis criadas no editor.

  <Expandable title="Exemplo">
    <ParamField body="variables.{nome}" type="any">
      Cada chave é o nome da variável e o valor pode ser string, número, booleano ou objeto.
    </ParamField>
  </Expandable>
</ParamField>

<RequestExample>
  ```bash Sem variáveis theme={null}
  curl -X POST https://api.whatabot.app/api/v1/sessions/flows/{flowId}/create \
    -H "X-Api-Key: wh_your_api_key"
  ```

  ```bash Com variáveis theme={null}
  curl -X POST https://api.whatabot.app/api/v1/sessions/flows/{flowId}/create \
    -H "X-Api-Key: wh_your_api_key" \
    -H "Content-Type: application/json" \
    -d '{"variables": {"userName": "Claudio", "plan": "premium"}}'
  ```
</RequestExample>

<ResponseExample>
  ```json 201 theme={null}
  {
    "sessionId": "550e8400-e29b-41d4-a716-446655440000",
    "status": "active",
    "expiresAt": "2025-01-15T10:30:00.000Z"
  }
  ```
</ResponseExample>

<Warning>
  A resposta do fluxo não é retornada no corpo da resposta HTTP. Ela é entregue de forma assíncrona para a `callbackUrl` configurada na sua chave de API via [Webhook](/api-reference/webhooks).
</Warning>