How an SMS aggregator can get into the Altegio Marketplace

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.

API documentation

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.

Hook documentation

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.

API documentation