> ## Documentation Index > Fetch the complete documentation index at: https://docs.vapify.agency/llms.txt > Use this file to discover all available pages before exploring further. # Assistant Management > Manage and activate your voice assistants in Vapify. ## Assistant Management Overview Voice assistants are the core product you're delivering to your clients. In Vapify, assistants are created in your provider's dashboard (e.g., Vapi.ai) and then assigned to specific subaccounts. Each subaccount can have its own set of assistants with custom pricing. *** ## How Assistant Management Works ### The Complete Workflow 1. **Create assistants** in your provider's dashboard (Vapi.ai, Retell, etc.) 2. **Attach phone numbers** to assistants that need to take phone calls (web calls can work without numbers) 3. **Add provider API key** to the subaccount (General tab) 4. **Sync assistants** to Vapify by saving the API key or clicking "Refresh Assistant List" 5. **Assign assistants** to the subaccount (Assistants tab) 6. **Set pricing** for each assistant (Billing tab) 7. **Go live** by setting a billing start date > **Important:** Vapify does not create or edit assistants. All assistant configuration happens in your provider's dashboard. Vapify only assigns existing assistants to subaccounts and manages pricing. *** ## Creating Assistants in Your Provider Dashboard Before you can use assistants in Vapify, you must create them in your voice AI provider's platform. ### For Vapi.ai Users: 1. Log into your [Vapi.ai dashboard](https://vapi.ai) 2. Navigate to **Assistants** 3. Click **Create New Assistant** 4. Configure your assistant: * Name and description * Voice settings * AI model and prompts * Functions and integrations 5. **Attach a phone number** if the assistant must handle phone calls 6. Save your assistant ### For Other Providers: The same principle applies for Retell and Eleven Labs: * Create and configure assistants in their respective dashboards * Ensure phone numbers are attached for assistants that handle phone calls * Keep your API keys handy for Vapify integration *** ## Assigning Assistants to Subaccounts Sub Account Assistants Configuration Once assistants are created in your provider dashboard, you can assign them to subaccounts in Vapify. ### Assignment Steps 1. Navigate to **Subaccounts** and select the client subaccount 2. Go to the **General tab** and add your provider API key 3. Click **Save Settings** to sync assistants from your provider 4. Switch to the **Assistants tab** 5. Review **Current Assistant Assignments** (initially empty) 6. In the **Assign New Assistant** section, select assistants to assign 7. Click **Refresh Assistant List** if you don't see recent assistants ### Understanding Assignment **What Assignment Means:** * Assigned assistants become available to that specific subaccount/client * Only assigned assistants appear in the client's dashboard * Each subaccount can have different assistants assigned * Assignments control which assistants the client can use and see analytics for **Assignment Restrictions:** * Once a subaccount has a **billing start date set** (has gone live), you cannot edit the provider API keys * You can still add or remove assistants after going live * API key lock is permanent—plan your provider setup carefully before going live ### Refreshing the Assistant List Click **"Refresh Assistant List"** to manually sync the latest assistants from your provider. Use this when: * You just created new assistants in your provider dashboard * You attached phone numbers to previously unattached assistants * You renamed assistants or changed phone numbers * Assistants you expect to see are missing The refresh pulls the current state from your provider's API and updates Vapify's records. *** ## Setting Assistant Pricing Sub Account Assistants Pricing After assigning assistants to a subaccount, you must set the per-minute pricing you'll charge your client. ### Pricing Configuration 1. Navigate to the subaccount's **Billing tab** 2. Click **"Start Per Minute Billing"** (if not already enabled) 3. For each assigned assistant, set the **price per minute** 4. Ensure your price exceeds what your provider charges you ### Pricing Best Practices **Calculate Your Costs:** 1. Check what your provider charges per minute for each assistant 2. Add your desired profit margin 3. Set that as your client price **Example:** ``` Provider cost (Vapi.ai): $0.10/minute Your profit margin: $0.05/minute Your client price: $0.15/minute ``` **Important Considerations:** * Always price higher than provider costs to maintain profitability * If your provider changes their pricing, update yours immediately * Different assistants can have different pricing (complex assistants may cost more) * Document your pricing rationale for each client > **Warning:** If you charge clients LESS than your provider costs, you'll lose money on every call. The platform doesn't prevent this, so verify your math before going live. *** ## Assistant Permissions In the subaccount's **Assistants tab**, you can control assistant permissions: ### Voice Widget Access **Toggle: "Allow customers to talk to the voice assistants"** * **Enabled:** Clients can test assistants through a voice widget in their dashboard * **Disabled:** Clients only see analytics and usage data (no direct testing) The voice widget lets clients interact with their assistants without making actual phone calls. This is useful for: * Testing assistant responses * Demonstrating functionality * Training client staff * Quick troubleshooting Consider enabling this for clients who want hands-on testing, but disable it if you prefer to handle all testing internally. *** ## Platform Assistants View Go to **Assistants** in your sidebar, you can see an overview of all assistants across all subaccounts in your agency. Platform Assistants Screen This global view shows: * All assistants from all connected provider accounts * Which subaccounts each assistant is assigned to * Status and phone number information * Quick access to edit assignments Use this view to: * Get a bird's-eye view of your entire assistant portfolio * Identify which assistants are used by which clients * Spot unassigned assistants * Plan assistant distribution across clients *** ## Common Workflows ### Setting Up a New Client 1. Create a new subaccount for the client 2. Add provider API key in the General tab 3. Sync assistants (automatic on save) 4. Go to Assistants tab and assign relevant assistants 5. Go to Billing tab and set per-minute pricing 6. Test the configuration 7. Set billing start date to go live ### Adding New Assistants to Existing Client **Before Go Live:** 1. Create assistant in provider dashboard (phone number required only for phone calls) 2. Go to subaccount Assistants tab 3. Click "Refresh Assistant List" 4. Assign the new assistant 5. Go to Billing tab and set pricing **After Go Live:** ✅ You can add or remove assistants, but you cannot edit the provider API keys ### Updating Assistant Configuration 1. Make changes in your provider's dashboard (Vapi.ai, etc.) 2. Changes automatically apply to all calls 3. If you changed pricing in the provider, update your client pricing in Vapify's Billing tab > **Note:** You don't need to "refresh" for configuration changes—only for new assistants or phone number changes. *** ## Best Practices ### Assistant Organization * Use clear, descriptive names in your provider dashboard * Attach phone numbers to assistants that need to handle phone calls * Document which assistants serve which purposes * Keep a naming convention across clients (e.g., "ClientName-SalesBot") ### Pricing Strategy * Build in adequate profit margin (at least 25-50%) * Check provider pricing regularly for updates * Consider complexity when pricing (advanced features = higher price) * Clearly communicate pricing to clients before going live ### Assignment Planning * You can adjust assistant assignments at any time, including after go live * Test thoroughly before going live * Document which assistants each client has ### Maintenance * Regularly check that assistants are functioning in provider dashboard * Monitor usage patterns to understand client behavior * Keep provider API keys secure * Audit assistant list periodically to refresh as needed *** ## Troubleshooting ### Assistant Not Appearing in Vapify **Cause:** Incorrect API key, not saved correctly, or list not refreshed **Solution:** 1. Confirm the provider API key is correct 2. Save settings again 3. Click "Refresh Assistant List" ### Cannot Edit Provider API Keys **Cause:** Billing start date has been set (subaccount is live) **Solution:** This is by design and cannot be changed. You must: * Keep the current provider keys * Or create a new subaccount if you need to switch providers or keys ### Pricing Doesn't Seem Right **Cause:** Provider costs changed, or you miscalculated margins **Solution:** 1. Check current provider pricing 2. Recalculate your costs and margins 3. Update pricing in Billing tab 4. Communicate changes to clients if needed ### Client Can't See Their Assistants **Cause:** Assistants not assigned to their subaccount, or voice widget disabled **Solution:** 1. Verify assistants are assigned in Assistants tab 2. Check if "Allow customers to talk to voice assistants" is enabled 3. Verify client is logged into correct subaccount *** ## FAQs All assistants are created and edited directly in your provider's dashboard (e.g., Vapi.ai, Retell, Eleven Labs). Vapify does not create assistants—it only syncs existing ones and manages their assignment to clients and pricing. To create an assistant: 1. Log into your provider's dashboard 2. Create a new assistant with your desired configuration 3. Attach a phone number if the assistant must handle phone calls 4. Return to Vapify and click "Refresh Assistant List" Make sure you've clicked "Refresh Assistant List" in the subaccount's Assistants tab. If you expect a phone-call assistant, attach a phone number in the provider dashboard first. No. All assistant configuration (voice, prompts, AI model, functions, etc.) is managed in your provider's dashboard. Vapify only handles: * Assignment to subaccounts * Per-minute pricing * Usage tracking and billing To edit an assistant, log into your provider's dashboard and make changes there. No. An assistant can only belong to one subaccount at a time. If you need similar assistants for multiple clients, create separate assistants in the provider and assign each to its subaccount. You can change per-minute pricing at any time in the Billing tab, even after going live. The new pricing applies to calls made after the change. Previous calls retain their original pricing. Yes. You can add or remove assistants after the billing start date is set, but you cannot edit the provider API keys for that subaccount. Refresh whenever you: * Create new assistants in your provider dashboard * Attach phone numbers to existing assistants * Change assistant names or phone numbers * Notice assistants are missing from the list You don't need to refresh for configuration changes—those apply automatically to future calls. *** By effectively managing your assistants, you ensure smooth operations, maintain profitability, and deliver excellent service to your clients.