> ## Documentation Index
> Fetch the complete documentation index at: https://docs.get2dial.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Receive text messages

> Receive SMS and MMS sent to your phone numbers in a Get2Dial inbox, by email, or at your own webhook, through your Telnyx account.

Connect your Telnyx messaging account so texts sent to your phone numbers appear in the
**SMS** inbox. You can also email each number's texts to a shared mailbox, or send them to
your own systems with a webhook. Telnyx is the supported messaging account today, and
Get2Dial receives texts only — it doesn't send them.

## Before you start

* The phone numbers you receive texts on are in your workspace — see
  [Add a phone number](https://docs.get2dial.com/voice/phone-numbers.md).
* You have permission to manage phone numbers. Everyone who reads the SMS inbox needs this
  permission too — see [Roles and permissions](https://docs.get2dial.com/account/roles-and-permissions.md).
* In your Telnyx account, each number is assigned to a **Messaging Profile**.
* You have your Telnyx public key, from **Keys & Credentials** → **Public Key** in the
  Telnyx portal. Get2Dial uses it to confirm that each text really comes from your Telnyx
  account.

## Steps

**1. Connect your Telnyx account**

In the left navigation, select **SMS**, then open the **Providers** tab and select
**Connect Telnyx**. Enter a **Name**, paste your Telnyx **Public key**, and select
**Connect**.

**2. Copy the webhook URL**

Get2Dial shows a **Webhook URL** for this connection. Select the copy button next to it.

**3. Send Telnyx texts to Get2Dial**

In the Telnyx portal, go to **Messaging** → **Messaging Profiles** and edit the profile
your numbers are assigned to. Under **Inbound**, set **Send a webhook to this URL** to the
webhook URL you copied, using API version 2, and save.

**4. Mark your numbers as SMS-capable**

In Get2Dial, open the **Numbers** tab on the **SMS** page. For each number you receive
texts on, select **Mark as SMS-capable**. Texts arrive either way; the label keeps your
phone number list accurate.

**5. Forward texts by email (optional)**

On the **Numbers** tab, enter one or more email addresses next to a number, separated by
commas, and select **Save**. Every text to that number is also emailed to those addresses.
Each number takes up to 10 addresses.

> [!WARNING]
>
> Treat the webhook URL as private. If it's exposed, select **New webhook URL** on the
> connection and update Telnyx with the new one — the old URL stops working immediately.

## Verify

Send a text to one of your numbers from any phone.

> [!TIP]
>
> The text appears on the **Inbox** tab within about 15 seconds, and the connection on the
> **Providers** tab shows **Receiving**, with **Last message** updated.

## Read your texts

The **Inbox** tab lists texts newest first. Unread texts are highlighted, and opening one
marks it read. You can search by text or by sender number, show one number's texts, or show
only unread texts. Picture messages (MMS) list their attachments as links. These links are
hosted by Telnyx and expire, so save any attachment you need to keep.

## Common problems

* **Nothing arrives, and the connection shows "Waiting for first message".** Telnyx isn't
  sending texts to Get2Dial. Confirm the webhook URL in your Telnyx Messaging Profile exactly
  matches the one on the connection, and that the number is assigned to that profile.
* **The connection shows "Problem" with "Signature check failed".** The public key doesn't
  match your Telnyx account. Copy it again from **Keys & Credentials** → **Public Key**, paste
  it on the connection, and select **Save**.
* **A text shows "Unknown number".** It was sent to a number that isn't in your workspace.
  Add the number under **Phone numbers**; later texts to it are linked to it and forwarded by
  email as configured.
* **Texts stopped arriving.** Check the connection's switch on the **Providers** tab. Texts
  that arrive while a connection is paused are not kept.

## Next steps

> [card] [Get texts at your own endpoint](https://docs.get2dial.com/developers/webhooks/event-catalog.md)

> [card] [Add a phone number](https://docs.get2dial.com/voice/phone-numbers.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.