Ayra AI
|Docs
Configuration

Getting Your Environment Ready

This guide covers everything you need to set up Ayra AI for your agency or business, from creating your account to configuring advanced settings.

Click to unmute

Account Setup

Creating Your Account

1

Sign Up

Visit https://app.ayra.ai/signup

First Name: [Your first name]
Last Name: [Your last name]
Email: [your-email@company.com]
Password: [Create strong password]
Company Name: [Your business name]
Account Type:
Agency (I'm offering services to clients)
Business (Using for my own company)
Developer (Building integrations)
Password Requirements:
  • Minimum 12 characters
  • At least one uppercase letter
  • At least one lowercase letter
  • At least one number
  • At least one special character (!@#$%^&*)
2

Email Verification

Check your inbox for verification email from Ayra AI and click the verification link.

3

Initial Login

After verification, log in with your email and password.

Workspace Configuration

Workspace Settings

After first login, configure your workspace:

Workspace Name:Your Company Name (appears in URL: yourcompany.ayra.ai)
Workspace Display Name:How it appears in interface
Industry:Select from dropdown
Company Size:Just me, 2-10, 11-50, or 51+ people
Primary Use Case:Agency model or direct business

Team Members

Add team members who will use the platform:

RolePermissions
Workspace AdminFull access
ManagerCreate/edit agents, view all
MemberView and use agents
ViewerView-only access

Phone Number Setup

You need a phone number for your voice agents to answer.

Option 1: Get New Number from Ayra

Recommended
  1. 1Navigate to Settings → Phone Numbers → Get New Number
  2. 2Select country and area code
  3. 3Choose from available numbers
  4. 4Click "Get This Number"

Pricing:

Local numbers:Free (included in all plans)
Toll-free numbers:$5/month per number
Additional numbers:Free (unlimited)

Option 2: Port Existing Number

  1. 1Navigate to Settings → Phone Numbers → Port Number
  2. 2Enter current phone number and provider details
  3. 3Provide account number and PIN
  4. 4Start porting process (takes 2-5 business days)

Your existing number continues to work until porting is complete.

Option 3: Use Your Own SIP Trunk

For advanced users with existing telecom infrastructure.

SIP ProviderSIP Trunk URIUsernamePassword

Integration Setup

Voice AI Platform

Vapi Integration

  1. Navigate to Settings → Integrations → Voice AI → Vapi
  2. Enter your Vapi API key (from vapi.ai dashboard)
  3. Click "Test Connection" then "Save"

Retell Integration

  1. Navigate to Settings → Integrations → Voice AI → Retell
  2. Enter API Key and Account ID
  3. Click "Test Connection" then "Save"

Start with Vapi (easier, more languages). Add Retell later if you need lower latency or custom voices.

Calendar Integration

Google Calendar

  1. Navigate to Settings → Integrations → Calendar → Google Calendar
  2. Click "Connect Google Calendar"
  3. Authorize in Google (view/edit events, create events)
  4. Select primary calendar and save

Outlook Calendar

  1. Similar process using Microsoft authentication

CRM Integration

HubSpot

  1. Navigate to Settings → Integrations → CRM → HubSpot
  2. Click "Connect to HubSpot"
  3. Authorize access (Contacts, Companies, Deals, Tickets)

Salesforce

  1. Similar OAuth process

Communication Channels

Twilio (SMS)

Account SIDAuth TokenPhone Number

SendGrid (Email)

API KeyFrom EmailFrom Name

White-Label Configuration

Branding Setup

Make the platform look like your own.

Logo Upload

Full Logo (Horizontal):200x50px, PNG
Logo Icon (Square):512x512px, PNG
Favicon:32x32px, ICO or PNG

Color Scheme

Primary Color:Buttons, links, headers
Secondary Color:Accents, highlights
Success/Warning/Error:Keep defaults recommended

Typography

System DefaultInter (Recommended)RobotoOpen SansCustom (upload font)

Custom Domain

Use your own domain (e.g., app.yourcompany.com).

  1. 1Navigate to Settings → White-Label → Custom Domain
  2. 2Enter your custom domain
  3. 3Add CNAME record to your DNS (Type: CNAME, Name: app, Value: custom.ayra.ai)
  4. 4Click "Verify DNS" then "Save Domain"
  5. 5Wait for SSL certificate provisioning (5-10 minutes)

Billing Setup

Payment Method

Add your payment method.

Card NumberExpirationCVCZIP CodeCardholder NameBilling Address

Subscription Plan

Starter

$99/month

  • 1,000 minutes
  • 1 team member
  • Basic support

Professional

Popular

$299/month

  • 5,000 minutes
  • 5 team members
  • Priority support + White-label

Enterprise

Custom

  • Unlimited
  • Unlimited
  • Dedicated support + Custom features

Security Configuration

Two-Factor Authentication

Enable 2FA for added security.

Authenticator App (Recommended)
Google AuthenticatorAuthy1Password
SMS (Less secure)
  1. 1Scan QR code with authenticator app
  2. 2Enter 6-digit code from app
  3. 3Save backup codes (in case you lose phone)

IP Whitelist (Optional)

Restrict access to specific IP addresses for extra security.

Only these IPs can access your account. Make sure you add all necessary IPs.

API Keys

Generate API keys for integrations.

Read agentsWrite agentsRead analyticsBilling access

Save your API key securely - it's only shown once.

Testing Your Setup

Before going live, test everything.

Account & Access

  • Can log in successfully
  • Team members invited and can access
  • 2FA working (if enabled)

Phone System

  • Phone number active
  • Can receive test calls
  • Audio quality is good

Integrations

  • Voice AI connected (Vapi/Retell)
  • Calendar connected (if needed)
  • CRM connected (if needed)
  • SMS working (if needed)

Branding

  • Logo displays correctly
  • Colors match brand
  • Custom domain working (if configured)

Billing

  • Payment method added
  • Subscription active
  • Understand overage pricing

Notifications

  • Email notifications working
  • Alert preferences set
  • Test alerts received

Troubleshooting Setup Issues

Can't Log In

  • Check password (case-sensitive)
  • Verify email is correct
  • Try password reset
  • Clear browser cache
  • Try different browser

Phone Number Not Working

  • Verify number is activated
  • Check number settings
  • Try calling from different phone
  • Contact support if persists

Integration Failing

  • Re-authenticate (disconnect and reconnect)
  • Check API credentials
  • Verify permissions granted
  • Test API key independently
  • Check service status page

Custom Domain Not Working

  • Verify DNS records (use DNS checker tool)
  • Wait for DNS propagation (up to 48 hours)
  • Check for typos in CNAME
  • Ensure no conflicting records
  • Contact support if still failing

Payment Issues

  • Verify card is valid and not expired
  • Check billing address matches card
  • Try different payment method
  • Contact your bank
  • Reach out to support@ayra.cx

You're All Set!

Your Ayra AI environment is now fully configured and ready to use.

Create your first voice agent

Ready to transform your agency?

Start building with Ayra today. No credit card required.