Інструменти MCP-конектора

Конектор https://mcp.alphasms.ua/mcp віддає асистенту 11 інструментів. Інструменти читання виконуються одразу; інструменти надсилання вимагають confirm: true — без нього конектор відповідає відмовою і до API не звертається.

Кожен виклик — JSON-RPC методом POST, ключ у заголовку Authorization. Коди, які повертає message_status, збігаються зі звичайним API — див. Статуси повідомлень.

Читання

balance

Залишок на рахунку та валюта.

Параметри

Параметрів немає.

Приклад запиту

JSON-RPC

{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
        "name": "balance",
        "arguments": {}
    }
}

cURL

curl -X POST 'https://mcp.alphasms.ua/mcp' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer ВАШ_API_КЛЮЧ' \
  --data-raw '{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "balance",
    "arguments": {}
  }
}'

Python

import requests

response = requests.post(
    "https://mcp.alphasms.ua/mcp",
    headers={"Authorization": "Bearer ВАШ_API_КЛЮЧ"},
    json={
        "jsonrpc": "2.0",
        "id": 1,
        "method": "tools/call",
        "params": {
            "name": "balance",
            "arguments": {}
        }
    },
    timeout=30,
)

print(response.json())

Node.js

const response = await fetch("https://mcp.alphasms.ua/mcp", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    Authorization: "Bearer ВАШ_API_КЛЮЧ",
  },
  body: JSON.stringify({
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "balance",
      "arguments": {}
    }
  }),
});

console.log(await response.json());

senders_list

Зареєстровані імена відправника зі статусом кожного. Надсилати можна лише з активного імені.

Параметри

Параметрів немає.

Приклад запиту

JSON-RPC

{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
        "name": "senders_list",
        "arguments": {}
    }
}

cURL

curl -X POST 'https://mcp.alphasms.ua/mcp' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer ВАШ_API_КЛЮЧ' \
  --data-raw '{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "senders_list",
    "arguments": {}
  }
}'

Python

import requests

response = requests.post(
    "https://mcp.alphasms.ua/mcp",
    headers={"Authorization": "Bearer ВАШ_API_КЛЮЧ"},
    json={
        "jsonrpc": "2.0",
        "id": 1,
        "method": "tools/call",
        "params": {
            "name": "senders_list",
            "arguments": {}
        }
    },
    timeout=30,
)

print(response.json())

Node.js

const response = await fetch("https://mcp.alphasms.ua/mcp", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    Authorization: "Bearer ВАШ_API_КЛЮЧ",
  },
  body: JSON.stringify({
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "senders_list",
      "arguments": {}
    }
  }),
});

console.log(await response.json());

message_status

Статус надісланого повідомлення. Повертає числовий код і розшифрування.

Параметри

idчислообов'язковий Ідентифікатор, під яким повідомлення надсилалося

Приклад запиту

JSON-RPC

{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
        "name": "message_status",
        "arguments": {
            "id": 1730112045
        }
    }
}

cURL

curl -X POST 'https://mcp.alphasms.ua/mcp' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer ВАШ_API_КЛЮЧ' \
  --data-raw '{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "message_status",
    "arguments": {
      "id": 1730112045
    }
  }
}'

Python

import requests

response = requests.post(
    "https://mcp.alphasms.ua/mcp",
    headers={"Authorization": "Bearer ВАШ_API_КЛЮЧ"},
    json={
        "jsonrpc": "2.0",
        "id": 1,
        "method": "tools/call",
        "params": {
            "name": "message_status",
            "arguments": {
                "id": 1730112045
            }
        }
    },
    timeout=30,
)

print(response.json())

Node.js

const response = await fetch("https://mcp.alphasms.ua/mcp", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    Authorization: "Bearer ВАШ_API_КЛЮЧ",
  },
  body: JSON.stringify({
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "message_status",
      "arguments": {
        "id": 1730112045
      }
    }
  }),
});

console.log(await response.json());

hlr_lookup

HLR-запит: чи існує номер, у якій він мережі, чи не перенесений до іншого оператора. Послуга платна — один запит на номер.

Параметри

phoneрядокобов'язковий Номер у міжнародному форматі, лише цифри, без ведучого нуля: 380671234567

