Vobiz Integration

Overview#

Vobiz is a cloud-based telephony service provider that offers global reach with competitive pricing. Lemu AI's Vobiz integration provides reliable voice connectivity for your conversational AI agents.

Prerequisites#

Before setting up Vobiz integration, you'll need:

• A Vobiz account
• Auth ID from your Vobiz dashboard
• Auth Token generated for your account
• At least one configured phone number in your Vobiz account
• Lemu AI instance running and accessible

Configuration#

Step 1: Get Vobiz Credentials#

1. Sign up for a Vobiz account
2. Log in to your Vobiz dashboard
3. Navigate to your account settings to find your Auth ID
4. Generate an Auth Token for API access
5. Configure phone numbers in your Vobiz account for outbound calling

Step 2: Configure in Lemu AI#

1. Go to Configuration in the sidebar → Telephony tab
2. Select Vobiz as your provider
3. Enter your credentials:
   • Auth ID
   • Auth Token
   • From Phone Number (with country code, e.g., +1234567890)
4. Click Save Configuration

Step 3: Test Your Configuration#

1. Create a test workflow
2. Click "Test Call" to verify connection
3. Check call logs for successful connection

Inbound Calling Setup#

To enable inbound calling with Vobiz:

1. Complete Telephony Configuration: Use the same Configuration steps above
2. Get Your Workflow Webhook URL: Find your workflow ID and construct the webhook URL as: https://app.lemuai.com/api/v1/telephony/inbound/{workflow_id}

Configure Application in Vobiz Console#

Vobiz requires creating an XML application to handle inbound calls. Follow these steps:

1. Navigate to Applications:

   • Log in to your Vobiz Console
   • Navigate to the Applications section
   

2. Create New Application:

   • Click Create New Application
   • Configure the XML application with the following URLs:
     • Answer URL: https://app.lemuai.com/api/v1/telephony/inbound/{workflow_id}
     • Hangup URL: https://app.lemuai.com/api/v1/telephony/vobiz/hangup-callback/workflow/{workflow_id}
     • Fallback Answer URL: https://app.lemuai.com/api/v1/telephony/inbound/fallback
   • Save the application

   Replace {workflow_id} with your actual workflow ID.

   

3. Attach Phone Number:

   • After saving the application, edit it to attach a phone number
   • Select the phone number you want to use for inbound calls
   • Link it to your created application
   

4. Verify Setup:

   • Ensure your Lemu AI instance is publicly accessible
   • Verify any firewalls allow Vobiz's webhook requests

Test Inbound Calling#

1. Call your configured Vobiz phone number from another phone
2. Verify your Lemu AI voice agent answers and responds
3. Check call logs in both Lemu AI dashboard and Vobiz dashboard

Troubleshooting#

Best Practices#

• Store credentials securely in the database
• Test your configuration with a single call before running campaigns
• Monitor Vobiz dashboard for usage and billing
• Keep your Auth Token secure and rotate it periodically