Skip to main content

Documentation Index

Fetch the complete documentation index at: https://howto.paigeme.dev/llms.txt

Use this file to discover all available pages before exploring further.

Paige Dev lets you connect your personal WhatsApp number directly to a project so you can test your bot exactly as your users will experience it — no staging environment needed. When your phone is linked, any message you send to your bot’s number is processed live by your bot code, giving you immediate feedback on how it behaves.
1

Open your project

From the Paige dashboard, select the project you want to test.
2

Go to Paige Dev

In the project sidebar, click Paige Dev. You’ll see your current link status.
3

Link your number

Click Link my number and follow the prompt to associate your WhatsApp phone number with this project. Once linked, your number is active for this project only.
Each phone number can only be linked to one project at a time. If you want to test a different project, unlink from the current one first.

​
Send test messages

Once your number is linked, open WhatsApp on your phone and send a message to your bot’s number. The message flows through your bot code in real time — you’ll see a response just as any user would.

Test the happy path

Walk through the primary use case your bot is designed for to confirm the core flow works end to end.

Test edge cases

Send unexpected inputs — empty messages, long strings, emojis, or out-of-order replies — to see how your bot handles them.

Check conversation state

If your bot stores state between messages (for example, multi-step flows), test that the state carries over correctly across multiple turns.

Use logs alongside testing

Open the Logs panel while testing to see console.log output from your bot code in real time. See Execution logs for details.

​
Programmatic testing with test_bot

If you’re working with the AI agent to build or modify your bot, you can ask it to run a simulated test using the built-in test_bot tool. This lets the AI send a message to your bot programmatically and observe the response — without you needing to pick up your phone. To trigger a programmatic test, describe the scenario you want to test in the AI agent chat. For example:
“Test what happens when a user sends ‘hello’ as their first message.”
The AI agent will invoke test_bot, show you the result, and can iterate on your code based on what it finds.
Programmatic testing is especially useful for regression checks — ask the AI to re-run the same test after making code changes to confirm nothing broke.
When you’re done testing, you can unlink your phone from the project. Go to Paige Dev in the project sidebar and click Unlink. Your bot will continue operating normally for real users — only your personal test link is removed.
While your phone is linked, all messages you send to the bot number are processed as real bot interactions. Avoid sending messages you wouldn’t want logged or acted on.