To integrate an SMS aggregator into the Marketplace, you need to implement the following improvements:
1. Update the message status callback to include delivery data #
In status hooks for messages with the statuses “Sent to operator” / “Delivered”, always include:
- amount
- currency
- number of message parts
If the message is free or paid with bonuses, you must send a zero amount.
When sending an SMS, the request includes the delivery_callback_url attribute — this is the URL where message statuses must be sent.
Use it to send message status updates. The URL for sending statuses is:https://app.alteg.io/smsprovider/status/callback/{partner_token}
2. Implement the integration activation API during registration in the partner service #
When an Altegio user registers in the partner service, send a hook to Altegio to activate the integration in the user’s branch.
Within this hook, you must send the API_KEY used to send notifications through the partner.
3. Implement the payments API if the user pays a subscription fee (optional) #
If your service has a monthly subscription fee, you also need to send payment data to Altegio for each subscription payment.
Payment transfer documentation
4. Implement the API for sending sender names to Altegio #
When a user purchases a sender name, you must send the list of all sender names available to the user via API to Altegio.
The user will then be able to choose a sender name for sending SMS from the list you provided via API.