idчисло Ваш ідентифікатор запиту

Приклад запиту

JSON-RPC

{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
        "name": "hlr_lookup",
        "arguments": {
            "phone": 380671234567
        }
    }
}

cURL

curl -X POST 'https://mcp.alphasms.ua/mcp' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer ВАШ_API_КЛЮЧ' \
  --data-raw '{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "hlr_lookup",
    "arguments": {
      "phone": 380671234567
    }
  }
}'

Python

import requests

response = requests.post(
    "https://mcp.alphasms.ua/mcp",
    headers={"Authorization": "Bearer ВАШ_API_КЛЮЧ"},
    json={
        "jsonrpc": "2.0",
        "id": 1,
        "method": "tools/call",
        "params": {
            "name": "hlr_lookup",
            "arguments": {
                "phone": 380671234567
            }
        }
    },
    timeout=30,
)

print(response.json())

Node.js

const response = await fetch("https://mcp.alphasms.ua/mcp", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    Authorization: "Bearer ВАШ_API_КЛЮЧ",
  },
  body: JSON.stringify({
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "hlr_lookup",
      "arguments": {
        "phone": 380671234567
      }
    }
  }),
});

console.log(await response.json());

Надсилання

Спільне для всіх надсилань

confirm: true обов'язковий. Один виклик — один номер, масових розсилок немає. phone — лише цифри в міжнародному форматі, ім'я відправника має бути зареєстроване й активне. У відповіді приходить ідентифікатор, а не факт доставки: статус питайте через message_status.

send_sms

Одне SMS на один номер. 160 символів латиницею або 70 кирилицею в першому повідомленні, далі ділиться на частини, кожна тарифікується окремо.

Параметри

phoneрядокобов'язковий Номер отримувача

signatureрядокобов'язковий Зареєстроване ім'я відправника

messageрядокобов'язковий Текст повідомлення

confirmбулевеобов'язковий Обов'язково true. Без нього конектор відповідає відмовою і до API не звертається

lifetimeчисло Строк життя повідомлення в секундах

short_linkбулеве Скорочувати й відстежувати посилання, за тарифом

unsubscribe_linkбулеве Додати посилання відписки, за тарифом

idчисло Ваш ідентифікатор повідомлення. Якщо не заданий, конектор згенерує його сам і поверне у відповіді — інакше повідомлення стане невідстежуваним

hookрядок URL, куди платформа надішле статус доставки

Приклад запиту

JSON-RPC

{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
        "name": "send_sms",
        "arguments": {
            "phone": "380671234567",
            "signature": "ALPHASMS",
            "message": "Ваш код 1234",
            "confirm": true
        }
    }
}

cURL

curl -X POST 'https://mcp.alphasms.ua/mcp' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer ВАШ_API_КЛЮЧ' \
  --data-raw '{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "send_sms",
    "arguments": {
      "phone": "380671234567",
      "signature": "ALPHASMS",
      "message": "Ваш код 1234",
      "confirm": true
    }
  }
}'

Python

import requests

response = requests.post(
    "https://mcp.alphasms.ua/mcp",
    headers={"Authorization": "Bearer ВАШ_API_КЛЮЧ"},
    json={
        "jsonrpc": "2.0",
        "id": 1,
        "method": "tools/call",
        "params": {
            "name": "send_sms",
            "arguments": {
                "phone": "380671234567",
                "signature": "ALPHASMS",
                "message": "Ваш код 1234",
                "confirm": true
            }
        }
    },
    timeout=30,
)

print(response.json())

Node.js

const response = await fetch("https://mcp.alphasms.ua/mcp", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    Authorization: "Bearer ВАШ_API_КЛЮЧ",
  },
  body: JSON.stringify({
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "send_sms",
      "arguments": {
        "phone": "380671234567",
        "signature": "ALPHASMS",
        "message": "Ваш код 1234",
        "confirm": true
      }
    }
  }),
});

console.log(await response.json());

send_viber

Одне повідомлення у Viber. Тип конектор збирає сам за переданими полями: текст, текст із картинкою або текст із картинкою і кнопкою.

Параметри

phoneрядокобов'язковий Номер отримувача

signatureрядокобов'язковий Ім'я відправника у Viber

messageрядокобов'язковий Текст, до 1000 символів

