overview.md

Overview

Back to main page - Next section

Table of Contents

• Overview (This section)
• About A2P SMS and SMS Gateways
• Common SMS Gateway documentation - information relevant to most of the interfaces.
• Interface specifications
  • REST API
  • SOAP API
  • HTTP GET API
  • SMTP SMS GW
  • SMPP
  • Management API
  • Value-added services for MO messages
• Library documentation - Each library provides basic "getting started" in each repo (readme.md).
• How to get in touch with us?

Introduction

This documentation describes the functionality of, and explains how to integrate with, the Puzzel SMS Gateway (SMSGW).

The SMSGW is an API that enables your solution(s) to send and receive SMS messages, both single messages and bigger batches of messages using the same API.

To be able to connect to the SMSGW you will need a service configured by Puzzel with sensible defaults and settings for your use case. The service identifiers are serviceid, as well as a username and password. Please contact Puzzel Support (help.puzzel.com) if you want to create an agreement, get a demo account or if you have an active agreement but have not received these credentials.

The SMSGW has three main functionalities with corresponding APIs:

• Sending one or many SMS messages from your system to end-users (MT)
• Receiving SMS messages from end-users to your system (MO)
• Receiving delivery reports to your system for SMS messages sent to end-users (DR)

To send SMS messages to end-users, you need to integrate with one of the APIs via REST (XML, JSON or web form over HTTP POST), Web Service (with corresponding WSDL), email (SMTP), SMPP or via HTTP GET (with query parameters).

Due to the flexibility of the REST / SOAP interfaces, we generally recommend that you choose to integrate with one of these endpoints if possible.

To receive SMS messages (MO) or delivery reports (DR) you need to provide a service endpoint that can receive HTTP GET or POST requests. As an alternative, you can also receive MO messages as email messages (SMTP) or using the SMPP protocol.

High level sequence diagram for basic SMS Gateway operations

Additionally, the Gateway provides a Management API to manage messages. A description of this API is given here.

Abbreviations

Abbreviation	Description
MCC	Mobile Country Code
MNC	Mobile Network Code
SNO	Short Number (e.g. 1960)
TTL	Time To Live
UDH	User Data Header
DCS	Data Coding Scheme
MO	Mobile Originated (incoming messages sent from end users)
MT	Mobile Terminated (outgoing messages sent to end users).
CP	Content Providers (Customers of Puzzel and Puzzel itself)
DR	Delivery Reports (Confirmations from operators that messages have been / not have been received by end-user)
MSISDN	Mobile Station International ISDN Number
SMSGW	Puzzel SMS Gateway
REST	Representational State Transfer (https://en.wikipedia.org/wiki/Representational_state_transfer)
MNO	Mobile Network Operator (e.g. Telenor, Telia)
CPA	Content Provider Access – An agreement with MNOs to be able to use four digit short numbers with billing possibilities.
GAS	Goods And Services – Like CPA only with the possibility to sell physical goods and services.