Skip to main content
POST
Criar flow

Conceituação

Cria um flow no WABA. O flow_json é a definição das telas, enviada como string — não como objeto. Com publish: true o flow já nasce publicado. Sem isso, ele fica em DRAFT, que é o único status em que você ainda pode alterar o flow_json.
Se alguma tela usar a ação data_exchange, o campo endpoint_uri é obrigatório.
A estrutura do flow_json e a lista de componentes estão na Introdução.

Autorizações

Authorization
string
header
obrigatório

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Parâmetros de caminho

wabaId
string
obrigatório

ID do WABA (obtido via Listar WABAs)

Exemplo:

"428083093730937"

Corpo

application/json
name
string
obrigatório

Nome do flow

Exemplo:

"agendamento_consulta"

categories
enum<string>[]
obrigatório

Categorias do flow (a Meta usa na revisão)

Opções disponíveis:
SIGN_UP,
SIGN_IN,
APPOINTMENT_BOOKING,
LEAD_GENERATION,
CONTACT_US,
CUSTOMER_SUPPORT,
SURVEY,
OTHER
Exemplo:
flow_json
string
obrigatório

Definição das telas em JSON, enviada como string

endpoint_uri
string

URL do seu endpoint, obrigatória apenas para flows com data_exchange

Exemplo:

"https://app.suaempresa.com/flows/callback"

publish
boolean
padrão:false

Quando true, publica o flow já na criação

Resposta

Flow criado

id
string

ID do flow

name
string

Nome do flow

categories
enum<string>[]

Categorias do flow (a Meta usa na revisão)

Opções disponíveis:
SIGN_UP,
SIGN_IN,
APPOINTMENT_BOOKING,
LEAD_GENERATION,
CONTACT_US,
CUSTOMER_SUPPORT,
SURVEY,
OTHER
status
enum<string>

Status de publicação

Opções disponíveis:
DRAFT,
PUBLISHED,
DEPRECATED,
BLOCKED,
THROTTLED
endpoint_uri
string | null

URL do seu endpoint, obrigatória apenas para flows com data_exchange

flow_json
string

Definição das telas em JSON, enviada como string

validation_errors
object[]

Pendências de validação devolvidas pela Meta