---
title: Inbound Messages – Message Relays
description: All inbound messages to be relayed to clients are sent via HTTP POST. Clients must supply a URL for these messages. The service supports up to TLS 1.2.
---
[Skip to content](https://knowledgebase.phonovation.com/inbound-messages-message-relays#main-content)
[More support](https://knowledgebase.phonovation.com/kb-tickets/new?hsLang=en)
[-1.png?width=300&height=50&name=Phonovation%20Logo%20(1)-1.png)](https://www.phonovation.com/)
- [Phonovation](https://www.phonovation.com/)
- [Knowledgebase](https://knowledgebase.phonovation.com/)
- [Developer Portal](https://developers.phonovation.com/)
Open main navigation
Close main navigation
- [Phonovation](https://www.phonovation.com/)
- [Knowledgebase](https://knowledgebase.phonovation.com/)
- [Developer Portal](https://developers.phonovation.com/)
- [More support](https://knowledgebase.phonovation.com/kb-tickets/new)
How can we help you?
- There are no suggestions because the search field is empty.
1. [Phonovation Knowledge Base](https://knowledgebase.phonovation.com/?hsLang=en)
2. [Phonovation API](https://knowledgebase.phonovation.com/phonovation-api?hsLang=en)
3. [Inbound/Incoming Messages](https://knowledgebase.phonovation.com/phonovation-api?hsLang=en#inbound-incoming-messages)
January 20, 2026
# Inbound Messages – Message Relays
## All inbound messages to be relayed to clients are sent via HTTP POST. Clients must supply a URL for these messages. The service supports up to TLS 1.2.
### Examples of Relays:
- Keyword sent to a shared shortcode (e.g., text ‘YourCompany’ to 51000)
- Messages to a dedicated shortcode
- Messages to a dedicated longcode
***Note: Some relay configurations may incur additional setup and rental costs. Contact your Phonovation account manager for pricing details.***
| **Parameter Name** | **Value Example ** | **Comment** |
| --- | --- | --- |
| SMS-Type | Text | Will always equal this value |
| SMS-Content | HelloWorld | Full content of text message from caller currently ranging from 1-160 characters |
| SMS-Keyphrase | service1 | The service keyword, (The first word of the message). This can be used by the client to process specific campaigns |
| SMS-Network | 272/1 | The network code (MCC/MNC see below) |
| SMS-From | 353871111111 | The Recipients mobile number in GSM format. The mobile number that is replying to the message. |
| SMS-To | 353877777777 | Original Senders reply mobile number in GSM format. |
| SMS-TimeStamp | 2024-01-10 14:30:00 | Time received by the gateway |
| SMS-Verify | 9db038748b3088971 d913616c13e769b | Encrypted authentication. MD5 value, made up of (NotifyID + SMS-Success + Password) |
### Notes:
1. **SMS-Type:** Always equals 'Text'.
2. **SMS-Network:** The network code consists of MCC/MNC values. For messages received from the Phonovation gateway, MCC will always be 272 (Ireland) and MNC will vary (e.g., 1 for Vodafone, 2 for O2, 3 for Meteor), resulting in codes like 272/1, 272/2, or 272/3.
By configuring these parameters, clients can effectively receive inbound message relays via the Phonovation Gateway API.
### Example: Inbound Messages – Message Relays:
```
SMS-Type=TextSMS-Content=HelloWorldSMS-Keyphrase=TestMsgSMS-Network=272/1SMS-From=353871111111SMS-To=353877777777SMS-Timestamp=2012-01-10 14:30:00SMS-Verify=9db038748b3088971d913616c13e769b
```
***NOTE: You will be required to URL encode the HTTP Request as some characters may cause Issues. ***
### Incoming Message's Flow:
- [User Guides](https://knowledgebase.phonovation.com/user-guides?hsLang=en#main-content)
- [Glossary](https://knowledgebase.phonovation.com/user-guides?hsLang=en#glossary)
- [Technical Specifications](https://knowledgebase.phonovation.com/user-guides?hsLang=en#technical-specifications)
- [Support](https://knowledgebase.phonovation.com/user-guides?hsLang=en#support)
- [Account](https://knowledgebase.phonovation.com/user-guides?hsLang=en#account)
- [Dashboard and UI](https://knowledgebase.phonovation.com/user-guides?hsLang=en#dashboard-and-ui)
- [FAQ](https://knowledgebase.phonovation.com/user-guides?hsLang=en#faq)
- [Phonovation API](https://knowledgebase.phonovation.com/phonovation-api?hsLang=en#main-content)
- [Guide](https://knowledgebase.phonovation.com/phonovation-api?hsLang=en#guide)
- [Inbound/Incoming Messages](https://knowledgebase.phonovation.com/phonovation-api?hsLang=en#inbound-incoming-messages)
- [Delivery Receipts / DLR's](https://knowledgebase.phonovation.com/phonovation-api?hsLang=en#delivery-receipts-dlrs)
- [Outbound Messages](https://knowledgebase.phonovation.com/phonovation-api?hsLang=en#outbound-messages)
- [Campaign setup's](https://knowledgebase.phonovation.com/campaign-setups?hsLang=en#main-content)
- [Setup](https://knowledgebase.phonovation.com/campaign-setups?hsLang=en#setup)
- [Campaign Management](https://knowledgebase.phonovation.com/campaign-management?hsLang=en#main-content)
- [Reports](https://knowledgebase.phonovation.com/campaign-management?hsLang=en#reports)
- [Lists (contacts)](https://knowledgebase.phonovation.com/campaign-management?hsLang=en#lists-contacts)
- [Templates](https://knowledgebase.phonovation.com/campaign-management?hsLang=en#templates)
- [Opt Outs](https://knowledgebase.phonovation.com/campaign-management?hsLang=en#opt-outs)
- [Mobile Lookup](https://knowledgebase.phonovation.com/campaign-management?hsLang=en#mobile-lookup)
- [Billing and Costs](https://knowledgebase.phonovation.com/billing-and-costs?hsLang=en#main-content)
- [Pricing](https://knowledgebase.phonovation.com/billing-and-costs?hsLang=en#pricing)
- [Payment Methods](https://knowledgebase.phonovation.com/billing-and-costs?hsLang=en#payment-methods)
- [Support and Service](https://knowledgebase.phonovation.com/support-and-service?hsLang=en#main-content)
- [Support / ServiceDesk](https://knowledgebase.phonovation.com/support-and-service?hsLang=en#support-servicedesk)
- [Features](https://knowledgebase.phonovation.com/features?hsLang=en#main-content)
- [Smart Tags](https://knowledgebase.phonovation.com/features?hsLang=en#smart-tags)
- [SenderID's](https://knowledgebase.phonovation.com/senderids?hsLang=en)
- [HubSpot](https://knowledgebase.phonovation.com/hubspot?hsLang=en#main-content)
- [Get Started](https://knowledgebase.phonovation.com/hubspot?hsLang=en#get-started)
- [Workflow Actions](https://knowledgebase.phonovation.com/hubspot?hsLang=en#workflow-actions)
- [Contact Card](https://knowledgebase.phonovation.com/hubspot?hsLang=en#contact-card)
- [Campaigns](https://knowledgebase.phonovation.com/hubspot?hsLang=en#campaigns)
- [Timeline Activity](https://knowledgebase.phonovation.com/hubspot?hsLang=en#timeline-activity)
- [WhatsApp](https://knowledgebase.phonovation.com/whatsapp?hsLang=en#main-content)
- [FAQ](https://knowledgebase.phonovation.com/whatsapp?hsLang=en#faq)
[](https://www.phonovation.com/)
**Phonovation Ltd.** Frascati Hall | Sweetman’s Avenue | Blackrock | Co. Dublin | A94 F9N7 | Ireland
[mailto:support@phonovation.com](mailto:support@phonovation.com)
Copyright © 2025, Phonovation Ltd.