IXHC RTC Twilio Phone Call Set-Up

Twilio phone call set-up

  1. Create an assistant and activate call/text with Realtime audio channel

  1. Phone Number will get assigned to an assistant and wehook url will get configured for the phone number in Twilio

  1. Add SystemMessage for the assistant in studio mode

Note : Users can create their own prompts tailored to specific use cases. They can also design their custom call flows.

  1. All Intents needs to be enabled for API-Access.

  1. Make sure Enable API Access is checked while publishing the app.

  2. If the Twilio numbers are not configured, enable Twilio, and you will see list of phone number to choose from.

  1. Call the assigned Phone Number to test the Twilio phone call.

Handle call disconnect/hangup in RTC

Step 1: Overview

This feature allows a Realtime Channel call to disconnect gracefully with a customizable goodbye message. It can trigger under two conditions:

  • 30-60 Seconds of Silence (Configurable): Automatically disconnects if no activity is detected for 30-60 seconds.

  • Conversation Conclusion: Disconnects upon receiving a 'bye' message from the model.

Step 2: Key Benefits

  • Enhanced User Experience: Provides a smooth and considerate closure to conversations.

  • Customizability: Allows setting a personalized goodbye message, enhancing interaction quality.

  • Efficiency: Frees up resources by ending inactive calls promptly.

Step 3: Implementation

By implementing this feature, we ensure efficient use of system resources while maintaining a positive and respectful user experience.

  • Silence for 30-60 Seconds: If there is silence during a call for 30-60 seconds, the bot will:

    • Notify the user about disconnecting using a selected voice (OpenAI/ElevenLabs).

    • Use a pre-configured goodbye message if available.

    • Use a default message if no custom goodbye message is configured.

  • User-initiated Disconnection:

    • The call disconnects within 1-5 seconds if the hangup_call tool is included in the bot's configuration when the user indicates they are done or unwilling to continue.

  • Continuous Interaction:

    • The call remains active during interaction, preventing accidental disconnection.

  • No hangup_call Tool:

    • Without the hangup_call tool configured, the bot will not disconnect the call between 1-5 secs, disconnects only after the configured 30-60 seconds.

Step 4: Configuration

  • Hangup can be configured in the methods of a custom app, in the form of a system message or as a prompt.

The user should exercise caution when using the hangup_call tool. It is essential to invoke the hangup_call prompt at the appropriate time according to the use case. Incorrect timing may result in the call being disconnected abruptly.

It is suggested to get users confirmation before invoking the hangup_call tool.

  • The backend configuration for RTC, can be achieved in Basic Mode. We can configure managing Call/Text Feature in the ixHello platform by enabling the API access of the bot and by choosing the Audio channel to be Real Time.

Sample Recording:

No Answer/Silence Timeout

  1. During a call with the bot, if there is no interaction for 30-60 seconds, the bot will respond with a selected voice (OpenAI/ElevenLabs) and announce the call's disconnection. It will use a default message ("I haven't heard from you, disconnecting the call now. Thank you for your time.") and Custom Goodbye message from bot configuration if its set. The call will not disconnect if there is interaction before the 30-60-second timeout.

Sample Recording:

Last updated

Was this helpful?