confirmбулевеобов'язковий Обов'язково true. Без нього конектор відповідає відмовою і до API не звертається

imageрядок URL картинки

linkрядок URL переходу за кнопкою

buttonрядок Напис на кнопці

lifetimeчисло Строк життя в секундах

idчисло Ваш ідентифікатор повідомлення. Якщо не заданий, конектор згенерує його сам і поверне у відповіді — інакше повідомлення стане невідстежуваним

hookрядок URL, куди платформа надішле статус доставки

Приклад запиту

JSON-RPC

{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
        "name": "send_viber",
        "arguments": {
            "phone": "380671234567",
            "signature": "AlphaSMS",
            "message": "Ваш заказ отправлен",
            "image": "https://example.com/promo.jpg",
            "link": "https://example.com/order/42",
            "button": "Отследить",
            "confirm": true
        }
    }
}

cURL

curl -X POST 'https://mcp.alphasms.ua/mcp' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer ВАШ_API_КЛЮЧ' \
  --data-raw '{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "send_viber",
    "arguments": {
      "phone": "380671234567",
      "signature": "AlphaSMS",
      "message": "Ваш заказ отправлен",
      "image": "https://example.com/promo.jpg",
      "link": "https://example.com/order/42",
      "button": "Отследить",
      "confirm": true
    }
  }
}'

Python

import requests

response = requests.post(
    "https://mcp.alphasms.ua/mcp",
    headers={"Authorization": "Bearer ВАШ_API_КЛЮЧ"},
    json={
        "jsonrpc": "2.0",
        "id": 1,
        "method": "tools/call",
        "params": {
            "name": "send_viber",
            "arguments": {
                "phone": "380671234567",
                "signature": "AlphaSMS",
                "message": "Ваш заказ отправлен",
                "image": "https://example.com/promo.jpg",
                "link": "https://example.com/order/42",
                "button": "Отследить",
                "confirm": true
            }
        }
    },
    timeout=30,
)

print(response.json())

Node.js

const response = await fetch("https://mcp.alphasms.ua/mcp", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    Authorization: "Bearer ВАШ_API_КЛЮЧ",
  },
  body: JSON.stringify({
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "send_viber",
      "arguments": {
        "phone": "380671234567",
        "signature": "AlphaSMS",
        "message": "Ваш заказ отправлен",
        "image": "https://example.com/promo.jpg",
        "link": "https://example.com/order/42",
        "button": "Отследить",
        "confirm": true
      }
    }
  }),
});

console.log(await response.json());

send_viber_with_sms_fallback

Каскад: спершу Viber, а якщо його не доставлено — SMS. Списується за те, що реально пішло, тож недоставлений Viber із досиланням коштує дорожче за одиничне SMS. Тексти задаються окремо — у SMS зазвичай потрібен коротший.

Параметри

phoneрядокобов'язковий Номер отримувача

viber_signatureрядокобов'язковий Ім'я відправника у Viber

viber_messageрядокобов'язковий Текст для Viber

sms_signatureрядокобов'язковий Ім'я відправника для SMS

sms_messageрядокобов'язковий Текст для SMS

confirmбулевеобов'язковий Обов'язково true. Без нього конектор відповідає відмовою і до API не звертається

imageрядок Картинка для Viber

linkрядок URL переходу за кнопкою

buttonрядок Напис на кнопці

idчисло Ваш ідентифікатор повідомлення. Якщо не заданий, конектор згенерує його сам і поверне у відповіді — інакше повідомлення стане невідстежуваним

hookрядок URL, куди платформа надішле статус доставки

Приклад запиту

JSON-RPC

{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
        "name": "send_viber_with_sms_fallback",
        "arguments": {
            "phone": "380671234567",
            "viber_signature": "AlphaSMS",
            "viber_message": "Ваш заказ отправлен, отследить: https://example.com/order/42",
            "sms_signature": "ALPHASMS",
            "sms_message": "Заказ отправлен",
            "confirm": true
        }
    }
}

cURL

