Skip to main content
A project is the top-level container for everything in Paige. When you create a project, Paige provisions a dedicated environment for your bot: a WhatsApp Business phone number connected via Meta, a Node.js/Express codebase that handles incoming messages, an isolated Postgres database, and a separate space for your WhatsApp Flows. Nothing is shared between projects — each one is fully independent.

​
What a project contains

WhatsApp number

Each project is linked to a single WhatsApp Business phone number connected through Meta’s embedded signup. Messages sent to that number are routed to your bot code.

Bot code

A Node.js/Express codebase that runs on Paige’s infrastructure. You write and edit it through Paige’s AI-powered chat interface or directly in the editor.

Database

A dedicated Postgres database provisioned exclusively for this project. Your bot code can read and write it, and you can manage it from the dashboard.

Flows

WhatsApp Flows are multi-screen interactive forms that run inside the WhatsApp chat. They are created and managed per project and synced to Meta via your connected phone number.

Conversations

Every WhatsApp conversation your bot has is stored here, indexed by contact phone number. You can view message history and conversation state from the dashboard.

Message templates

Utility, marketing, and authentication templates tied to this project’s WhatsApp number. Templates require Meta approval before they can be sent.

​
Project isolation

Projects are fully isolated from each other. The bot code, database tables, flows, and conversation records of one project are never accessible to another. This means you can run separate bots — for example, a customer support bot and a marketing bot — without any cross-contamination of data or logic.

​
Project lifecycle

​
Creating a project

When you create a project, Paige provisions the infrastructure in the background. You can track provisioning status from your project list. Once provisioning completes, you can connect a WhatsApp number via Meta’s embedded signup and start building.

​
Updating a project

You can update a project’s name and settings at any time from the project settings page. WhatsApp Business profile details — including your display name and profile photo — are managed in Settings → WhatsApp, and only become available once you’ve connected a WhatsApp number to the project.
Display name changes require Meta approval and may take time to reflect on the WhatsApp number.

​
Resetting a project

Resetting a project clears your bot code back to its initial state while preserving your project settings and WhatsApp connection. Use this if you want to start your codebase from scratch without creating a new project.
Resetting a project permanently deletes your current bot code. This cannot be undone. Your database, flows, and conversation history are not affected by a reset.

​
Suspending and restoring a project

Project suspension is driven by billing — there is no manual “suspend” button. A suspended project is taken offline (the runtime stops responding to WhatsApp messages) but its data, bot code, database, flows, and conversation history are preserved. A project becomes suspended in two situations:
  • End of the free trial. Every new project includes a 14-day free trial. If the project is not on a paid plan when the trial ends, it is automatically suspended.
  • Paused or cancelled billing. If you pause or cancel billing on an active project, it continues to run until the end of the current paid 30-day cycle, then is suspended.
To restore a suspended project, resume billing from the project’s billing page. The bot returns to its previous state with no data loss.
Pause billing on a project if you need a temporary break — for example, during a seasonal pause or while a project is being rebuilt. The project keeps running until the end of the cycle you’ve already paid for, then suspends cleanly.
See Billing for the full billing model and how to manage your plan.

​
Transferring a project

Projects can be transferred to a workspace, allowing teams to collaborate on the same bot. Transferring moves ownership from your personal account to the selected workspace.

​
Deleting a project

Deleting a project permanently removes all associated data — bot code, database, flows, and conversation history. This action cannot be reversed.
Deleting a project also removes the associated WhatsApp phone number from Paige. Make sure you no longer need the number or its data before proceeding.