From 79e102c8073835cb187e975c5f04494a9b066c00 Mon Sep 17 00:00:00 2001 From: Bryant Date: Fri, 7 Feb 2025 06:45:50 +1100 Subject: [PATCH 1/5] refactor: swap buy number text for create number text --- fern/examples/inbound-support.mdx | 5 +++-- fern/examples/outbound-sales.mdx | 5 +++-- fern/phone-calling.mdx | 4 ++-- fern/pricing.mdx | 8 ------- fern/quickstart/inbound.mdx | 2 +- fern/quickstart/outbound.mdx | 2 +- fern/server-url/setting-server-urls.mdx | 2 +- .../provision-phone-number-with-vapi.mdx | 17 +++++++-------- .../quickstart/phone/get-a-phone-number.mdx | 21 +++++++++---------- 9 files changed, 29 insertions(+), 37 deletions(-) diff --git a/fern/examples/inbound-support.mdx b/fern/examples/inbound-support.mdx index 8b2d869ef..d2196b7c2 100644 --- a/fern/examples/inbound-support.mdx +++ b/fern/examples/inbound-support.mdx @@ -51,13 +51,14 @@ As a bonus, we also want the assistant to remember by the phone number of the ca For this example, we're going to store the conversation on our server between calls and use the [Server URL's `assistant-request`](/server-url#retrieving-assistants) to fetch a new configuration based on the caller every time someone calls. - - We'll buy a phone number for inbound calls using the [Phone Numbers API](/api-reference/phone-numbers/buy-phone-number). + + We'll create a phone number for inbound calls using the [Phone Numbers API](/api-reference/phone-numbers/create). ```json { "id": "c86b5177-5cd8-447f-9013-99e307a8a7bb", "orgId": "aa4c36ba-db21-4ce0-9c6e-99e307a8a7bb", + "provider": "vapi", "number": "+11234567890", "createdAt": "2023-09-29T21:44:37.946Z", "updatedAt": "2023-12-08T00:57:24.706Z", diff --git a/fern/examples/outbound-sales.mdx b/fern/examples/outbound-sales.mdx index a2e769256..27fccf311 100644 --- a/fern/examples/outbound-sales.mdx +++ b/fern/examples/outbound-sales.mdx @@ -72,13 +72,14 @@ We want this agent to be able to call a list of leads and schedule appointments. We'll then make a POST request to the [Create Assistant](/api-reference/assistants/create-assistant) endpoint to create the assistant. - - We'll buy a phone number for outbound calls using the [Phone Numbers API](/phone-calling#set-up-a-phone-number). + + We'll create a phone number for outbound calls using the [Phone Numbers API](/phone-calling#set-up-a-phone-number). ```json { "id": "c86b5177-5cd8-447f-9013-99e307a8a7bb", "orgId": "aa4c36ba-db21-4ce0-9c6e-99e307a8a7bb", + "provider": "vapi", "number": "+11234567890", "createdAt": "2023-09-29T21:44:37.946Z", "updatedAt": "2023-12-08T00:57:24.706Z", diff --git a/fern/phone-calling.mdx b/fern/phone-calling.mdx index a3dd1ad28..7a4a0ba91 100644 --- a/fern/phone-calling.mdx +++ b/fern/phone-calling.mdx @@ -7,9 +7,9 @@ slug: phone-calling -You can set up a phone number to place and receive phone calls. Phone numbers can be bought directly through Vapi, or you can use your own from Twilio. +You can set up a phone number to place and receive phone calls. Phone numbers can be created directly through Vapi, or you can use your own from Twilio. -You can buy a phone number through the dashboard or use the [`/phone-numbers/buy`](/api-reference/phone-numbers/buy-phone-number)` endpoint. +You can create a free phone number through the dashboard or use the [`/phone-numbers`](/api-reference/phone-numbers/create) endpoint. If you want to use your own phone number, you can also use the dashboard or the [`/phone-numbers/import`](/api-reference/phone-numbers/import-twilio-number) endpoint. This will use your Twilio credentials to verify the number and configure it with Vapi services. diff --git a/fern/pricing.mdx b/fern/pricing.mdx index f11dfc281..b77c6593f 100644 --- a/fern/pricing.mdx +++ b/fern/pricing.mdx @@ -31,14 +31,6 @@ slug: pricing > Bring your own API keys for providers, Vapi makes requests on your behalf. - - Phone numbers purchased through Vapi bill at $2/mo. - ### Starter Credits diff --git a/fern/quickstart/inbound.mdx b/fern/quickstart/inbound.mdx index d6fa2f0b5..b2121e879 100644 --- a/fern/quickstart/inbound.mdx +++ b/fern/quickstart/inbound.mdx @@ -22,7 +22,7 @@ An inbound call is a phone call that comes **"in"** towards a phone number, & in There are **4 steps** we will cover to handle our first inbound phone call: 1. **Create an Assistant:** we will create an [assistant](/assistants) & instruct it on how to conduct the call -2. **Get a Phone Number:** we can either import existing numbers we own, or purchase one through Vapi +2. **Get a Phone Number:** we can either import existing numbers we own, or create a free one through Vapi 3. **Attach Our Assistant:** we will put our assistant behind the phone number to pick up calls 4. **Call the Number:** we can then call the number & talk to our assistant diff --git a/fern/quickstart/outbound.mdx b/fern/quickstart/outbound.mdx index c9d923057..5afde350b 100644 --- a/fern/quickstart/outbound.mdx +++ b/fern/quickstart/outbound.mdx @@ -22,7 +22,7 @@ An outbound call is a phone call that is dialed and goes **"out"** from a phone There are **3 steps** we will cover to send our first outbound phone call: 1. **Create an Assistant:** we will create an [assistant](/assistants) & instruct it on how to conduct itself during the call -2. **Get a Phone Number:** we can either import existing numbers we own, or purchase one through Vapi +2. **Get a Phone Number:** we can either import existing numbers we own, or create a free one through Vapi 3. **Call Your Number:** we will set our assistant as the dialer, set the destination phone number, then make the call We can then send the outbound call, hopefully someone picks up! diff --git a/fern/server-url/setting-server-urls.mdx b/fern/server-url/setting-server-urls.mdx index 244ac9531..b8e719283 100644 --- a/fern/server-url/setting-server-urls.mdx +++ b/fern/server-url/setting-server-urls.mdx @@ -39,7 +39,7 @@ Here's a breakdown of where you can set server URLs in Vapi: Phone numbers can have a server URL attached to them via the [phone number API](/api-reference/phone-numbers). The server URL for phone numbers can be set **3 ways**: - - **At Time of Purchase:** when you [buy a number](/api-reference/phone-numbers/buy-phone-number) through Vapi + - **At Time of Purchase:** when you [create a number](/api-reference/phone-numbers/create) through Vapi - **At Import:** when you [import from Twilio](/api-reference/phone-numbers/import-twilio-number) or [Vonage](/api-reference/phone-numbers/import-vonage-number) - **Via Update:** you can [update a number](/api-reference/phone-numbers/update-phone-number) already in your account diff --git a/fern/snippets/quickstart/dashboard/provision-phone-number-with-vapi.mdx b/fern/snippets/quickstart/dashboard/provision-phone-number-with-vapi.mdx index 7706f94e2..3d1da4cbd 100644 --- a/fern/snippets/quickstart/dashboard/provision-phone-number-with-vapi.mdx +++ b/fern/snippets/quickstart/dashboard/provision-phone-number-with-vapi.mdx @@ -1,11 +1,6 @@ -The quickest way to secure a phone number for your assistant is to purchase a phone number directly through Vapi. +The quickest way to secure a phone number for your assistant is to create a phone number directly through Vapi. - - Ensure you have a card on file that Vapi can bill before proceeding, you can add your billing - information in your dashboard at [dashboard.vapi.ai/billing](https://dashboard.vapi.ai/billing) - - -Navigate to the "Phone Numbers" section & click the "Buy number" button: +Navigate to the "Phone Numbers" section & click the "Create Phone Number" button: @@ -18,14 +13,18 @@ We will use the area code `415` for our phone number (these are area codes domes - Currently, only US & Canada phone numbers can be directly purchased through Vapi. Phone numbers in + Currently, only US & Canada phone numbers can be directly created through Vapi. Phone numbers in other regions must be imported, see our [phone calling](/phone-calling) guide. -Click "Buy", after purchasing a phone number you should see something like this: +Click "Create", after creating a phone number you should see something like this: + + It takes a couple of minutes for the phone number to be fully activated. During this period, calls will not be functional. + + The phone number is now ready to be used (either for inbound or outbound calling). diff --git a/fern/snippets/quickstart/phone/get-a-phone-number.mdx b/fern/snippets/quickstart/phone/get-a-phone-number.mdx index a999c1979..7d3610bdf 100644 --- a/fern/snippets/quickstart/phone/get-a-phone-number.mdx +++ b/fern/snippets/quickstart/phone/get-a-phone-number.mdx @@ -1,22 +1,17 @@ There are **2 ways** we can get a phone number into our Vapi account: -1. **Purchase a Number Through Vapi:** we can directly purchase phone numbers through Vapi. +1. **Create a Number Through Vapi:** we can directly create phone numbers through Vapi. - - Vapi will provision the phone number for us via Twilio + - Vapi will provision the phone number for us - This can be done in the dashboard, or via the API (we will use the dashboard) 2. **Import from Twilio or Vonage:** if we already have a phone number with an external telephony provider (like Twilio or Vonage), we can import them into our Vapi account. - The quickest way to secure a phone number for your assistant is to purchase a phone number directly through Vapi. + The quickest way to secure a phone number for your assistant is to create a phone number directly through Vapi. - - Ensure you have a card on file that Vapi can bill before proceeding, you can add your billing - information in your dashboard at [dashboard.vapi.ai/billing](https://dashboard.vapi.ai/billing) - - - Navigate to the "Phone Numbers" section & click the "Buy number" button: + Navigate to the "Phone Numbers" section & click the "Create Phone Number" button: @@ -29,16 +24,20 @@ There are **2 ways** we can get a phone number into our Vapi account: - Currently, only US & Canada phone numbers can be directly purchased through Vapi. Phone numbers in + Currently, only US & Canada phone numbers can be directly created through Vapi. Phone numbers in other regions must be imported, see our [phone calling](/phone-calling) guide. - Click "Buy", after purchasing a phone number you should see something like this: + Click "Create", after creating a phone number you should see something like this: + + It takes a couple of minutes for the phone number to be fully activated. During this period, calls will not be functional. + + The phone number is now ready to be used (either for inbound or outbound calling). From ad4d6c785bf8800649142141344744fdb4b900b3 Mon Sep 17 00:00:00 2001 From: Bryant Date: Fri, 7 Feb 2025 07:40:04 +1100 Subject: [PATCH 2/5] refactor: swap out buy phone number dashboard snippets --- fern/community/knowledgebase.mdx | 2 +- .../provision-phone-number-with-vapi.mdx | 2 +- .../quickstart/phone/get-a-phone-number.mdx | 2 +- .../dashboard/create-vapi-phone-number.png | Bin 0 -> 134176 bytes 4 files changed, 3 insertions(+), 3 deletions(-) create mode 100644 fern/static/images/quickstart/dashboard/create-vapi-phone-number.png diff --git a/fern/community/knowledgebase.mdx b/fern/community/knowledgebase.mdx index d1b931113..4cbab936a 100644 --- a/fern/community/knowledgebase.mdx +++ b/fern/community/knowledgebase.mdx @@ -28,7 +28,7 @@ Navigate to Platform > Files and upload your custom files in Markdown, PDF, plai Adding files to your Knowledge Base diff --git a/fern/snippets/quickstart/dashboard/provision-phone-number-with-vapi.mdx b/fern/snippets/quickstart/dashboard/provision-phone-number-with-vapi.mdx index 3d1da4cbd..4b8af357f 100644 --- a/fern/snippets/quickstart/dashboard/provision-phone-number-with-vapi.mdx +++ b/fern/snippets/quickstart/dashboard/provision-phone-number-with-vapi.mdx @@ -3,7 +3,7 @@ The quickest way to secure a phone number for your assistant is to create a phon Navigate to the "Phone Numbers" section & click the "Create Phone Number" button: - + We will use the area code `415` for our phone number (these are area codes domestic to the US & Canada). diff --git a/fern/snippets/quickstart/phone/get-a-phone-number.mdx b/fern/snippets/quickstart/phone/get-a-phone-number.mdx index 7d3610bdf..f8a3a2e1f 100644 --- a/fern/snippets/quickstart/phone/get-a-phone-number.mdx +++ b/fern/snippets/quickstart/phone/get-a-phone-number.mdx @@ -14,7 +14,7 @@ There are **2 ways** we can get a phone number into our Vapi account: Navigate to the "Phone Numbers" section & click the "Create Phone Number" button: - + We will use the area code `415` for our phone number (these are area codes domestic to the US & Canada). diff --git a/fern/static/images/quickstart/dashboard/create-vapi-phone-number.png b/fern/static/images/quickstart/dashboard/create-vapi-phone-number.png new file mode 100644 index 0000000000000000000000000000000000000000..ac134e8ce90ed09ca55e39cf6c349d5b83acaa07 GIT binary patch literal 134176 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