Skip to main content

Dashboard Setup

Before you can run a Piopiy AI agent, you must provision an agent credential pair and lease a phone number to connect to the public telephony network.

This setup takes place entirely within the Piopiy Dashboard.

Video Walkthrough​

Watch the complete loop: purchasing a number, generating agent credentials, and mapping the routing.

Video walkthrough will be added soon. Follow the step-by-step setup below for the complete flow.

1. Create your Agent Credentials​

First, you need an AGENT_ID and AGENT_TOKEN to authenticate your Python script securely.

  1. Log into the Piopiy Dashboard.
  2. Navigate to Voice AI -> Agents.
  3. Click Create Agent.
  4. Give your agent a name (e.g., "Customer Support Agent").
  5. Copy the generated AGENT_ID and AGENT_TOKEN. Keep these secure!

2. Buy a Phone Number​

To let people call your agent, you need a public phone number.

  1. Navigate to Numbers in the sidebar.
  2. Click Buy a Number.
  3. Select your desired Country and Type (Local, Toll-Free, etc).
  4. Purchase the number.

3. Map Number to your Agent​

Finally, associate your new phone number with the AI Agent you created. This creates the routing rule: when this number is dialed, trigger a Live Session on your AGENT_ID.

  1. Go back to your Numbers list.
  2. Find the number you just purchased and click the Configure (gear) icon.
  3. In the routing dropdown, select AI Agent.
  4. Choose the Agent Name you created in Step 1.
  5. Save the configuration.

Once this setup is complete, you can return to the Quickstart to write your code.