Depreciar Flow
Aposenta um Flow na Meta sem apagá-lo, e sem apagar as respostas já enviadas. Não é o mesmo que DELETE /v1/flows/{id}: apagar só funciona em DRAFT e remove a linha; depreciar age sobre um Flow que chegou à Meta e apenas o marca.
supersededByFlowId fecha o par com clonedFromFlowId: o clone aponta para trás, a depreciação para frente. Como publicar é irreversível, esse ponteiro é a única coisa que liga as versões de um mesmo formulário ao longo do tempo.
supersededBy é ecoado na resposta sempre, null incluído — é a única forma de distinguir “o sucessor que mandei foi gravado” de “o campo se perdeu entre o meu cliente e a linha”. Corpo truncado dá 400, e não corpo vazio, porque corpo vazio é um pedido legítimo aqui. Permissão flows:manage.
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_
Parâmetros de caminho
O id local do Flow — o campo id que GET /v1/flows devolve, nunca o metaFlowId.
Corpo
O id LOCAL do Flow sucessor — o mesmo id que GET /v1/flows devolve, não o metaFlowId. Opcional: depreciar sem sucessor é legítimo. Mas presente-e-inutilizável é um pedido diferente de ausente — string vazia ou só de espaços é recusada com 400 FLOW_DEPRECATE_INVALID_SUCCESSOR em vez de descartada, porque cadeia de versões que termina em silêncio é invisível depois. O sucessor é verificado como sendo do seu tenant; um que não seja dá 404.
1"cmf2b3c4d5e6f7g8h9i0j1k2"
Resposta
Flow depreciado