Skip to main content

PhoneServer Providers

The PhoneServer Providers panel displays the synchronization status with the PhoneServer. This helps you monitor provider health and troubleshoot connectivity issues.

Accessing PhoneServer Providers​

Navigate to Bot > Providers and scroll down to the Phone Server Providers section, or access it from the Providers page.

PhoneServer Providers

PhoneServer Connection Health​

The PhoneServer Connection Health table shows all PhoneServers that have ever connected to the platform.

PhoneServer Connection Health

Health Check Monitoring​

  • Disconnected PhoneServers appear in the platform health check at /api/health
  • This allows monitoring of connection issues across all registered PhoneServers

Cleaning Up Connections​

If a PhoneServer should no longer communicate with the platform (e.g., it was only used for a demo), you can remove it from health checks by clicking the delete button. This prevents it from appearing in the health check results.

Understanding the Provider Table​

The table displays all STT and TTS providers with their sync status:

ColumnDescription
TitleProvider name with an icon indicating STT (microphone) or TTS (speaker)
TypeSTT for Speech-to-Text, TTS for Text-to-Speech
StatusCurrent synchronization status
Last SyncTimestamp of the last successful sync, or "Never" if not synced
AttemptsNumber of sync attempts
ErrorError message if sync failed
ActionsManual resync button

Sync Status Values​

StatusBadge ColorMeaning
SYNCEDGreenProvider is successfully synchronized with PhoneServer
PENDINGGraySync is in progress or queued
FAILEDRedSync failed - check error message
DIRTYYellowConfiguration changed, needs resync

Filtering Providers​

Use the filter buttons in the top right to view:

  • All - All STT and TTS providers
  • STT - Only Speech-to-Text providers
  • TTS - Only Text-to-Speech providers

Sync Process​

Automatic Sync​

Providers are automatically synchronized when:

  1. A new provider is created
  2. An existing provider is updated
  3. PhoneServer reconnects after disconnection
  4. Phone channel configuration changes

Manual Resync​

To manually trigger a resync:

  1. Find the provider in the table
  2. Click the resync button (circular arrow icon) in the Actions column
  3. Wait for the status to update

Tip: Use manual resync when a provider shows "FAILED" status after fixing the underlying issue.

Troubleshooting Sync Issues​

Provider Shows "FAILED"​

Common causes:

  • Invalid API credentials - Verify your API key is correct
  • Network connectivity - Check if the provider's API is reachable
  • Configuration error - Review provider settings
  • Service outage - Check provider status page

Steps to resolve:

  1. Check the Error column for details
  2. Navigate to Bot > Providers and edit the provider
  3. Verify and update credentials if needed
  4. Save the provider
  5. Click resync in the PhoneServer Providers table

Provider Stuck on "PENDING"​

This may indicate:

  • PhoneServer connection issues
  • High server load
  • Network latency

Steps to resolve:

  1. Wait a few moments for sync to complete
  2. Refresh the page
  3. Check PhoneServer connection status in Phone Channel header
  4. If still pending, try manual resync

"Never" in Last Sync Column​

The provider has never been successfully synced. This typically means:

  • Provider was just created
  • All sync attempts have failed
  • PhoneServer has never connected

Steps to resolve:

  1. Verify PhoneServer is connected (check Phone Channel header)
  2. Review provider configuration
  3. Click resync to trigger a new sync attempt

Multiple Failed Attempts​

If the Attempts column shows a high number (e.g., 5+):

  • There may be a persistent configuration issue
  • The provider credentials may be invalid
  • The external service may be unavailable

Steps to resolve:

  1. Verify the external service is operational
  2. Double-check all provider credentials
  3. Test the provider in the external service's own console
  4. After fixing, reset by editing and saving the provider

Connection Status​

The PhoneServer connection status is shown in the Phone Channel header:

StatusMeaning
ConnectedPhoneServer is connected and can process calls
DisconnectedNo connection to PhoneServer
ErrorConnection error occurred

If the PhoneServer is disconnected:

  • Provider syncs will be queued
  • Phone calls cannot be processed
  • Contact your administrator

Provider Error Messages​

Common error messages and their meanings:

ErrorMeaningSolution
STT processing failedSTT service rejected the configurationCheck API key and language settings
Error while receiving TTS responseTTS service returned an errorVerify credentials and voice settings
Connection timeoutCould not reach the providerCheck network connectivity
Invalid credentialsAPI key is incorrect or expiredUpdate API credentials
Unsupported languageLanguage code not supportedCheck provider's supported languages

Best Practices​

Multiple Providers​

  • Configure backup providers of the same type
  • If one provider fails, switch to backup in phone channel settings
  • Different providers have different strengths (quality vs. latency vs. cost)

After Configuration Changes​

  • Always verify sync status after changing provider settings
  • Wait for "SYNCED" status before testing phone functionality
  • If sync fails, check error details before troubleshooting further