Workflow documentation (#453)

* feat: add phone support agent workflow example

* feat: update navigation to link new customer support hotline example

* feat: add screenshots for customer support hotline example

* fix: customer support hotline intro paragraph

* fix(customer-support-hotline): image URLs

* fix(customer-support-hotline): remove broken link from outro

* chore (customer-support-hotline): refine copy, add videos

* chore(customer-support-hotline): delete unnecessary screenshots

* fix(customer-support-hotline): slug

* feat(appointment-scheduling): initial commit

* feat(banking-customer-support): update example to cover a banking use case

* chore(inbound-support): address review feedback, fix system prompt

* feat(appointment-scheduling): new workflow example

* feat(clinic-triage-scheduling): new workflow example

* feat(ecommerce-order-management): new workflow example

* feat(outbound-sales): new workflow example

* chore: delete pizza example

* fix: broken video URLs

* chore: update navigation to include new workflow examples

* fix(inbound-support): broken video URL

* chore: update `overview.mdx` to display new examples

* feat(call-forwarding): update doc to incentivize use of dashboard

* feat(using-query-tool): update doc to incentivize use of dashboard

* feat(custom-tools): update doc to incentivize use of dashboard

* feat(workflows/overview): add doc

* feat(workflows/quickstart): add doc

* feat(workflows): move docs, add new videos

* chore: update nav to include workflow docs

Author: goosewin

fern/call-forwarding.mdx

@@ -18,9 +18,21 @@ Vapi's call forwarding functionality allows you to redirect calls to different p
 
 ## Setting Up Call Forwarding
 
-### 1. Defining Destinations and Messages
+### 1. Create a Transfer Call Tool in the Dashboard
 
-The `transferCall` tool includes a list of destinations and corresponding messages to notify the caller:
+The recommended approach is to create your transfer call tool in the Vapi dashboard:
+
+1. Navigate to **Tools** in your Vapi dashboard
+2. Click **Create Tool**
+3. Select **Transfer Call** as the tool type
+4. Configure your destinations:
+   - **Department A**: `+1234567890` with message "I am forwarding your call to Department A. Please stay on the line."
+   - **Department B**: `+0987654321` with message "I am forwarding your call to Department B. Please stay on the line."
+   - **Department C**: `+1122334455` with message "I am forwarding your call to Department C. Please stay on the line."
+
+### 2. Alternative: API Configuration
+
+You can also define the tool via API with destinations and corresponding messages:
 
 ```json
 {
@@ -112,7 +124,7 @@ You can also specify the `extension` parameter to forward the call to an extensi
     ]
 ```
 
-### 2. Using the `transferCall` Function
+### 3. Using the `transferCall` Function
 
 When the assistant needs to forward a call, it uses the `transferCall` function with the appropriate destination:
 
@@ -127,7 +139,7 @@ When the assistant needs to forward a call, it uses the `transferCall` function
 }
 ```
 
-### 3. Customizing Messages
+### 4. Customizing Messages
 
 Customize the messages for each destination to provide clear information to the caller:
 

fern/docs.yml

@@ -116,19 +116,37 @@ navigation:
               - page: Inbound support
                 path: examples/inbound-support.mdx
                 icon: fa-light fa-phone-volume
-              - page: Outbound sales
-                path: examples/outbound-sales.mdx
-                icon: fa-light fa-money-bill-wave
-              - page: Pizza website
-                path: examples/pizza-website.mdx
-                icon: fa-light fa-pizza-slice
               - page: Voice widget
                 path: examples/voice-widget.mdx
                 icon: fa-light fa-window-maximize
               - page: Documentation agent
                 path: examples/docs-agent.mdx
                 icon: fa-light fa-microphone
 
+      - section: Workflows
+        contents:
+          - page: Quickstart
+            path: workflows/quickstart.mdx
+            icon: fa-light fa-bolt-lightning
+          - page: Overview
+            path: workflows/overview.mdx
+            icon: fa-light fa-book
+          - section: Examples
+            icon: fa-light fa-code
+            contents:
+              - page: Appointment scheduling
+                path: workflows/examples/appointment-scheduling.mdx
+                icon: fa-light fa-calendar-check
+              - page: Outbound sales
+                path: workflows/examples/outbound-sales.mdx
+                icon: fa-light fa-money-bill-wave
+              - page: Medical triage
+                path: workflows/examples/clinic-triage-scheduling.mdx
+                icon: fa-light fa-stethoscope
+              - page: Order management
+                path: workflows/examples/ecommerce-order-management.mdx
+                icon: fa-light fa-shopping-cart
+
       - section: Assistant customization
         contents:
           - section: Conversation behaviour
@@ -722,7 +740,9 @@ redirects:
   - source: "/technical_support"
     destination: "/examples/inbound-support"
   - source: "/pizza_website"
-    destination: "/examples/pizza-website"
+    destination: "/examples/inbound-support"
+  - source: "/examples/pizza-website"
+    destination: "/examples/inbound-support"
   - source: "/outbound_call_python"
     destination: "/examples/outbound-call-python"
   - source: "/voice_widget"

fern/examples/inbound-support.mdx

@@ -51,7 +51,7 @@ We will be creating a customer support agent for VapiBank, a bank that wants to
   </Step>
 </Steps>
 
-<video autoPlay loop muted src="../static/videos/inbound-support/upload-files.mp4" type="video/mp4" style={{ aspectRatio: '16 / 9', width: '100%' }} />
+<video autoPlay loop muted src="../static/videos/upload-files.mp4" type="video/mp4" style={{ aspectRatio: '16 / 9', width: '100%' }} />
 
 ---