Pular para o conteúdo principal
POST
Criar flow como rascunho

Autorizações

Authorization
string
header
obrigatório

API key criada nas configurações da organização.

Cabeçalhos

Idempotency-Key
string

Chave única da operação. Repetir a mesma chave com o mesmo corpo devolve a resposta original em vez de executar de novo.

Corpo

application/json
name
string
obrigatório
Required string length: 1 - 256
trigger
object
obrigatório

Gatilho do flow, como listado no catálogo.

start
string
obrigatório

Chave do bloco: letras minúsculas, números e sublinhados, começando por letra.

Pattern: ^[a-z][a-z0-9_]{0,63}$
Exemplo:

"wait_1_day"

nodes
object[]
obrigatório
Required array length: 1 - 50 elements

Divide o caminho conforme um campo dos dados do gatilho.

description
string
Maximum string length: 2000
validate_only
boolean
padrão:false

Se true, apenas valida o flow e devolve o resumo, sem salvar nada.

Resposta

Flow validado ou salvo como rascunho.

object
string
obrigatório
Allowed value: "flow_draft"
validate_only
boolean
obrigatório

true quando o flow foi apenas validado; nada foi salvo.

status
string
obrigatório
Allowed value: "draft"
trigger
object
obrigatório
outline
string[]
obrigatório

Passos do flow em linguagem simples.

warnings
object[]
obrigatório

Avisos que não impedem o rascunho, como um template de WhatsApp ainda em análise pela Meta.

next_step
string
obrigatório
id
string
Pattern: ^flw_[A-Za-z0-9_-]+$
revision
string

Revisão do rascunho salvo. Informe-a ao ativar o flow depois da revisão.

html_url
string<uri>

Link do flow no editor da Bevits, para revisão.