# Staging Environment Access

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

{% hint style="warning" %}

## 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.
{% endhint %}

## 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>

<br>

## 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

3. For sending, make the necessary POST requests.
4. Review the API response for any errors and to ensure successful delivery.

<br>

## 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>

<br>

## 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

7. Install an SMTP client or library compatible with your system.
8. Configure the SMTP client using the provided configuration details.
9. Connect to the staging SMTP server.
10. Test by sending and receiving MMS messages.
11. Review the sample delivery reports and error messages (if any) for troubleshooting.

<br>

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:&#x20;

<https://docs.tsgglobal.com/api-reference/programmable-mms/send-an-mms-message>

Authentication Key: Provided by our support team.

### Steps to Connect

5. Configure the HTTP client or tool you will use for testing (e.g., Postman, CURL)
6. Set the request headers per the API documentation:

Authorization: Bearer: \[Your-Authentication-Key]

Content-Type: application/json

7. For sending, make the necessary POST requests.
8. Review the API response for any errors and to ensure successful delivery.

<br>

## 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.&#x20;

<br>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.tsgglobal.com/staging-environment-access.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.