Adding application event handlers and prompts

Last Updated : Jun 05, 2026 |

You can install custom event handlers and prompts that you can use either as the system default or as the event handler for a specific application.

Before you begin

Ensure that you test all event handlers thoroughly before you add them to the system.

Important:

Experience Portal does not validate the code in an uploaded event handler. If the event handler has a syntax error, it will not be detected until Experience Portal tries to use the event handler to process a call.

Procedure

  1. Log on to the EPM web interface by using an account with the Administration user role.
  2. On the EPM navigation pane, click System Configuration > EPM Servers, and then click Event Handlers.
  3. Do the following to add a VoiceXML event handler:
    1. Go to the VoiceXML tab.
    2. Verify that an event handler with the filename you intend to use does not already exist.

      If you install an event handler with the same filename as an existing event handler, Experience Portal overwrites the old event handler with the new file without requiring confirmation.

    3. Click Add.
    4. On the Add VoiceXML Event Handler page, enter the appropriate information and click Install.

      You can specify any file with the extension VXML.

  4. Do the following to add a CCXML event handler:
    1. Go to the CCXML tab.
    2. Verify that an event handler with the filename you intend to use does not already exist.

      If you install an event handler with the same filename as an existing event handler, Experience Portal overwrites the old event handler with the new file without requiring confirmation.

    3. Click Add.
    4. On the Add CCXML Event Handler page, enter the appropriate information and click Install.

      You can specify any file with the extension CCXML.

  5. Do the following to add an event handler prompt:
    1. Go to the Prompts tab.
    2. Verify that an event handler prompt with the filename you intend to use does not already exist.

      If you install an event handler prompt with the same filename as an existing prompt, Experience Portal overwrites the old prompt with the new file without requiring confirmation.

    3. Click Add.
    4. On the Add Event Handler Prompt page, enter the appropriate information and click Install.

      You can specify any file with the extension WAV, ALAW, or ULAW. After you add a prompt, it can be used by any of the installed VoiceXML or CCXML event handlers.