> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.conversive.ai/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.conversive.ai/_mcp/server.

# TPI Integration with Aerialink

Conversive offers a third-party API integration feature. When a Conversive customer wants to use his own account at an SMS Provider like Aerialink and wants to use the Conversive App on Salesforce, TPI Integration helps.

We use the below API — [https://developer.aerial.com/messaging/sms/overview](https://developer.aerial.com/messaging/sms/overview)

The following sections talk about how Conversive TPI integration works with Aerialink:

## Requirements

Before you start TPI integration of Aerialink with Conversive, answer the following questions:

1. Is MMS enabled on the incoming numbers that you are going to use for different countries?
2. Are you going to send messages only in the USA or any other countries as well?

To send a message via TPI integration with Aerialink, we need the following:

* **API key:** Your Aerialink API key
* **API secret:** Your Aerialink API secret. You can get this via Keybase or send an email to [security@screen-magic.com](mailto:security@screen-magic.com)
* **Incoming number:** This number belongs to Aerialink which the customer is going to use

## Aerialink Portal Setup

As a customer, you need to make sure that the following IPs are whitelisted on the Aerialink portal:

| Region  | For Incoming Traffic                                 | For Outgoing Traffic         |
| ------- | ---------------------------------------------------- | ---------------------------- |
| **US**  | 52.45.55.11, 35.153.214.4, 34.197.38.71, 52.200.2.29 | 52.204.1.222, 3.214.91.12    |
| **EU**  | 52.30.211.105, 63.35.106.12, 34.250.41.120           | 34.255.173.194, 34.248.20.41 |
| **AUS** | 52.65.37.119, 3.105.153.146                          | 13.55.63.172, 54.66.19.186   |

Make sure that the Incoming URL is set up correctly at your Aerialink so that you can receive incoming responses and delivery reports of outgoing SMS sent.

Customers need to set default Webhook URLs to the below URLs so that we receive DLR and incoming SMS at the Conversive side.

### Conversive US Server

* **Incoming Messages:** [https://api.sms-magic.com/v1/sms/incoming/aerial](https://api.sms-magic.com/v1/sms/incoming/aerial)
* **Delivery Receipts:** [http://delivery.sms-magic.com/reports/aerial](http://delivery.sms-magic.com/reports/aerial)

### Conversive EU Server

* **Incoming Messages:** [https://eu.api.sms-magic.com/v1/sms/incoming/aerial](https://eu.api.sms-magic.com/v1/sms/incoming/aerial)
* **Delivery Receipts:** [http://eu.delivery.sms-magic.com/reports/aerial](http://eu.delivery.sms-magic.com/reports/aerial)

### Conversive AUS Server

* **Incoming Messages:** [https://aus-api.sms-magic.com/v1/sms/incoming/aerial](https://aus-api.sms-magic.com/v1/sms/incoming/aerial)
* **Delivery Receipts:** [https://aus-dlr.sms-magic.com/reports/aerial](https://aus-dlr.sms-magic.com/reports/aerial)