Staging Environment Access
Describes how to access our staging environment for testing.
Introduction
This document outlines the steps customers should take to onboard onto our staging environment, focusing on connecting using SMPP/SMTP and HTTP API protocols for both SMS and MMS messaging.
Disclaimers
Please be advised that you will be connecting to an active staging/testing environment hosted by TSG Global. There will be changes actively pushed to our staging environment that may occasionally break some features without warning. Additionally, to control costs, we do not scale our staging environment to the same degree as our production environment, so throughput may occasionally become an issue. We will work closely with your testing team in a dedicated Slack channel to ensure you have a robust testing experience that you are happy with prior to migrating to production.
Prerequisites
Before connecting to our staging environment:
Ensure that you have valid credentials provided by our support team.
Ensure that you have joined the Slack channel setup with your team to assist you with any technical questions you may have during testing.
Set up a testing machine or environment on your end.
Familiarize yourself with the SMPP protocol and HTTP API concepts if you haven't already.
Review the TSG Global API documents located at: https://docs.tsgglobal.com
SMS via SMPP
Configuration Details
SMPP Host: smsc.staging.tsgglobal.com
SMPP Port: 2775 for TCP or 2776 for TLS connections
Bind type: Transceiver
System ID: Provided by our support team.
Password: Provided by our support team.
Steps to Connect
Install an SMPP client or library compatible with your system.
Configure the SMPP client using the provided configuration details.
Connect to the staging SMPP server.
Test by sending and receiving SMS messages.
Review the sample delivery reports and error messages (if any) for troubleshooting.
For any additional information please refer to https://docs.tsgglobal.com/api-reference/programmable-sms/smpp
Sending SMS via HTTP API
Endpoint Information
Base URL: https://sms-api.staging.tsgglobal.com
Endpoint: See API documentation here: https://docs.tsgglobal.com/api-reference/programmable-sms/send-an-sms-message
Authentication Key: Provided by our support team.
Steps to Connect
Configure the HTTP client or tool you will use for testing (e.g., Postman, CURL)
Set the request headers per the API documentation:
Authorization: Bearer: [Your-Authentication-Key]
Content-Type: application/json
For sending, make the necessary POST requests.
Review the API response for any errors and to ensure successful delivery.
Receiving SMS via HTTP webhook
To receive SMS message via webhook please provide your webhook URL according to the docs provided at: https://docs.tsgglobal.com/api-reference/programmable-sms/receive-an-sms-message
MMS via SMTP
Configuration Details
SMPP Host: smtp.staging.tsgglobal.com
SMPP Port: 2775 for TCP or 2776 for TLS connections
Bind type: Transceiver
System ID: Provided by our support team.
Password: Provided by our support team.
Steps to Connect
Install an SMTP client or library compatible with your system.
Configure the SMTP client using the provided configuration details.
Connect to the staging SMTP server.
Test by sending and receiving MMS messages.
Review the sample delivery reports and error messages (if any) for troubleshooting.
For any additional information please refer to: https://docs.tsgglobal.com/api-reference/programmable-mms/smtp
Sending MMS via HTTP API
Endpoint Information
Base URL: https://mms-api.staging.tsgglobal.com
Endpoint: See API documentation here:
https://docs.tsgglobal.com/api-reference/programmable-mms/send-an-mms-message
Authentication Key: Provided by our support team.
Steps to Connect
Configure the HTTP client or tool you will use for testing (e.g., Postman, CURL)
Set the request headers per the API documentation:
Authorization: Bearer: [Your-Authentication-Key]
Content-Type: application/json
For sending, make the necessary POST requests.
Review the API response for any errors and to ensure successful delivery.
Receiving MMS via HTTP webhook
To receive SMS message via webhook please provide your webhook URL according to the docs provided at: https://docs.tsgglobal.com/api-reference/programmable-mms/receive-an-mms-message
Troubleshooting
Below are some frequently encountered issues that may assist:
Ensure you're using the correct credentials.
Check your network/firewall settings to ensure communication isn't being blocked.
Review error logs and messages for clues.
Reach out to our support team with detailed error messages for assistance.
Conclusion
After successful testing on the staging environment, inform our support team so that they can assist you with transitioning to the production environment.
Last updated