Short Message Peer-to-Peer Set-up Guide

SMPP is great for customers that require a high throughput. See Telnyx guidance and requirements Learn more about Short Message Peer-to-Peer Set-up Guide with.

SMPP Overview

The Short Message Peer-to-Peer Protocol is a widely used protocol for SMS delivery and receipt. SMPP is best utilized by customers that require high throughput. The following guide is designed to help you establish an SMPP bind and initiate your SMS campaigns.

This feature is reserved for contracted Telnyx customers only who can commit to $5000 minimum spend per month for a period of 12 months. Please liaise with your account manager or sales rep for assistance on getting set up.

SMPP Hosts

Telnyx provides users a primary SMPP server, which must be connected with over TLS.

SMPP Hosts value table.

In the future, Telnyx will offer both a primary and secondary server. Once available, Telnyx will only guarantee that one of the servers is up at anytime, and it will be highly recommended that customers connect to both in order to avoid service outages.

Username and password

Your username and password will be provided by your Telnyx account manager. You can request one by providing the ID of the Messaging Profile you intend to utilize for SMPP messaging. You can find your Messaging Profile ID by navigating to Messaging, open settings for the messaging profile to be used (Basic, Inbound or Outbound), and the Messaging Profile ID will be at the bottom of the pop-up screen.

Throughput per number

Throughput per number varies by number type.  Messages over Long Code numbers can be delivered at 10 messages per number per minute, while messages over toll-free can be delivered at 1200 message per number per minute.

Binding - Supported PDUs

Telnyx supports the following PDUs

  • bind_transmitter
  • bind_transceiver
  • bind_receiver
  • unbind
  • submit_sm
  • deliver_sm
  • enquire_link

Binding - Required Parameters

  • system_id = Telnyx provided
  • password = Telnyx provided
  • Host = smpp.telnyx.com
  • Port = 2775
  • SSL = yes
  • addr_ton = 1  (International)
  • addr_npi = 1 (ISDN/telephone numbering plan (E163/E164)

Related articles

Receive a Text with the Telnyx Python SDKHere you will find a video guide to using the Telnyx Python SDK to receive a text. See Telnyx guidance and requirements.Send a Text with the Telnyx Python SDKA quick video walking you through using the Telnyx Python SDK to send messages. See Telnyx guidance and requirements.Setting Up a Messaging ProfileHere we will explain how to get SMS ready with Messaging Profiles on Telnyx. See Telnyx guidance and requirements.Toll-Free Opt-Out WordsInsights on Telnyx's opt-out process for toll-free numbers and the keywords involved. See Telnyx guidance and requirements.