Criar ou clonar Flow
Cria um Flow em DRAFT, ou clona um existente. Responde 201 com {id, metaFlowId} — só esses dois campos, não o Flow inteiro. Aceita exatamente name, categories e cloneFromFlowId: qualquer outra chave é RECUSADA com 400 FLOW_UNKNOWN_FIELDS, nunca ignorada, para que {"status":"PUBLISHED"} não responda 201 e deixe você concluir que publicou. O número e a WABA vêm da chave — mandar whatsappNumberId, wabaId ou metaWabaId dá 400 FLOW_NUMBER_FROM_KEY. Permissão flows:manage (ADMIN e acima).
Exige chave com escopo de número. Uma chave de tenant precisa nomear o número no header x-whatsapp-number-id, senão recebe 403 TENANT_SCOPE_NOT_ALLOWED.
Autorizações
Sua chave de API ps_
Corpo
Nome do Flow. Não vazio; espaços das pontas são removidos.
1"Agendamento v2"
Uma ou mais do conjunto fechado da Meta. Valor fora dele dá 400 FLOW_CATEGORY_INVALID.
1SIGN_UP, SIGN_IN, APPOINTMENT_BOOKING, LEAD_GENERATION, CONTACT_US, CUSTOMER_SUPPORT, SURVEY, OTHER O id LOCAL do Flow de origem — o campo id que GET /v1/flows devolve, nunca o metaFlowId. Confundir os dois é o engano natural e não conseguimos detectá-lo por você: ambos são strings opacas, e a Meta responde com o erro dela. O metaFlowId também é anulável (um rascunho nunca enviado), então um id da Meta não teria o que resolver. Omita para criar do zero; null é recusado.
"cmf1a2b3c4d5e6f7g8h9i0j1"
Resposta
Flow criado em DRAFT