Connect a number to your agent

Create an application that points at your answer URL and attach a Plivo number to it.

Route incoming calls to your voice agent by attaching a number to a Plivo application. An application stores webhook URLs: HTTP endpoints Plivo requests during a call. Its answer URL returns your <Stream> XML.

Before you start, log in, rent a voice-enabled number, and deploy a public answer URL. Test it with simulate. Then create the application, using your URL:

plivo account applications create --app-name my-agent \
  --answer-url https://agent.example.com/plivo/answer --answer-method POST -o json

Put data.app_id from the result in place of "<app_id>", and your rented number in place of 14155551234:

plivo numbers update 14155551234 --app-id "<app_id>" --dry-run
plivo numbers update 14155551234 --app-id "<app_id>"
plivo voice streams readiness 14155551234

The second command changes routing immediately and does not require --yes. The preview shows the current binding: save the previous application or trunk ID first. To restore it, run numbers update with the saved --app-id or --trunk-id.

The readiness check places no call. To move to a new server later, update the application’s URLs; every number attached to it uses the new URL. Searching, buying and compliance are on the Numbers page.

​

Applications

An application holds the webhook URLs Plivo calls for a number. Attach numbers with plivo numbers update --app-id, and update its URLs without touching the number. Global options such as --profile and -o json are in Configuration.

Command	What it does
plivo account applications create	Create a new application
plivo account applications delete	Delete an application (requires —yes)
plivo account applications get	Get application details
plivo account applications list	List applications
plivo account applications update	Update an application

plivo account applications create

plivo account applications create [flags]

Flag	Description
--answer-method <value>	GET|POST (default “POST”)
--answer-url <value>	webhook for incoming calls (required)
--app-name <value>	application name (required)
--default-number-app	set as default for new numbers
--explain	narrate in plain English before executing
--fallback-answer-url <value>	backup webhook if answer-url fails
--hangup-url <value>	webhook for call hangup
--log-incoming-messages	log inbound SMS content (default true)
--message-url <value>	webhook for inbound SMS

plivo account applications delete

plivo account applications delete <app_id> [flags]

Flag	Description
--cascade	delete the app’s endpoints too; —cascade=false keeps them (default true)
--new-endpoint-application <value>	with —cascade=false, the app_id the endpoints move to

By default the app’s endpoints are deleted with it. --cascade=false keeps them, detached from any app; add --new-endpoint-application <app_id> to move them to another app instead:

plivo account applications delete "<app_id>" --cascade=false --new-endpoint-application "<other_app_id>" --yes

plivo account applications get

plivo account applications get <app_id>

plivo account applications list

plivo account applications list [flags]

Flag	Description
--all	fetch every page (stops after 100 pages)
--limit <integer>	results per page (1-20) (default 20)
--offset <integer>	pagination offset

plivo account applications update

plivo account applications update <app_id> [flags]

Flag	Description
--answer-method <value>	GET|POST
--answer-url <value>	new answer URL
--app-name <value>	new application name
--hangup-url <value>	new hangup URL
--message-url <value>	new message URL