WhatsApp Flow drafts - Polymorfa

A Flow draft stores a WhatsApp Flow definition in your project. Drafts are not published to Meta. Use a project client: platform.project("<project-id>").flows, or a client created with a project credential.

Task	Permission
List and read drafts	`sessions:read`
Create, update, and delete drafts	`sessions:manage`

List and read drafts

const drafts = await project.flows.list();
for (const draft of drafts.data) console.log(draft.id, draft.name, draft.status);

const draft = await project.flows.retrieve("<flow-id>");
if (draft.data === null) {
  console.log("No draft with that ID");
} else {
  console.log(draft.data.definition);
}

Flow methods return the draft itself in response.data. list returns FlowSummary items. retrieve returns a FlowDraft, which adds the definition, or null when the draft does not exist.

Create a draft

const created = await project.flows.create({
  name: "Booking",
  definition: { version: "7.0", screens: [] },
});
console.log(created.data.id, created.data.updatedAt);

Update a draft

Pass the updatedAt value you last read. The update fails if someone changed the draft since then:

const current = await project.flows.retrieve("<flow-id>");

if (current.data) {
  await project.flows.update("<flow-id>", {
    expectedUpdatedAt: current.data.updatedAt,
    name: "Booking v2",
  });
}

Delete a draft

await project.flows.delete("<flow-id>");

See Flows for building Flows in the Console. To send a published Flow in a message, use flow content with messages.send.