curl -X POST 'https://mcp.alphasms.ua/mcp' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer ВАШ_API_КЛЮЧ' \
  --data-raw '{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "send_viber_with_sms_fallback",
    "arguments": {
      "phone": "380671234567",
      "viber_signature": "AlphaSMS",
      "viber_message": "Ваш заказ отправлен, отследить: https://example.com/order/42",
      "sms_signature": "ALPHASMS",
      "sms_message": "Заказ отправлен",
      "confirm": true
    }
  }
}'

Python

import requests

response = requests.post(
    "https://mcp.alphasms.ua/mcp",
    headers={"Authorization": "Bearer ВАШ_API_КЛЮЧ"},
    json={
        "jsonrpc": "2.0",
        "id": 1,
        "method": "tools/call",
        "params": {
            "name": "send_viber_with_sms_fallback",
            "arguments": {
                "phone": "380671234567",
                "viber_signature": "AlphaSMS",
                "viber_message": "Ваш заказ отправлен, отследить: https://example.com/order/42",
                "sms_signature": "ALPHASMS",
                "sms_message": "Заказ отправлен",
                "confirm": true
            }
        }
    },
    timeout=30,
)

print(response.json())

Node.js

const response = await fetch("https://mcp.alphasms.ua/mcp", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    Authorization: "Bearer ВАШ_API_КЛЮЧ",
  },
  body: JSON.stringify({
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "send_viber_with_sms_fallback",
      "arguments": {
        "phone": "380671234567",
        "viber_signature": "AlphaSMS",
        "viber_message": "Ваш заказ отправлен, отследить: https://example.com/order/42",
        "sms_signature": "ALPHASMS",
        "sms_message": "Заказ отправлен",
        "confirm": true
      }
    }
  }),
});

console.log(await response.json());

send_rcs

Одне повідомлення RCS. Доходить лише на пристрої з підтримкою RCS — для решти потрібен окремий запасний канал.

Параметри

phoneрядокобов'язковий Номер отримувача

signatureрядокобов'язковий Зареєстроване ім'я відправника

messageрядокобов'язковий Текст повідомлення

confirmбулевеобов'язковий Обов'язково true. Без нього конектор відповідає відмовою і до API не звертається

imageрядок URL картинки

linkрядок URL переходу за кнопкою

buttonрядок Напис на кнопці

lifetimeчисло Строк життя в секундах

idчисло Ваш ідентифікатор повідомлення. Якщо не заданий, конектор згенерує його сам і поверне у відповіді — інакше повідомлення стане невідстежуваним

hookрядок URL, куди платформа надішле статус доставки

Приклад запиту

JSON-RPC

{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
        "name": "send_rcs",
        "arguments": {
            "phone": "380671234567",
            "signature": "AlphaSMS",
            "message": "Ваш код 1234",
            "confirm": true
        }
    }
}

cURL

curl -X POST 'https://mcp.alphasms.ua/mcp' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer ВАШ_API_КЛЮЧ' \
  --data-raw '{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "send_rcs",
    "arguments": {
      "phone": "380671234567",
      "signature": "AlphaSMS",
      "message": "Ваш код 1234",
      "confirm": true
    }
  }
}'

Python

import requests

response = requests.post(
    "https://mcp.alphasms.ua/mcp",
    headers={"Authorization": "Bearer ВАШ_API_КЛЮЧ"},
    json={
        "jsonrpc": "2.0",
        "id": 1,
        "method": "tools/call",
        "params": {
            "name": "send_rcs",
            "arguments": {
                "phone": "380671234567",
                "signature": "AlphaSMS",
                "message": "Ваш код 1234",
                "confirm": true
            }
        }
    },
    timeout=30,
)

print(response.json())

Node.js

const response = await fetch("https://mcp.alphasms.ua/mcp", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    Authorization: "Bearer ВАШ_API_КЛЮЧ",
  },
  body: JSON.stringify({
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "send_rcs",
      "arguments": {
        "phone": "380671234567",
        "signature": "AlphaSMS",
        "message": "Ваш код 1234",
        "confirm": true
      }
    }
  }),
});

console.log(await response.json());

send_voice

Синтезований голосовий виклик із зачитуванням тексту.

Параметри

phoneрядокобов'язковий Номер отримувача, тільки цифри, без ведучого нуля: 380671234567. Для цього типу платформа приймає номер числом

messageрядокобов'язковий Текст, який буде зачитано

