TPI Integration with Aicross
SMS-Magic offers a third-party API integration feature. When an SMS-Magic customer wants to use his own account at an SMS Provider like Aicross and wants to use the SMS-Magic App on Salesforce, TPI Integration helps.
We use the below API – https://developer.aicross.com/messaging/sms/overview
The following sections talk about how SMS-Magic TPI integration works with Aicross:
Requirements
Before you start TPI integration of Aicross with SMS-Magic, answer the following questions:
- Is MMS enabled on the incoming numbers that you are going to use for different countries?
- Are you going to send messages only in the USA or any other countries as well?
To send a message via TPI integration with Aicross, we need the following:
| API key | : | Your Aicross API key |
| API secret | : | Your Aicross API secret. You can get this via Keybase or send an email to security@screen-magic.com |
| Incoming number | : | This number belongs to Aicross which the customer is going to use |
Aicross portal setup
As a customer, you need to make sure that the following IPs are whitelisted on Aicross portal:
| 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 Aicross 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 SMS-Magic side.
SMS-Magic US Server
| Incoming Messages | https://api.sms-magic.com/v1/sms/incoming/aicross |
| Delivery Receipts | http://delivery.sms-magic.com/reports/aicross |
SMS-Magic EU Server
| Incoming Messages | https://eu.api.sms-magic.com/v1/sms/incoming/aicross |
| Delivery Receipts | http://eu.delivery.sms-magic.com/reports/aicross |
SMS-Magic AUS Server
| Incoming Messages | https://aus-api.sms-magic.com/v1/sms/incoming/aicross |
| Delivery Receipts | https://aus-dlr.sms-magic.com/reports/aicross |