Pular para o conteúdo principal
POST
/
v1
/
sessions
/
flows
/
{flowId}
/
create
curl -X POST https://api.whatabot.app/api/v1/sessions/flows/{flowId}/create \
  -H "X-Api-Key: wh_your_api_key"

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"}}'

{
  "sessionId": "550e8400-e29b-41d4-a716-446655440000",
  "status": "active",
  "expiresAt": "2025-01-15T10:30:00.000Z"
}
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.
​
X-Api-Key
string
obrigatório
Sua chave de API (prefixada com wh_).
​
flowId
string
obrigatório
O UUID do fluxo a ser iniciado.

​
Body

​
variables
object
Valores iniciais para variáveis do fluxo. As chaves devem corresponder aos nomes das variáveis criadas no editor.
curl -X POST https://api.whatabot.app/api/v1/sessions/flows/{flowId}/create \
  -H "X-Api-Key: wh_your_api_key"

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"}}'

{
  "sessionId": "550e8400-e29b-41d4-a716-446655440000",
  "status": "active",
  "expiresAt": "2025-01-15T10:30:00.000Z"
}
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.