> Fetch clean Markdown by appending `.md` to any page URL under https://signalwire.com/docs or requesting it with the HTTP header `Accept: text/markdown`. The root index at https://signalwire.com/docs/llms.txt lists the available documentation indexes.

# bindDigit

> Bind a DTMF digit sequence to trigger a Relay method.

[clear-digit-bindings]: /docs/server-sdks/reference/typescript/relay/call/clear-digit-bindings

Bind a DTMF digit sequence to automatically trigger a Relay method when the
caller presses those digits. This enables in-call DTMF shortcuts without
requiring an active collect operation.

> **Info**
>
> Use [`clearDigitBindings()`][clear-digit-bindings] to remove bindings.

## **Parameters**

**`digits`** `string` — required

The DTMF digit sequence to bind (e.g., `"*1"`, `"##"`).

---

**`bindMethod`** `string` — required

The Relay calling method to execute when the digit sequence is detected
(e.g., `"calling.transfer"`, `"calling.play"`).

---

**`bindParams`** `Record<string, unknown> | undefined`

Parameters to pass to the bound method when triggered.

---

**`realm`** `string | undefined`

A namespace for grouping digit bindings. Useful for selectively clearing
bindings by realm.

---

**`maxTriggers`** `number | undefined`

Maximum number of times this binding can be triggered. After reaching
the limit, the binding is automatically removed.

---

## **Returns**

`Promise<Record<string, unknown>>` -- Server response confirming the binding.

## **Example**

```typescript {13}
import { RelayClient } from '@signalwire/sdk';

const client = new RelayClient({
  project: process.env.SIGNALWIRE_PROJECT_ID!,
  token: process.env.SIGNALWIRE_API_TOKEN!,
  contexts: ['default']
});

client.onCall(async (call) => {
  await call.answer();

  // Bind *0 to transfer to an operator
  const result = await call.bindDigit('*0', 'calling.transfer', {
    bindParams: { dest: 'operator' },
    realm: 'shortcuts',
  });
  console.log(`Digit binding created: ${JSON.stringify(result)}`);

  // Bind *9 to play a help message
  await call.bindDigit('*9', 'calling.play', {
    bindParams: { play: [{ type: 'tts', text: 'Press star-zero for an operator.' }] },
    realm: 'shortcuts',
  });
});

await client.run();
```

> Bind a DTMF digit sequence to trigger a Relay method.