confirmбулевеобов'язковий Обов'язково true. Без нього конектор відповідає відмовою і до API не звертається

languageрядок Мова озвучування, наприклад en-GB або uk-UA

genderрядок Стать голосу: male або female

nameрядок Ім'я голосової моделі, наприклад en-GB-Standard-A

dtmfбулеве Збирати відповідь абонента кнопками телефона. За замовчуванням ні

idчисло Ваш ідентифікатор повідомлення. Якщо не заданий, конектор згенерує його сам і поверне у відповіді — інакше повідомлення стане невідстежуваним

hookрядок URL для вебхуків щодо цього повідомлення. Відмова прийому (No route, Not enough money, помилка валідації) прийде туди окремим вебхуком зі status: REJECTED. А статус доставки — ні: для цього типу платформа адресу не зберігає і шле статус лише на адресу сповіщень із налаштувань API

Приклад запиту

JSON-RPC

{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
        "name": "send_voice",
        "arguments": {
            "phone": "380671234567",
            "message": "Ваш код підтвердження: 1 2 3 4",
            "language": "uk-UA",
            "confirm": true
        }
    }
}

cURL

curl -X POST 'https://mcp.alphasms.ua/mcp' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer ВАШ_API_КЛЮЧ' \
  --data-raw '{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "send_voice",
    "arguments": {
      "phone": "380671234567",
      "message": "Ваш код підтвердження: 1 2 3 4",
      "language": "uk-UA",
      "confirm": true
    }
  }
}'

Python

import requests

response = requests.post(
    "https://mcp.alphasms.ua/mcp",
    headers={"Authorization": "Bearer ВАШ_API_КЛЮЧ"},
    json={
        "jsonrpc": "2.0",
        "id": 1,
        "method": "tools/call",
        "params": {
            "name": "send_voice",
            "arguments": {
                "phone": "380671234567",
                "message": "Ваш код підтвердження: 1 2 3 4",
                "language": "uk-UA",
                "confirm": true
            }
        }
    },
    timeout=30,
)

print(response.json())

Node.js

const response = await fetch("https://mcp.alphasms.ua/mcp", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    Authorization: "Bearer ВАШ_API_КЛЮЧ",
  },
  body: JSON.stringify({
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "send_voice",
      "arguments": {
        "phone": "380671234567",
        "message": "Ваш код підтвердження: 1 2 3 4",
        "language": "uk-UA",
        "confirm": true
      }
    }
  }),
});

console.log(await response.json());

send_whatsapp

Власного типу повідомлення у WhatsApp немає. Конектор надсилає запит типу pipeline з етапом whatsapp — див. Відправка OTP коду (WhatsApp). Надсилання можливе лише за маршрутом, заведеним під цей набір етапів: без нього платформа відповідає No route і нічого не списує. Дійде, лише якщо отримувач раніше написав першим або дав згоду, а ім'я відправника зареєстроване у WhatsApp Business.

Параметри

phoneрядокобов'язковий Номер отримувача, тільки цифри, без ведучого нуля: 380671234567

signatureрядокобов'язковий Зареєстроване ім'я відправника у WhatsApp Business

messageрядокобов'язковий Текст повідомлення

confirmбулевеобов'язковий Обов'язково true. Без нього конектор відповідає відмовою і до API не звертається

sms_signatureрядок Ім'я відправника для запасного SMS. Задається лише разом із sms_message

sms_messageрядок Текст запасного SMS: піде, якщо WhatsApp не доставлено. Потребує маршруту whatsapp+sms

idчисло Ваш ідентифікатор повідомлення. Якщо не заданий, конектор згенерує його сам і поверне у відповіді

hookрядок URL для вебхуків щодо цього повідомлення. Відмова прийому (No route, Not enough money, помилка валідації) прийде туди окремим вебхуком зі status: REJECTED. А статус доставки — ні: для цього типу платформа адресу не зберігає і шле статус лише на адресу сповіщень із налаштувань API

Приклад запиту

JSON-RPC

{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
        "name": "send_whatsapp",
        "arguments": {
            "phone": "380671234567",
            "signature": "AlphaSMS",
            "message": "Ваше замовлення готове до видачі",
            "confirm": true
        }
    }
}

cURL

