Почати
Ваш перший запит в чотири кроки
Підключіть і ввімкніть WhatsApp для підтримуваних мобільних пристроїв.
Підтвердіть одержувача з кінцевою точкою номеру.
Відправте з ваонлі=так.
Для вхідних повідомлень активувати ретривальну, синхронізацію, потім викликати /getwa.
Офіційне мобільне додаток
Забезпечений міст між телефоном, панельом і API.
SMS і операції дзвінків проходять через офіційний додаток SMSMobileAPI, встановлений на підключеному телефоні. Додаток надійно справляє пристрій з вашим обліковим записом, синхронізує уповноважені події та посилює мобільний зв'язок з панельним приладом та REST API.
- Випущені релізи, що розповсюджуються через офіційні списки Google Play та Apple App Store
- Огляд платформи Google та Apple, реєстрація та управління розподілами
- Захищений пристрій, HTTPS транспортно-автентифікований API
- Для мобільних функцій, які ви включите
Аутентифікація
Збережіть облікові дані на сервері
Використовуйте клавішу для прямих інтеграцій. ЗXQ13QXZ2 клієнтові, які доступні для серверних додатків; запитати про текен і відправити його як авторизація: Bearer ACCESS TOKEN.
Історія управління
Очистити історію безпечно: попередній перегляд, видалення, слідувати прогрес
Ці кінцеві точки очистити історію виділеного сервера для ключа API, не повідомлення на телефонах або зовнішніх сервісах. Не надайте скидання рахунку. Після видалення може з'явитися нова активність.
Читати посібник з дерматизації request_id
За замовчуванням, пов'язані або переробка записів залишаються видимими. Тільки використовувати include_linked=1, якщо ви приймаєте цю інтеграцію або безперервну обробку може припинити роботу.
Як працює request_id
- Перегляд кількості з action=preview. Немає request_id, що потрібно і не видаляється записів.
- Сприяє відновленню унікальної request_id для нового видалення, наприклад, UUID. Заощаджуйте його перед відправленням action=delete.
- Для рети, часових виходів або HTTP 202, повторно використовуйте той же ключ API, кінцева точка історії, request_id і include_linked значення. Не генеруйте новий ідентифікатор автоматично після помилки.
- Коли ЗСКАЧАКСЗ завершується операція. Відновити свій ідентифікатор повертає той же результат замість видалення новоприбулих записів. Використовуйте новий ідентифікатор тільки для свідомо нового очищення.
request_id визначає вашу операцію видалення, не індивідуальну SMS. Додано формат: 16–128 ASCII літери, цифри, гіфени або низи. Для цього потрібен броньований броньований біржовий .randomUID()
Видалення виконується пакетами. За HTTP 202 і continue_required=true повторіть action=delete через 3 секунди. Фоновий cron не запускається. action=status лише читає перебіг і не продовжує видалення, навіть за HTTP 200.
Видалення та приклади стану
Замініть зразок request_id з власним унікальним значенням перед початком. Видаліть наступні запити, змінюйте історію реального облікового запису, вони не є попередніми переглядами.
curl -X POST "https://api.smsmobileapi.com/delete-history-whatsapp-sent/" \
--data-urlencode "apikey=YOUR_API_KEY" \
-d "action=delete" -d "include_linked=0" \
-d "request_id=6d54ac58-41f1-4fbc-9a39-6e6c86089451"curl -X POST "https://api.smsmobileapi.com/delete-history-whatsapp-sent/" \
-H "Authorization: Bearer YOUR_OAUTH_ACCESS_TOKEN" \
-d "action=delete" -d "include_linked=0" \
-d "request_id=6d54ac58-41f1-4fbc-9a39-6e6c86089451"curl -G "https://api.smsmobileapi.com/delete-history-whatsapp-sent/" \
--data-urlencode "apikey=YOUR_API_KEY" \
-d "action=status" \
-d "request_id=6d54ac58-41f1-4fbc-9a39-6e6c86089451"GET також приймає action=preview або action=delete. POST рекомендується: параметри URL можуть витікати в історію браузера і журнали сервера. Не розміщуйте URL-адресу видалення в публічному посилання, зображення або префікс.
Для POST надішлемо всі параметри у вигляді тіла або об'єкта JSON, ніколи не в рядку запиту. Невідомі параметри відхилені; дата або мобільні фільтри не підтримуються.
Ауттентика для ендто точок історії
Використовуйте apikey або Authorization: Bearer з'явився з SMSMobileAPI OAuth2. Не надсилайте освіження або ключ API як токен Bearer. Відхилено відхилені відтоки.
За допомогою history:read можна переглянути/стату та history:delete також дозволяє відхиляти. Обмеження на використання токени та OAuth. Ногати без очок зберігають наявний доступ до облікового запису.
OAuth2 вибирає унікальний ключ API. Якщо існують декілька основних ключів, також забезпечують apikey для вибору одного з речей до облікового запису. По-друге, ключі не надають доступу до початкової історії ключів.
Читати відповідь перед продовження
count_delete є кумулятивним числом, видаленим цією роботою. selected_at_start є початковим вибором; protected_at_start кількість виключених записів. Використовуйте preview.linked_or_processing для підрахунку пов'язаних записів навіть коли include_linked=1.
{
"result": {
"error": 0,
"history": "whatsapp-sent",
"action": "delete",
"request_id": "6d54ac58-41f1-4fbc-9a39-6e6c86089451",
"status": "processing",
"completed": false,
"count_delete": 100,
"total_before": 250,
"selected_at_start": 200,
"protected_at_start": 50,
"include_linked": 0,
"continue_required": true,
"message": "Repeat GET or POST with the same request_id and include_linked to continue. Status requests do not run deletion."
}
}- 200 з completed=true: завершено. Відповідність 200 або статус не доведе завершення.
- 400 INVALID_REQUEST_ID: перевірити формат. 404 REQUEST_NOT_FOUND: немає операції для цього ID, ключа API і історії.
- 401: недійсні або невилічені повноваження. 403: недостатня сфера OAuth або несанкціонований рахунок.
- 409 HISTORY_BUSY: інший чистий процес працює; продовжуйте його з оригінального клієнта. 409 INCLUDE_LINKED_CONFLICT: відновлення оригінального значення include_linked.
- 409 OAUTH_ACCOUNT_AMBIGUOUS: забезпечити ключ API до цього облікового запису.
- 503 або мережевий перерву: вже завершені деякі партії. Перевірити налаштування, потім птиця з оригінальним request_id. Не створювати автоматично заміну.
ЦІНА ЗА ЧАС:
Надіслати повідомлення WhatsApp
https://api.smsmobileapi.com/sendsmsВідправляється з текстом WhatsApp або підтримувані засоби через підключене середовище.
Використовуйте його для окремих одержувачів або контактної групи з приладом.
Параметри
| Ім’я | Тип | Вимагати | опис |
|---|---|---|---|
apikey |
рядок | Обов'язковий | Ваш ключ API; omit при використанні жетона Bearer. |
recipients |
Контакти | Обов'язковий | Країна-код плюс номер, без + або 00. |
message |
рядок | Обов'язковий | Підтримуються декілька рядків. |
waonly |
так | Обов'язковий | Вам необхідно звернутися до служби WhatsApp-тільки для доставки. |
url_media |
HTTPS URL | Додатковий | Електронний документ, документ, архів або URL-адреса JPG/PNG. |
url_media_shorted |
так | Додатковий | Використовуйте скорочений URL-адресу завантаження з режимом попереднього перегляду PDF. |
pdf_with_image |
так | Додатковий | Додати перегляд зображень для PDF. |
encrypt_message |
так | Додатковий | Вимагати розшифрування одержувача. |
contactGroup |
ЛІТЕРА | Додатковий | Надішліть на будь-який контакт в групі з гіпсокартоном. |
Приклад запиту
curl -X POST "https://api.smsmobileapi.com/sendsms?waonly=yes" \
-d "apikey=YOUR_API_KEY" \
-d "recipients=191728660" \
--data-urlencode "message=Your order is ready."
Приклад відповіді
{
"result": {
"error": 0,
"sent": "1",
"id": "MESSAGE_GUID",
"send_with_whatsapp": "1"
}
}
Хочете запустити цей запит?Підключіть ключ API у верхній частині сторінки, щоб розблокувати інтерактивний тестер.
ключ підключення ↑- Підтримувані медіа-адреси повинні бути публічними ресурсами HTTPS.
- Форматування WhatsApp: *bold *, italic , ~strike прорив ~ і потрійний резервний монокосмічний.
ЦІНА ЗА ЧАС:
Створіть непрозорий повідомлення WhatsApp
https://api.smsmobileapi.com/resendwa/За допомогою WhatsApp повідомлення, що наразі має статус помилки.
Використовуйте його після діагностики невдалого входу з WhatsApp.
Параметри
| Ім’я | Тип | Вимагати | опис |
|---|---|---|---|
apikey |
рядок | Обов'язковий | Ваш ключ API. |
guid |
рядок | Обов'язковий | графічний інтерфейс не вдалося повідомлення. |
Приклад запиту
curl "https://api.smsmobileapi.com/resendwa/?apikey=YOUR_API_KEY&guid=MESSAGE_GUID"
Хочете запустити цей запит?Підключіть ключ API у верхній частині сторінки, щоб розблокувати інтерактивний тестер.
ключ підключення ↑- Тільки не вдалося повідомлення переслати.
ОТРИМАТИ
Активувати вхідний ретрієв
https://api.smsmobileapi.com/getwa/active/Активати, деактивати або окуляри WhatsApp повідомлення retrieval.
Зателефонуйте його, перш ніж використовувати вхідну синхронізацію WhatsApp.
Параметри
| Ім’я | Тип | Вимагати | опис |
|---|---|---|---|
apikey |
рядок | Обов'язковий | Ваш ключ API. |
statut |
0 | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Додатковий | 1 активує, 0 деактивує, x або бездіяльність, що охоплює поточний стан. |
Приклад запиту
curl "https://api.smsmobileapi.com/getwa/active/?apikey=YOUR_API_KEY&statut=1"
Приклад відповіді
{
"success": true,
"read_message_active": 1,
"status_note": "Activated"
}
Хочете запустити цей запит?Підключіть ключ API у верхній частині сторінки, щоб розблокувати інтерактивний тестер.
ключ підключення ↑- За замовчуванням для конфіденційності відключається вхідний ретривалл.
ОТРИМАТИ
Синхронізація вхідних повідомлень
https://api.smsmobileapi.com/getwa/synchronisation/Запити про свіжу синхронізацію WhatsApp перед ретривальною.
Зателефонуйте його безпосередньо перед /getwa, коли вам потрібна інформація, що надходить для входу.
Параметри
| Ім’я | Тип | Вимагати | опис |
|---|---|---|---|
apikey |
рядок | Обов'язковий | Ваш ключ API. |
Приклад запиту
curl "https://api.smsmobileapi.com/getwa/synchronisation/?apikey=YOUR_API_KEY"
Приклад відповіді
{
"error": "0",
"messages": "synchronized",
"expire_at": "2026-03-11 12:27:00",
"expire_at_unix": "1773232020"
}
Хочете запустити цей запит?Підключіть ключ API у верхній частині сторінки, щоб розблокувати інтерактивний тестер.
ключ підключення ↑- Синхронізація – для отримання повідомлень тільки. Не зателефонуйте його перед відправленням.
ОТРИМАТИ
Посилання: WhatsApp
https://api.smsmobileapi.com/getwaПовертає синхронізацію вхідних повідомлень WhatsApp.
Використовуйте його після активації та синхронізації вхідних ретривалів.
Параметри
| Ім’я | Тип | Вимагати | опис |
|---|---|---|---|
apikey |
рядок | Обов'язковий | Ваш ключ API. |
before |
Унікс мітки | Додатковий | Повернути записи до цього часу. |
date |
РРРР-ММ-ДД | Додатковий | Повернення записів за одну дату. |
message_type |
аудіо | Додатковий | Фільтрувати текстові повідомлення або аудіо повідомлення, перетворені на текст; omit для обох. |
Приклад запиту
curl "https://api.smsmobileapi.com/getwa/?apikey=YOUR_API_KEY&message_type=text"
Приклад відповіді
{
"date": "2026-03-11",
"hour": "12:27:00",
"timestamp": "1773232020",
"number": "19176728660",
"contact": "SMSMobileAPI",
"message": "When will I receive my order?",
"guid": "652fcfc0-12a8-46f5-b5ba-9391135b8b4c"
}
Хочете запустити цей запит?Підключіть ключ API у верхній частині сторінки, щоб розблокувати інтерактивний тестер.
ключ підключення ↑
ОТРИМАТИ
Перевірити номер WhatsApp
https://api.smsmobileapi.com/whatsapp/checknumber/Перевірити, чи доступний телефон на WhatsApp.
Використовуйте його перед відправкою, щоб зменшити нездатність збою.
Параметри
| Ім’я | Тип | Вимагати | опис |
|---|---|---|---|
apikey |
рядок | Обов'язковий | Ваш ключ API. |
recipients |
Контакти | Обов'язковий | Країна-код плюс номер, без + або 00. |
Приклад запиту
curl "https://api.smsmobileapi.com/whatsapp/checknumber/?apikey=YOUR_API_KEY&recipients=19176728660"
Приклад відповіді
{
"contact_found_on_whatsapp": "yes",
"recipients": "19176728660"
}
Хочете запустити цей запит?Підключіть ключ API у верхній частині сторінки, щоб розблокувати інтерактивний тестер.
ключ підключення ↑
ПОСТ
Створіть OAuth2 доступ до ken
https://api.smsmobileapi.com/oauth2/tokenОбміни клієнтських облікових записів для токена Bearer.
Використовуйте його для інтеграції сервера досервера, де кращі облікові дані, які не містяться в короткі терміни.
Параметри
| Ім’я | Тип | Вимагати | опис |
|---|---|---|---|
grant_type |
рядок | Обов'язковий | Повинен бути клієнтом криміналами. |
client_id |
рядок | Обов'язковий | Клієнтський ідентифікатор з панелі інструментів. |
client_secret |
рядок | Обов'язковий | Секрет клієнта з приладової панелі. |
Приклад запиту
curl -X POST "https://api.smsmobileapi.com/oauth2/token" \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "grant_type=client_credentials" \
-d "client_id=YOUR_CLIENT_ID" \
-d "client_secret=YOUR_CLIENT_SECRET"
Хочете запустити цей запит?Підключіть ключ API у верхній частині сторінки, щоб розблокувати інтерактивний тестер.
ключ підключення ↑- Зареєструватися на сервері. Ми не включаємо його в мобільний або браузерний код.
ЦІНА ЗА ЧАС:
Очистити історію надісланих повідомлень WhatsApp
https://api.smsmobileapi.com/delete-history-whatsapp-sent/Очистити серверні записи відправлених повідомлень WhatsApp. Не видаляти повідомлення з розмов WhatsApp.
Використовуйте попередній перегляд, перевірте кількість, потім явно запитайте видалення. Цей ви зрозумілий всю вибрану історію для ключа API, без дати, телефону або фільтрів повідомлень.
Параметри
| Ім’я | Тип | Вимагати | опис |
|---|---|---|---|
apikey |
рядок | Додатковий | Не потрібно без OAuth2. З OAuth2, додатково виберіть ключ API, що належить до одного облікового запису. |
action |
preview | delete | status | Додатковий | preview рахує записи без видалення; delete починає або продовжує видалення; status лише показує перебіг. Типове значення API — delete, а цього тестера — preview. |
include_linked |
0 | 1 | Додатковий | За замовчуванням 0: зберігати пов'язані або обробляти записи. Встановити 1, щоб включити їх, з ризиком розбиття інтеграцій. Зберігати цю вартість, не втрачаючи при тривалні знезараження. |
request_id |
рядок | Додатковий | Обов’язково для delete і status, необов’язково для preview. Використовуйте 16–128 літер ASCII, цифр, дефісів (-) або підкреслень (_). Створюйте унікальний ID для кожного нового видалення та зберігайте його для всіх повторних спроб. Це не ID повідомлення і не ключ API. |
Приклад запиту
curl -X POST "https://api.smsmobileapi.com/delete-history-whatsapp-sent/" \
--data-urlencode "apikey=YOUR_API_KEY" \
-d "action=preview" -d "include_linked=0"
Видалення та приклади стану
Замініть зразок request_id з власним унікальним значенням перед початком. Видаліть наступні запити, змінюйте історію реального облікового запису, вони не є попередніми переглядами.
curl -X POST "https://api.smsmobileapi.com/delete-history-whatsapp-sent/" \
--data-urlencode "apikey=YOUR_API_KEY" \
-d "action=delete" -d "include_linked=0" \
-d "request_id=6d54ac58-41f1-4fbc-9a39-6e6c86089451"curl -X POST "https://api.smsmobileapi.com/delete-history-whatsapp-sent/" \
-H "Authorization: Bearer YOUR_OAUTH_ACCESS_TOKEN" \
-d "action=delete" -d "include_linked=0" \
-d "request_id=6d54ac58-41f1-4fbc-9a39-6e6c86089451"curl -G "https://api.smsmobileapi.com/delete-history-whatsapp-sent/" \
--data-urlencode "apikey=YOUR_API_KEY" \
-d "action=status" \
-d "request_id=6d54ac58-41f1-4fbc-9a39-6e6c86089451"Приклад відповіді
{
"result": {
"error": 0,
"history": "whatsapp-sent",
"action": "preview",
"total": 120,
"simple": 100,
"linked_or_processing": 20,
"selected": 100,
"include_linked": 0,
"operation_in_progress": false,
"active_include_linked": null
}
}
Хочете запустити цей запит?Підключіть ключ API у верхній частині сторінки, щоб розблокувати інтерактивний тестер.
ключ підключення ↑- Приклад вище - попередній перегляд, не видалення. Підбір характеризується при старті видалення.
- include_linked=1 може порушити GHL, Zapier, автоматики, відписані посилання або відстеження доставки. Не обходити облік володіння або перевірки цілісності зберігання.
ЦІНА ЗА ЧАС:
Очистити історію отриманих повідомлень WhatsApp
https://api.smsmobileapi.com/delete-history-whatsapp-received/Очистити серверні записи отриманих повідомлень WhatsApp. Не відключає WhatsApp або видаляє розмови.
Використовуйте попередній перегляд, перевірте кількість, потім явно запитайте видалення. Цей ви зрозумілий всю вибрану історію для ключа API, без дати, телефону або фільтрів повідомлень.
Параметри
| Ім’я | Тип | Вимагати | опис |
|---|---|---|---|
apikey |
рядок | Додатковий | Не потрібно без OAuth2. З OAuth2, додатково виберіть ключ API, що належить до одного облікового запису. |
action |
preview | delete | status | Додатковий | preview рахує записи без видалення; delete починає або продовжує видалення; status лише показує перебіг. Типове значення API — delete, а цього тестера — preview. |
include_linked |
0 | 1 | Додатковий | За замовчуванням 0: зберігати пов'язані або обробляти записи. Встановити 1, щоб включити їх, з ризиком розбиття інтеграцій. Зберігати цю вартість, не втрачаючи при тривалні знезараження. |
request_id |
рядок | Додатковий | Обов’язково для delete і status, необов’язково для preview. Використовуйте 16–128 літер ASCII, цифр, дефісів (-) або підкреслень (_). Створюйте унікальний ID для кожного нового видалення та зберігайте його для всіх повторних спроб. Це не ID повідомлення і не ключ API. |
Приклад запиту
curl -X POST "https://api.smsmobileapi.com/delete-history-whatsapp-received/" \
--data-urlencode "apikey=YOUR_API_KEY" \
-d "action=preview" -d "include_linked=0"
Видалення та приклади стану
Замініть зразок request_id з власним унікальним значенням перед початком. Видаліть наступні запити, змінюйте історію реального облікового запису, вони не є попередніми переглядами.
curl -X POST "https://api.smsmobileapi.com/delete-history-whatsapp-received/" \
--data-urlencode "apikey=YOUR_API_KEY" \
-d "action=delete" -d "include_linked=0" \
-d "request_id=6d54ac58-41f1-4fbc-9a39-6e6c86089451"curl -X POST "https://api.smsmobileapi.com/delete-history-whatsapp-received/" \
-H "Authorization: Bearer YOUR_OAUTH_ACCESS_TOKEN" \
-d "action=delete" -d "include_linked=0" \
-d "request_id=6d54ac58-41f1-4fbc-9a39-6e6c86089451"curl -G "https://api.smsmobileapi.com/delete-history-whatsapp-received/" \
--data-urlencode "apikey=YOUR_API_KEY" \
-d "action=status" \
-d "request_id=6d54ac58-41f1-4fbc-9a39-6e6c86089451"Приклад відповіді
{
"result": {
"error": 0,
"history": "whatsapp-received",
"action": "preview",
"total": 120,
"simple": 100,
"linked_or_processing": 20,
"selected": 100,
"include_linked": 0,
"operation_in_progress": false,
"active_include_linked": null
}
}
Хочете запустити цей запит?Підключіть ключ API у верхній частині сторінки, щоб розблокувати інтерактивний тестер.
ключ підключення ↑- Приклад вище - попередній перегляд, не видалення. Підбір характеризується при старті видалення.
- include_linked=1 може порушити GHL, Zapier, автоматики, відписані посилання або відстеження доставки. Не обходити облік володіння або перевірки цілісності зберігання.
Усунення несправностей
Помилки та безпечні рети
Читайте статус HTTP і поле помилки JSON перед перегрівом. Не переробляти валідацію або автентифікацію не виправдовує запит першим.
| ЗСК11ККСЗ | Коди | Що робити |
|---|---|---|
| 400 | missing_parameter | Необхідний параметр порожній або відсутній. Перевірити таблицю параметрів для кінцевої точки. |
| 403 | invalid_apikey | Ключ API невідомий, розширений або не уповноважений за за запитом функції. |
| 429 | too_many_requests | Запити прилітають дуже швидко. Очікуйте, потім птиця з відступним відключенням. |
| 500 | server_error | Послуга не може завершити запит. Зберігати відповідь та контактну підтримку, якщо вона зберігається. |
Потрібна допомога?
Внести контекст запиту — не секрети.
Поділитися кінцевою точкою, часовим кроком, статус HTTP і санітарно-гігієнічним реагуванням. Ніколи не включають ключі API, токени або контент для приватного повідомлення.


