For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Start buildingGet support
DocumentationAPI ReferenceChangelogDiscord
  • Introduction
    • Welcome to Hume AI
    • Getting your API keys
    • Support
    • Pricing
  • Voice
    • Overview
    • Voice design
    • Voice cloning
    • Voice management
  • Text-to-Speech (TTS)
    • Overview
    • Voice
    • Acting instructions
    • Voice conversion
    • Continuation
    • Timestamps
    • FAQ
  • Speech-to-Speech (EVI)
    • Overview
      • Build a configuration
      • Session settings
      • EVI version
      • Voice
      • System prompt
      • Language model
      • Tools
      • Event messages
      • Turn detection
      • Interruption
      • Timeouts
      • Webhooks
    • FAQ
  • Expression Measurement
    • Overview
    • About the science
    • FAQ
  • Integrations
    • MCP
    • Vercel AI SDK
    • LiveKit
    • Pipecat
    • Vapi
    • Twilio
    • Agora
  • Resources
    • Terms of use
    • Use case guidelines
    • Billing
    • Errors
    • Privacy
    • Status
Start buildingGet support
LogoLogo
LogoLogo
On this page
  • Supported events
Speech-to-Speech (EVI)Configuration

Event Messages

Schedule and author EVI responses for key Chat events.
Was this page helpful?
Edit this page
Previous

Turn detection

Tune voice activity detection and end-of-turn behavior.

Next
Built with

Event messages are triggered when specific events occur during a chat session. These messages are used to configure behaviors for EVI, such as controlling how EVI starts a new conversation.

When enabling events you can optionally specify text which EVI will speak verbatim. If no text is provided, then EVI will infer what to say based on the Chat context.

API Reference

See our API reference for how to specify event messages in your EVI configuration.

Supported events

  • On new chat: Specifies the initial message EVI provides when a new chat is started, such as a greeting or welcome message.

  • On max duration timeout: Specifies the message EVI provides when the chat is disconnected due to reaching the maximum chat duration, such as a message mentioning the time limit for the chat has been reached.

  • On inactivity timeout: Specifies the message EVI provides when the chat is about to be disconnected due to a user inactivity timeout, such as a message mentioning a lack of user input for a period of time.

    Enabling an inactivity message allows developers to use this message event for “checking in” with the user if they are not responding to see if they are still active.

    If the user does not respond in the number of seconds specified in the inactivity_timeout field, then EVI will say the message and will wait an additional 15 seconds before the Chat is ended. If the user responds before this grace period ends, the conversation will continue as normal.

    If the inactivity message is not enabled, then reaching the inactivity timeout will immediately end the connection.