# Telynx - SMS Notifications & Verifications

## Available To

Free for the following exchange plans:

* **Cloud Plans:**
  * Enterprise
* **On-Premise Plans:**
  * Enterprise Unlimited

## What Is It?

The **Telnyx Plugin** is an SMS gateway integrated into HollaEx exchanges. Powered by [Telnyx](https://telnyx.com), it sends transactional SMS messages from your exchange — deposit/withdrawal notifications and verification codes for actions like withdrawals, password resets, and 2FA — using your Telnyx account and your own sender phone number.

The plugin auto-formats numbers, picks the right routing for each destination country, and integrates directly with the exchange's user verification flow so users who opt in to SMS receive the same codes they would otherwise receive via email or authenticator app.

## Who Needs It?

This plugin is suitable for any HollaEx exchange operator that:

* Wants to send SMS notifications for deposits and withdrawals.
* Wants to offer SMS as a second factor for sensitive actions (withdrawals, password reset).
* Already has a Telnyx account, or prefers Telnyx's pricing/coverage over alternative SMS providers.

## How to Use It?

You can simply install the plugin from the **Plugins** section inside the Operator Control. After installation, input your Telnyx API key and sender number.

#### 1. Get your Telnyx credentials

1. Log in to the [Telnyx Mission Control Portal](https://portal.telnyx.com).
2. Go to **Auth → API Keys** and create a new V2 API key. Copy it somewhere secure.
3. Go to **Numbers → My Numbers** and confirm the sender number you want to use. The number must be in **E.164 format** (e.g. `+15555550123`).
4. Make sure the number has the **Messaging** profile enabled.

#### 2. Configure the plugin

Open the plugin in the Operator Control and set the following fields:

| Field                        | Required | Default | Description                                                                                               |
| ---------------------------- | -------- | ------- | --------------------------------------------------------------------------------------------------------- |
| `apiKey`                     | **yes**  | —       | Telnyx V2 API key.                                                                                        |
| `fromNumber`                 | **yes**  | —       | Telnyx sender phone number in E.164 format (e.g. `+15555550123`).                                         |
| `send_sms_deposit`           | no       | `true`  | Send deposit SMS notifications to users.                                                                  |
| `send_sms_withdrawal`        | no       | `true`  | Send withdrawal SMS notifications to users.                                                               |
| `send_sms_user_verification` | no       | `true`  | Send user-action verification codes (e.g. withdrawal, password reset) via SMS when the user has opted in. |

Once configured, the exchange will automatically route SMS through Telnyx for any user who has a verified phone number and has opted in to SMS notifications.

***

## **Benefits for HollaEx Operators**

The Telnyx plugin gives exchange operators a reliable, low-cost SMS channel for both transactional alerts and security-critical verification codes. Telnyx's global coverage and direct carrier connections deliver predictable latency and high throughput, so users get their codes in seconds even during peak load. Combined with the exchange's existing email and authenticator-app channels, SMS rounds out a multi-factor security posture that meets users wherever they are.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.hollaex.com/plugins/use-plugins/telynx-sms-notifications-and-verifications.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.