{"id":1426,"date":"2024-12-11T03:05:39","date_gmt":"2024-12-11T03:05:39","guid":{"rendered":"https:\/\/support-landing.altegio.cloud\/support\/6746468657949-how-an-sms-aggregator-can-connect-with-the-altegio-marketplace\/"},"modified":"2025-07-22T09:29:11","modified_gmt":"2025-07-22T09:29:11","password":"","slug":"6746468657949-how-an-sms-aggregator-can-connect-with-the-altegio-marketplace","status":"publish","type":"docs","link":"https:\/\/alteg.io\/en\/support\/knowledge-base\/6746468657949-how-an-sms-aggregator-can-connect-with-the-altegio-marketplace\/","title":{"rendered":"How an SMS aggregator can connect with the Altegio Marketplace"},"content":{"rendered":"<p><span style=\"font-weight: 400;\">To integrate as an SMS aggregator into the marketplace, the following improvements should be made:<\/span><\/p>\n<h2>\n<font>1. <\/font>Refine the hook with message status transfer<\/h2>\n<p><span style=\"font-weight: 400;\">In the hooks on the status of messages with the status <strong>\u201cTransmitted to the operator\u201d\/\u201cDelivered\u201d<\/strong> always send the amount, currency and number of parts of the message. If the message is free or for bonus money, you need to pass a zero amount.<\/span><\/p>\n<p><strong><a href=\"https:\/\/developer.alteg.io\/api#tag\/Sending-SMS-through-operators\/operation\/Getting%20message%20statuses\" target=\"_blank\" rel=\"noopener\">API Documentation<\/a><\/strong><\/p>\n<ul>\n<li style=\"font-weight: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\">When sending SMS, the <strong>delivery_callback_url<\/strong> attribute is passed in the request \u2014 this is the url to which message statuses should be sent.<\/span><\/li>\n<li style=\"font-weight: 400;\" aria-level=\"1\">\n<span style=\"font-weight: 400;\">Use it to send message statuses. Url to which message statuses should be sent \u2014 <\/span><strong><a href=\"https:\/\/app.alteg.io\/smsprovider\/status\/callback\/%7Bpartner_token%7D\" target=\"_blank\" rel=\"noopener\">https:\/\/app.alteg.io\/smsprovider\/status\/callback\/{partner_token}<\/a><\/strong>\n<\/li>\n<\/ul>\n<h2><font>2. Implement the integration activation API when registering in the partner service<\/font><\/h2>\n<p><span style=\"font-weight: 400;\">When registering an Altegio user in the partner service, send to Altegio hook to activate the integration in this user&#8217;s branch. As part of the hook, you must pass the <strong>API_KEY<\/strong>, which is used to send notifications through a partner.<\/span><\/p>\n<p><strong><a href=\"https:\/\/developer.alteg.io\/api#tag\/Marketplace\/operation\/marketplace.notifications.callback_with_settings\" target=\"_blank\" rel=\"noopener\">Hook Documentation<\/a><\/strong><\/p>\n<h2><font>3. Implement the payment API if the user pays a subscription fee (optional)<\/font><\/h2>\n<p><span style=\"font-weight: 400;\">In case the service has a monthly subscription fee, it is also necessary to transfer data with each subscription payment.<\/span><\/p>\n<p><strong><a href=\"https:\/\/developer.alteg.io\/api#tag\/Marketplace\/operation\/marketplace.notifications.callback_with_payment\" target=\"_blank\" rel=\"noopener\">Transfer documentation<\/a><\/strong><\/p>\n<h2><font>4. Implement an API to transfer sender names to Altegio<\/font><\/h2>\n<p><span style=\"font-weight: 400;\">When a user acquires a sender name, it is necessary to transfer a list of all names available to the user via the API to Altegio. The user will be able to select a sender name available to him from the list transmitted via API to send SMS.<\/span><\/p>\n<p><strong><a href=\"https:\/\/developer.alteg.io\/api#tag\/Marketplace\/operation\/marketplace.notifications.set_short_names\" target=\"_blank\" rel=\"noopener\">API Documentation<\/a><\/strong><\/p>\n","protected":false},"excerpt":{"rendered":"<p>To integrate as an SMS aggregator into the marketplace, the following improvements should be made: 1. Refine the hook with message status transfer In the hooks on the status of messages with the status \u201cTransmitted to the operator\u201d\/\u201cDelivered\u201d always send the amount, currency and number of parts of the message. If the message is free&hellip; <a class=\"more-link\" href=\"https:\/\/alteg.io\/en\/support\/knowledge-base\/6746468657949-how-an-sms-aggregator-can-connect-with-the-altegio-marketplace\/\">Continue reading <span class=\"screen-reader-text\">How an SMS aggregator can connect with the Altegio Marketplace<\/span><\/a><\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"closed","template":"","meta":{"footnotes":""},"doc_category":[109],"doc_tag":[2086,2071],"class_list":["post-1426","docs","type-docs","status-publish","hentry","doc_category-placement-in-the-altegio-marketplace","doc_tag-billing-en","doc_tag-integrations-en","entry"],"aioseo_notices":[],"year_month":"2026-04","word_count":262,"total_views":"171","reactions":{"happy":"0","normal":"0","sad":"0"},"author_info":{"name":"ivan.k","author_nicename":"altegio","author_url":"https:\/\/alteg.io\/en\/author\/altegio\/"},"doc_category_info":[{"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":"Billing","term_url":"https:\/\/alteg.io\/en\/support\/knowledge-base\/docs-tag\/billing-en\/"},{"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\/1426","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\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/alteg.io\/en\/support\/wp-json\/wp\/v2\/comments?post=1426"}],"version-history":[{"count":1,"href":"https:\/\/alteg.io\/en\/support\/wp-json\/wp\/v2\/docs\/1426\/revisions"}],"predecessor-version":[{"id":169435,"href":"https:\/\/alteg.io\/en\/support\/wp-json\/wp\/v2\/docs\/1426\/revisions\/169435"}],"wp:attachment":[{"href":"https:\/\/alteg.io\/en\/support\/wp-json\/wp\/v2\/media?parent=1426"}],"wp:term":[{"taxonomy":"doc_category","embeddable":true,"href":"https:\/\/alteg.io\/en\/support\/wp-json\/wp\/v2\/doc_category?post=1426"},{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/alteg.io\/en\/support\/wp-json\/wp\/v2\/doc_tag?post=1426"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}