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:

1. Ensure that you have valid credentials provided by our support team.

2. Ensure that you have joined the Slack channel setup with your team to assist you with any technical questions you may have during testing.

3. Set up a testing machine or environment on your end.

4. Familiarize yourself with the SMPP protocol and HTTP API concepts if you haven't already.

5. 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

1. Install an SMPP client or library compatible with your system.

2. Configure the SMPP client using the provided configuration details.

3. Connect to the staging SMPP server.

4. Test by sending and receiving SMS messages.

5. Review the sample delivery reports and error messages (if any) for troubleshooting.

6. 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

1. Configure the HTTP client or tool you will use for testing (e.g., Postman, CURL)

2. Set the request headers per the API documentation:

Authorization: Bearer: [Your-Authentication-Key]

Content-Type: application/json

1. For sending, make the necessary POST requests.

2. 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

1. Install an SMTP client or library compatible with your system.

2. Configure the SMTP client using the provided configuration details.

3. Connect to the staging SMTP server.

4. Test by sending and receiving MMS messages.

5. 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

1. Configure the HTTP client or tool you will use for testing (e.g., Postman, CURL)

2. Set the request headers per the API documentation:

Authorization: Bearer: [Your-Authentication-Key]

Content-Type: application/json

1. For sending, make the necessary POST requests.

2. 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:

1. Ensure you're using the correct credentials.

2. Check your network/firewall settings to ensure communication isn't being blocked.

3. Review error logs and messages for clues.

4. 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.