Skip to main content

Voice Apps

Voice apps are automated call-handling applications that can answer calls, interact with callers, and perform actions on your behalf. Currently, DialStack supports AI Agent voice apps — intelligent agents that use natural language to converse with callers.

Viewing Voice Apps​

Navigate to Voice Apps from the sidebar. The table shows all voice apps for the selected account, including their name, type, and extension number.

Creating an AI Agent​

  1. Click Add Voice App in the top-right corner.
  2. Enter a Name for the agent (e.g., "Front Desk" or "Appointment Bot").
  3. Assign an Extension Number so the agent can receive calls.
  4. Click Create.

AI Agent Configuration​

Click on any voice app row to open its detail page. The following settings are available:

General​

  • Persona Name — An optional display name the agent uses when introducing itself to callers.
  • Greeting Name — An optional name used in the agent's initial greeting (e.g., "Hi, this is [greeting name], how can I help you?").
  • Instructions — Free-text instructions that guide the agent's behavior and tone during calls. Use this to define the agent's personality, knowledge boundaries, and conversation style.

FAQ​

The FAQ section lets you define question-and-answer pairs the agent can reference during calls. Each entry has a Question and an Answer field. The agent uses these to provide consistent, accurate responses to common inquiries.

  • Click Add FAQ to add a new pair.
  • Click the trash icon on any row to remove it.

Scheduling​

The scheduling section connects your AI agent to an external scheduling system so it can look up customers, check availability, and book appointments on behalf of callers.

Webhook URL​

Provide a webhook URL to enable scheduling. Clear the URL to disable it. The URL must use HTTPS. This is the base URL of your scheduling system's webhook endpoint. DialStack automatically appends the following paths for each operation:

  • /customers/lookup — identifies the caller by phone number
  • /availability/search — fetches available time slots
  • /bookings — confirms and creates an appointment

When a caller asks to schedule, the agent uses these endpoints in sequence: it looks up the customer, retrieves available slots, presents options, and books the selected time.

Webhook Secret​

Tool-call webhooks the agent sends to your application — including the scheduling endpoints above — are signed with a webhook secret so your application can verify the request came from DialStack. The secret is shown on the AI agent's edit page under Webhook secret once the agent has been created.

  • Click the Copy icon to copy the secret to your clipboard, then paste it into your application's settings.
  • Click the Rotate icon to generate a new secret. Rotating immediately invalidates the previous value, so any application still using the old secret will reject incoming tool calls until you update it.

The same secret is also visible from the underlying voice app's edit page and rotates in lockstep — they refer to the same value.

Renaming a Voice App​

Click the voice app name at the top of the detail page to edit it inline. Press Enter or click away to save.

Deleting a Voice App​

Voice apps can be deleted from the account detail page under the Voice Apps section.