# DTMF Event Interception Logic

To build interactive dialer experiences, **Asterisk 2** processes client push-button inputs directly. The runtime parses **Dual-Tone Multi-Frequency (DTMF)** strings to trigger conditional execution scripts.

---

## Input Event Processing Workflow

The flowchart below maps out how interactive tone events drive execution workflows across background services:

```mermaid
graph TD
    %% Source Tone
    subgraph ChannelSource["Active Telephony Session"]
        EventDtmf["ChannelDtmfReceived Event<br/>(Payload: Digit String '1')"]
    end

    %% Verification Engine
    subgraph ParserEngine["C# Input Evaluator"]
        ActionCheck["Check Expected Context State<br/>(Evaluates matching session flow)"]
    end

    %% Logic Branching
    subgraph ExecutionLogic["Conditional Automation Routes"]
        BranchConfirm["Digit == '1'<br/>(Route to Setup Engine)"]
        BranchReject["Digit == '2'<br/>(Route to System Hangup)"]
        BranchRetry["Digit == '*'<br/>(Replay Audio Instruction)"]
    end

    %% Links
    EventDtmf ==>|"Stream Payload"| ActionCheck
    ActionCheck ==>|"Match Key Condition"| BranchConfirm
    ActionCheck -->|"Match Key Condition"| BranchReject
    ActionCheck -->|"Match Key Condition"| BranchRetry

    %% Stylized Curated Themes
    classDef srcToken fill:#0f172a,stroke:#38bdf8,stroke-width:2px,color:#fff,rx:6px,ry:6px;
    classDef engineToken fill:#1e293b,stroke:#a855f7,stroke-width:2px,color:#fff,rx:6px,ry:6px;
    classDef logicToken fill:#312e81,stroke:#ec4899,stroke-width:2px,color:#fff,rx:6px,ry:6px;

    class ChannelSource,EventDtmf srcToken;
    class ParserEngine,ActionCheck engineToken;
    class ExecutionLogic,BranchConfirm,BranchReject,BranchRetry logicToken;
```

---

## Operational Interception Directives

### 1. In-Band Tone Clamping
To prevent external touch-tone key inputs from bleeding back into destination phone channels, operational parameters force audio frame clamping (`dtmf_mode=rfc4733`). This intercepts signaling payloads cleanly at the network stack.

### 2. Multi-Digit Input Buffering
Interactive setups collecting longer authentication variables or customer phone string fields accumulate incoming single digit entries into combined arrays. The logic confirms string delivery when specific termination keys (`#`) trigger validation routines.