docs in build section for free numbers

fern/docs.yml

@@ -184,6 +184,10 @@ navigation:
                 path: squads-example.mdx
               - page: Silent Transfers
                 path: squads/silent-transfers.mdx
+          - section: Phone Numbers
+            contents:
+              - page: Free Telephony
+                path: phone-numbers/free-telephony.mdx
       - section: Test
         contents:
           - page: Manual Testing

fern/phone-numbers/free-telephony.mdx

@@ -0,0 +1,56 @@
+---
+title: Creating Free Phone Numbers 
+subtitle: Creating free phone numbers on the Vapi platform.
+slug: free-telephony
+---
+
+This guide details how to create free phone numbers on the Vapi platform, which you can use with your assistants or squads.
+
+<Steps>
+  ### Head to the “Phone Numbers” tab in your Vapi dashboard.
+
+<Frame>
+  <img src="../static/images/quickstart/dashboard/vapi-phone-numbers-sidebar-selection.png" />
+</Frame>
+
+  ### Click on “Create a Phone Number”
+
+<Frame>
+  <img src="../static/images/quickstart/dashboard/create-vapi-phone-number-empty-view.png" />
+</Frame>
+
+  ### Within the "Free Vapi Number" tab, enter your desired area code
+
+<Note>
+    Currently, only US phone numbers can be directly created through Vapi.
+</Note>
+
+<Frame>
+  <img src="../static/images/quickstart/dashboard/buy-vapi-phone-number-modal.png" />
+</Frame>
+
+  ### Vapi will automatically allot you a random phone number — free of charge!
+
+<Note>
+    It takes a couple of minutes for the phone number to be fully activated. During this period, calls will not be functional.
+</Note>
+
+<Frame>
+  <img src="../static/images/quickstart/dashboard/vapi-phone-number-config.png" />
+</Frame>
+
+</Steps>
+
+### Frequently Asked Questions
+
+<AccordionGroup>
+    <Accordion title="Can I get more than 10 free phone numbers?" icon="phone" iconType="regular">
+        For now, each wallet can have up to 10 free numbers. This limit ensures we can continue offering reliable, high-quality service to everyone.
+    </Accordion>
+    <Accordion title="Are international calls and numbers also free?" icon="phone" iconType="regular">
+        Not at this time. You can still bring in global numbers using our phone number import feature.
+    </Accordion>
+    <Accordion title="Is there a catch to the free service?" icon="phone" iconType="regular">
+        None at all. We’re simply passing on the cost efficiencies we’ve gained through robust engineering and volume partnerships.
+    </Accordion>
+</AccordionGroup>

fern/snippets/quickstart/dashboard/provision-phone-number-with-vapi.mdx

@@ -6,14 +6,14 @@ Navigate to the "Phone Numbers" section & click the "Create Phone Number" button
   <img src="/static/images/quickstart/dashboard/create-vapi-phone-number.png" />
 </Frame>
 
-We will use the area code `415` for our phone number (these are area codes domestic to the US & Canada).
+We will use the area code `415` for our phone number (these are area codes domestic to the US).
 
 <Frame caption="Choose an area code for your phone number.">
   <img src="/static/images/quickstart/dashboard/buy-vapi-phone-number-modal.png" />
 </Frame>
 
 <Info>
-  Currently, only US & Canada phone numbers can be directly created through Vapi. Phone numbers in
+  Currently, only US phone numbers can be directly created through Vapi. Phone numbers in
   other regions must be imported, see our [phone calling](/phone-calling) guide.
 </Info>
 

fern/snippets/quickstart/phone/get-a-phone-number.mdx

@@ -17,14 +17,14 @@ There are **2 ways** we can get a phone number into our Vapi account:
       <img src="/static/images/quickstart/dashboard/create-vapi-phone-number.png" />
     </Frame>
 
-    We will use the area code `415` for our phone number (these are area codes domestic to the US & Canada).
+    We will use the area code `415` for our phone number (these are area codes domestic to the US).
 
     <Frame caption="Choose an area code for your phone number.">
       <img src="/static/images/quickstart/dashboard/buy-vapi-phone-number-modal.png" />
     </Frame>
 
     <Info>
-      Currently, only US & Canada phone numbers can be directly created through Vapi. Phone numbers in
+      Currently, only US phone numbers can be directly created through Vapi. Phone numbers in
       other regions must be imported, see our [phone calling](/phone-calling) guide.
     </Info>