Skip to content
EN
Open app

For AI assistants: this page as plain markdown is at https://docs.voicelogica.ai/raw/workflows/keyword-pressed.md, and https://docs.voicelogica.ai/llms.txt lists the docs by topic, one file each, small enough to read whole. Read those rather than this HTML page.

On Key Pressed

2 min read
Copy as Markdown
View as MarkdownOpen the raw .md file.md

On Key Pressed fires when the caller finishes a keypad run (Runs when: When caller presses a key) - usually after the end key on Call handling - Advanced or when the wait expires. Digits are available to later nodes as the key-pressed / DTMF input variable.

The agent’s Phone keypad input settings decide when a run is complete. The trigger panel itself is light:

Enable Message Creation
When enabled, the AI speaks a message to the caller before executing this workflow.
On Key Pressed trigger on the canvas
wf-dtmfExpand
On Key Pressed Enable Message Creation
keyword-pressed-formExpand

Order ids, account numbers, menu digits. Speech is sloppy for long numbers - Skip Turn plus this trigger is the usual pair.

  1. On the agent, Call handling - Advanced - Phone keypad input - wait long enough for the id, end key # unless your IVR already uses another key.
  2. + Add Trigger - On Key Pressed.
  3. Connect To External Service - pass the DTMF input into the URL or body.
  4. AI Response to Caller on success (and a failure path if useful).
  5. Save & go live, attach. Prompt the agent to ask them to type the id then #. Call, type, listen.
Why does my On Key Pressed workflow send only three digits of a ten-digit ID to the API?

The keypad run ended before the caller finished typing. Raise the keypad wait in the agent’s Call handling - Advanced - Phone keypad input, and have the agent ask callers to press # at the end. Also confirm Skip Turn is on.

Why use On Key Pressed instead of During Call to collect a number?

With During Call the model has to hear the number, and speech is unreliable for long numbers. On Key Pressed reads the digits typed on the keypad. Use During Call only when callers will say the ID rather than type it.