curl -X POST 'https://mcp.alphasms.ua/mcp' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer ВАШ_API_КЛЮЧ' \
  --data-raw '{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "send_whatsapp",
    "arguments": {
      "phone": "380671234567",
      "signature": "AlphaSMS",
      "message": "Ваше замовлення готове до видачі",
      "confirm": true
    }
  }
}'

Python

import requests

response = requests.post(
    "https://mcp.alphasms.ua/mcp",
    headers={"Authorization": "Bearer ВАШ_API_КЛЮЧ"},
    json={
        "jsonrpc": "2.0",
        "id": 1,
        "method": "tools/call",
        "params": {
            "name": "send_whatsapp",
            "arguments": {
                "phone": "380671234567",
                "signature": "AlphaSMS",
                "message": "Ваше замовлення готове до видачі",
                "confirm": true
            }
        }
    },
    timeout=30,
)

print(response.json())

Node.js

const response = await fetch("https://mcp.alphasms.ua/mcp", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    Authorization: "Bearer ВАШ_API_КЛЮЧ",
  },
  body: JSON.stringify({
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "send_whatsapp",
      "arguments": {
        "phone": "380671234567",
        "signature": "AlphaSMS",
        "message": "Ваше замовлення готове до видачі",
        "confirm": true
      }
    }
  }),
});

console.log(await response.json());

примітка

sms_signature і sms_message задаються парою: з одним із них конектор відповідає відмовою ще до звернення в API. Разом вони перетворюють запит на пайплайн whatsapp → sms, а під нього потрібен окремий маршрут.

message_status не знайде повідомлення pipeline — ваш id платформа для нього не зберігає. Конектор повертає id і склад етапів, щоб було видно, що саме пішло в чергу.

send_verification_code

Надсилає одноразовий код і сам його генерує. У цієї операції окрема адреса і свій набір полів: повертається verify_id, за яким код потім звіряється.

Параметри

phoneрядокобов'язковий Номер отримувача

signatureрядокобов'язковий Ім'я відправника

confirmбулевеобов'язковий Обов'язково true. Без нього конектор відповідає відмовою і до API не звертається

channelрядок Канал доставки: sms, viber або voice

code_lengthчисло Довжина коду, за замовчуванням 6

code_typeрядок Склад коду: numeric або alphanumeric

langрядок Мова шаблону, наприклад uk

custom_idрядок Ваш ідентифікатор для звіряння

hookрядок URL для статусу

Приклад запиту

JSON-RPC

{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
        "name": "send_verification_code",
        "arguments": {
            "phone": "380671234567",
            "signature": "AlphaSMS",
            "channel": "sms",
            "confirm": true
        }
    }
}

cURL

curl -X POST 'https://mcp.alphasms.ua/mcp' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer ВАШ_API_КЛЮЧ' \
  --data-raw '{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "send_verification_code",
    "arguments": {
      "phone": "380671234567",
      "signature": "AlphaSMS",
      "channel": "sms",
      "confirm": true
    }
  }
}'

Python

import requests

response = requests.post(
    "https://mcp.alphasms.ua/mcp",
    headers={"Authorization": "Bearer ВАШ_API_КЛЮЧ"},
    json={
        "jsonrpc": "2.0",
        "id": 1,
        "method": "tools/call",
        "params": {
            "name": "send_verification_code",
            "arguments": {
                "phone": "380671234567",
                "signature": "AlphaSMS",
                "channel": "sms",
                "confirm": true
            }
        }
    },
    timeout=30,
)

print(response.json())

Node.js

const response = await fetch("https://mcp.alphasms.ua/mcp", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    Authorization: "Bearer ВАШ_API_КЛЮЧ",
  },
  body: JSON.stringify({
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "send_verification_code",
      "arguments": {
        "phone": "380671234567",
        "signature": "AlphaSMS",
        "channel": "sms",
        "confirm": true
      }
    }
  }),
});

console.log(await response.json());

Помилки

Конектор передає помилки API як є, без переформулювання. Часті випадки:

Помилка авторизації невірний або відкликаний ключ у заголовку Authorization

Ім'я відправника недоступне ім'я не зареєстроване або ще на модерації

Недостатньо коштів нульовий або від'ємний баланс

Невірний номер номер не в міжнародному форматі або не існує