Skip to content
Pywa Cloud is not live yet - there is no running control plane or dashboard to sign up on, and the CLI package is not published. Everything on this site describes a real, working, tested system, not a roadmap - but none of it is something you can actually run against Pywa Cloud today, and commands/flags/behavior can still change before it is.

Hosting a WhatsApp Bot

A WhatsApp Cloud API bot is a web server that Meta calls. That sets what any host has to provide.

  1. A public HTTPS URL that Meta can reach. localhost and plain HTTP do not work, so a bot on your laptop needs a tunnel (see Local Development) or a deployed server.
  2. Webhook verification. When you register the URL, Meta sends a GET with a verify token and expects the challenge echoed back. pywa answers this for you once the URL reaches your bot; the usual cause of “verification failed” is that the URL does not reach the bot, or the token differs.
  3. Signature checking. Meta signs every webhook POST with your app secret. pywa verifies it; do not disable it.
  4. An always-on process. Messages arrive when users send them. Hosts that sleep or scale to zero can miss or delay webhooks and lose the conversation state held in memory.
  5. Secrets. The access token, phone number ID and app secret belong in environment variables, not in code.

Any host that gives you an always-on process and a public HTTPS URL can run a pywa bot: a VPS behind a reverse proxy, or a general platform such as Render, Railway or Fly.io. You then configure the webhook URL and verify token in the Meta app yourself and manage restarts, logs and TLS.

Pywa Cloud is built for this one job. pywa deploy uploads the project, builds it and runs it in its own container with a stable public webhook URL; the Meta verification handshake and phone number connection are handled for you (pywa cloud connect), and pywa cloud logs, status, restart and rollback are built in. Each bot runs isolated from other customers’ bots.

Terminal window
pip install pywa-cloud-cli
pywa login
pywa deploy
pywa cloud connect

Full walkthrough: Quick Start. Using a coding agent: Deploying with an AI Agent. Webhook problems: Troubleshooting.