{"id":268438,"date":"2026-02-03T09:55:56","date_gmt":"2026-02-03T09:55:56","guid":{"rendered":"https:\/\/support-landing.altegio.cloud\/support\/?post_type=docs&#038;p=268438"},"modified":"2026-02-03T09:56:01","modified_gmt":"2026-02-03T09:56:01","password":"","slug":"6746468657949","status":"publish","type":"docs","link":"https:\/\/alteg.io\/en\/support\/knowledge-base\/6746468657949\/","title":{"rendered":"How an SMS aggregator can get into the Altegio Marketplace"},"content":{"rendered":"\n<p>To integrate an SMS aggregator into the Marketplace, you need to implement the following improvements:<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">1. Update the message status callback to include delivery data<\/h2>\n\n\n\n<p>In status hooks for messages with the statuses <strong>\u201cSent to operator\u201d<\/strong> \/ <strong>\u201cDelivered\u201d<\/strong>, always include:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>amount<\/li>\n\n\n\n<li>currency<\/li>\n\n\n\n<li>number of message parts<\/li>\n<\/ul>\n\n\n\n<p>If the message is free or paid with bonuses, you must send a <strong>zero amount<\/strong>.<\/p>\n\n\n\n<p><strong><a href=\"https:\/\/developer.alteg.io\/en#tag\/Sending-SMS-through-operators\/operation\/Getting%20message%20statuses\">API documentation<\/a><\/strong><\/p>\n\n\n\n<p>When sending an SMS, the request includes the <code>delivery_callback_url<\/code> attribute \u2014 this is the URL where message statuses must be sent.<\/p>\n\n\n\n<p>Use it to send message status updates. The URL for sending statuses is:<br><code><a href=\"https:\/\/app.alteg.io\/smsprovider\/status\/callback\/{partner_token}\">https:\/\/app.alteg.io\/smsprovider\/status\/callback\/{partner_token}<\/a><\/code><\/p>\n\n\n\n<h2 class=\"wp-block-heading\">2. Implement the integration activation API during registration in the partner service<\/h2>\n\n\n\n<p>When an Altegio user registers in the partner service, send a hook to Altegio to activate the integration in the user\u2019s branch.<\/p>\n\n\n\n<p>Within this hook, you must send the <code>API_KEY<\/code> used to send notifications through the partner.<\/p>\n\n\n\n<p><strong><a href=\"https:\/\/developer.alteg.io\/en#tag\/Marketplace\/operation\/marketplace.notifications.callback_with_settings\">Hook documentation<\/a><\/strong><\/p>\n\n\n\n<h2 class=\"wp-block-heading\">3. Implement the payments API if the user pays a subscription fee (optional)<\/h2>\n\n\n\n<p>If your service has a monthly subscription fee, you also need to send payment data to Altegio <strong>for each subscription payment<\/strong>.<\/p>\n\n\n\n<p><strong><a href=\"https:\/\/developer.alteg.io\/en#tag\/Marketplace\/operation\/marketplace.notifications.callback_with_payment\">Payment transfer documentation<\/a><\/strong><\/p>\n\n\n\n<h2 class=\"wp-block-heading\">4. Implement the API for sending sender names to Altegio<\/h2>\n\n\n\n<p>When a user purchases a sender name, you must send the list of all sender names available to the user via API to Altegio.<\/p>\n\n\n\n<p>The user will then be able to choose a sender name for sending SMS from the list you provided via API.<\/p>\n\n\n\n<p><strong><a href=\"https:\/\/developer.alteg.io\/en#tag\/Marketplace\/operation\/marketplace.notifications.set_short_names\">API documentation<\/a><\/strong><\/p>\n","protected":false},"excerpt":{"rendered":"<p>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 \u201cSent to operator\u201d \/ \u201cDelivered\u201d, always include: If the message is free or paid with bonuses, you must send a zero amount.&hellip; <a class=\"more-link\" href=\"https:\/\/alteg.io\/en\/support\/knowledge-base\/6746468657949\/\">Continue reading <span class=\"screen-reader-text\">How an SMS aggregator can get into the Altegio Marketplace<\/span><\/a><\/p>\n","protected":false},"author":44,"featured_media":0,"comment_status":"open","ping_status":"closed","template":"","meta":{"footnotes":""},"doc_category":[108,109],"doc_tag":[2071],"class_list":["post-268438","docs","type-docs","status-publish","hentry","doc_category-integration-marketplace","doc_category-placement-in-the-altegio-marketplace","doc_tag-integrations-en","entry"],"aioseo_notices":[],"year_month":"2026-04","word_count":249,"total_views":"63","reactions":{"happy":"0","normal":"0","sad":"0"},"author_info":{"name":"lilit.m@alteg.io","author_nicename":"lilit-malteg-io","author_url":"https:\/\/alteg.io\/en\/author\/lilit-malteg-io\/"},"doc_category_info":[{"term_name":"Integration Marketplace","term_url":"https:\/\/alteg.io\/en\/support\/knowledge-base\/categories\/integration-marketplace\/"},{"term_name":"Placement in the Altegio Marketplace","term_url":"https:\/\/alteg.io\/en\/support\/knowledge-base\/categories\/placement-in-the-altegio-marketplace\/"}],"doc_tag_info":[{"term_name":"Integrations","term_url":"https:\/\/alteg.io\/en\/support\/knowledge-base\/docs-tag\/integrations-en\/"}],"knowledge_base_info":[],"knowledge_base_slug":[],"_links":{"self":[{"href":"https:\/\/alteg.io\/en\/support\/wp-json\/wp\/v2\/docs\/268438","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/alteg.io\/en\/support\/wp-json\/wp\/v2\/docs"}],"about":[{"href":"https:\/\/alteg.io\/en\/support\/wp-json\/wp\/v2\/types\/docs"}],"author":[{"embeddable":true,"href":"https:\/\/alteg.io\/en\/support\/wp-json\/wp\/v2\/users\/44"}],"replies":[{"embeddable":true,"href":"https:\/\/alteg.io\/en\/support\/wp-json\/wp\/v2\/comments?post=268438"}],"version-history":[{"count":2,"href":"https:\/\/alteg.io\/en\/support\/wp-json\/wp\/v2\/docs\/268438\/revisions"}],"predecessor-version":[{"id":268444,"href":"https:\/\/alteg.io\/en\/support\/wp-json\/wp\/v2\/docs\/268438\/revisions\/268444"}],"wp:attachment":[{"href":"https:\/\/alteg.io\/en\/support\/wp-json\/wp\/v2\/media?parent=268438"}],"wp:term":[{"taxonomy":"doc_category","embeddable":true,"href":"https:\/\/alteg.io\/en\/support\/wp-json\/wp\/v2\/doc_category?post=268438"},{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/alteg.io\/en\/support\/wp-json\/wp\/v2\/doc_tag?post=268438"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}