Центр допомоги Партнерська Програма та Монетизація Застосунків

Партнерська Програма та Монетизація Застосунків

Платформа SMSBAT пропонує розробникам партнерських застосунків, CRM-систем, модулів для E-commerce та сервісним партнерам можливість заробляти на кожному повідомленні, відправленому через їхні інтеграції.

1. Як Працює Монетизація для Партнерів

Коли ваш застосунок (наприклад, модуль для Shopify, WooCommerce, Bitrix24, Planfix або власна система) здійснює відправку розсилок через SMSBAT, наша система автоматично підраховує всі відвантаження повідомлень, прив’язані до вашого унікального referralGuid.

Переваги партнерської програми:

  1. Унікальний Referral GUID: Кожен партнерський застосунок отримує власну ID-адресу для відправки.
  2. Точний облік трафіку: Усі повідомлення (SMS, Viber, RCS), відправлені через /bat/{referralGuid}/messagelist, обліковуються у вашій партнерській статистиці.
  3. Пасивний прибуток / Комісія: Партнер отримує відсоток (пасивний дохід) від кожного повідомлення, відправленого клієнтами через його інтеграцію.

2. Технічна Інтеграція (API Ендпоінт)

Для відправки розсилок партнерський застосунок передає свій referralGuid у шляху URL запиту. Ендпоінт підтримує як HTTP Basic Authentication, так і авторизацію за допомогою API Ключа (X-Authorization-Key).

Ендпоінт

POST https://restapi.smsbat.com/bat/{referralGuid}/messagelist

Варіант 1: Приклад cURL з HTTP Basic Authentication

curl -i -X POST \
  -H "Content-Type: application/json" \
  -H "Authorization: Basic base64(login:password)" \
  -d '{
    "messages": [
      {
        "from": "Shopillect",
        "to": "380936670003",
        "type": "sms",
        "text": "Текст вашого SMS через партнерський модуль",
        "ttl": "120"
      }
    ]
  }' \
  "https://restapi.smsbat.com/bat/34e19d34-abef-4acd-8c94-bd38c0a543fd/messagelist"

Варіант 2: Приклад cURL з API Ключем (X-Authorization-Key)

curl -i -X POST \
  -H "Content-Type: application/json" \
  -H "X-Authorization-Key: ваш-api-ключ" \
  -d '{
    "messages": [
      {
        "from": "Shopillect",
        "to": "380936670003",
        "type": "sms",
        "text": "Текст вашого SMS через партнерський модуль",
        "ttl": "120"
      }
    ]
  }' \
  "https://restapi.smsbat.com/bat/34e19d34-abef-4acd-8c94-bd38c0a543fd/messagelist"


---

## 3. Параметри Запиту

| Параметр | Тип | Опис |
|---|---|---|
| `{referralGuid}` | `string (guid)` | Унікальний ідентифікатор партнера в URL шляху |
| `messages` | `array` | Масив об'єктів повідомлень |
| `from` | `string` | Альфа-ім'я відправника |
| `to` | `string` | Номер телефону отримувача у форматі E.164 |
| `type` | `string` | Тип повідомлення (`sms`, `viber_promo`, `viber_trans`, `rcs`, `flashcall`) |
| `text` | `string` | Текст повідомлення |
| `ttl` | `string/int` | Час життя повідомлення (Time-to-Live) в секундах |

---

## 4. Як Стати Партнером та Почати Заробляти

1. Зареєструйте партнерський акаунт в SMSBAT.
2. Отримайте унікальний **`referralGuid`** для свого застосунку чи інтеграції.
3. Вкажіть у налаштуваннях вашого модуля URL `https://restapi.smsbat.com/bat/{referralGuid}/messagelist`.
4. Відстежуйте обсяги відправленого трафіку та отримуйте партнерські виплати в кабінеті SMSBAT.