Ziddny LogoZiddny Docs
Assistants

Assistant Settings

Configure your assistant’s general settings, voice interaction modes, and advanced options

The Settings tab allows you to manage your assistant’s general information, voice interaction mode, session behavior, and advanced webhook integrations.
It also provides tools to duplicate or delete your assistant safely.


General Settings

Assistant Settings Interface

Assistant Name and Description

You can update your assistant’s name and description to help you easily identify its purpose.
For example:

  • Name: "Alexa"
  • Description: “Customer Support Assistant for the website”

Voice Settings

The Voice Settings section lets you define how your assistant detects and processes user speech.

Voice Activation Mode

Choose between two modes depending on your use case:

Auto Silence Detection

  • The assistant automatically detects when the user stops speaking and sends the transcription to the server.
  • After a brief pause (defined by the Silence Duration Threshold), the assistant starts responding.
  • Example: If set to 300 milliseconds, the assistant waits 0.3 seconds after silence before replying.
  • You can increase this threshold if users tend to pause mid-sentence, or decrease it for faster interactions.

Press to Send

  • This mode is ideal when users need more control or time to think between messages.
  • Users can:
    • Set a timer (1–10 seconds) — on the chat interface to automatically sends the speech once the timer ends.
    • Send manually — users can review and edit the transcription before sending it to the assistant.

This mode is particularly useful for interviews, creative work, or scenarios that require careful speech input.


Session Settings

These settings define how long an interaction session stays active.

Session Inactivity Timeout

Specifies how long the session can remain idle before it automatically closes.
Example: If set to 120 seconds, the session ends if the user doesn’t speak for two minutes.

Maximum Session Duration

Defines the total time (in seconds) that a session can remain active before it resets.
Example: If set to 600 seconds, the assistant will automatically end the conversation after 10 minutes.


Secret Keys

Secret Live Key

Used internally to test your assistant in live mode.

Do not share this key

This key grants access to live data and is meant only for your internal testing.

Secret Test Key

Used to test the draft version of your assistant before publishing.
This allows you to preview new settings without affecting the live version.


Advanced Settings

In the Advanced section, you can configure webhooks to send session data to your backend systems.

Webhook Configuration

  • Webhook URL: The destination endpoint for session data.
  • Authorization Header (optional): Use this field to secure your webhook connection.

When configured, Ziddny automatically sends the session transcription and analysis results to your webhook once a session ends.

Webhook requirements

Ensure your webhook endpoint is secure and accepts JSON to receive the data correctly.


Assistant Management

Duplicate Assistant

Use the Duplicate Assistant option to create a copy of your assistant with the same configuration.
This is useful when you want to experiment with changes without affecting the original setup.

Delete Assistant

If you no longer need an assistant, click Delete Assistant.

Permanent deletion

This action is permanent and cannot be undone. All data and configurations will be lost.


Next Steps

After configuring your settings, you can continue to share your assistant with users or embed it into your website.