Документация | SmsGateway24.com Postman ссылка

PHP Curl and Guzzel example



Если Ваш сервис не поддерживает отправку запроса через SSL (на https) то вы можете использовать протокол HTTP

Получение токена

Описание: Результатом этого запроса вы получаете токен. В дальнейшем с этим токеном вы обращаетесь к серверу и выполняете другие запросы.

Адрес https://smsgateway24.com/getdata/gettoken

Сейчас Ваш токен: Вход

Метод: POST | GET

Пример кода с использованием Curl

Пример кода с использованием Guzzle

входные параметры

Переменная Тип Описание
email* string Ваш логин в системе. Обычно email
pass* string Ваш пароль в системе

Ответ

Переменная Тип Описание
token string Ваш токен для запросов. Токен связан с Аккаунтом Сейчас Ваш токен: Вход
error number 0 / 1 - есть ли ошибка в обработке запроса
message string Сообщение об ошибке

Отправка смс

Описание: Создает смс на сервере для отправки сразу одной партией. Позволяет создать сразу много смс одним запросом Ссылка на приложение SmsGateWay24

Адрес https://smsgateway24.com/getdata/addsms

Метод: POST | GET ( используйте %2B вместо знака "плюс" в GET запросе )

Пример кода с использованием Curl

Пример кода с использованием Guzzle

входные параметры

Переменная Тип Описание
token* string Ваш токен полученый из метода 'Получение токена'
sendto* string Телефонный номер абонента. Допускаются все требуемые символы. пример: +7-(928)-111-22-33, или через запятую: +792821121212, +7928215343412,+79282654662
body* string Тело сообщения для абонента
device_id* string Id Устройства Список устройств
timetosend datetime YYYY-MM-DD | YYYY-MM-DD HH:MM:SS [не обязательно] Время отправки сообщения Например 2018-10-25 00:00:00
sim integer [не обязательно] номер Сим карты #

customerid int Внутренний номер вашего клиента. Не обязательное поле
urgent boolean (1 or 0) Маркер срочности СМС. Необязательное поле. Если поставть 1 то СМС будет оптравлена с приоритетом. Это может быть полезно если вы отправляете одноразовые пароли а на телефоне уже есть очередь отправки смс

Ответ

Переменная Тип Описание
error number 0 / 1 - есть ли ошибка в обработке запроса
message string Сообщение об ошибке
sms_id integer СМС ID

Отправка смс массово через JSON

Описание: Создает смс на сервере для отправки. После этого телефон с приложением Smsgateway24 обращается к серверу и забирает смс и отправляет со своей sim карты. Скачать приложение можно по ссылке

Адрес https://smsgateway24.com/getdata/addalotofsms

Метод: POST | GET

Пример кода с использованием Curl

Пример кода с использованием Guzzle

входные параметры

Переменная Тип Описание
datajson* JSON Все данные в JSON формате

Ответ

Переменная Тип Описание
error number 0 / 1 - есть ли ошибка в обработке запроса
message string Сообщение об ошибке

Пример JSON

{"token":"df427bfcf113c9a21c67718035076b5b","smsdata":[{"sendto":"015752982212","body":"Test message","sim":1,"timetosend":"2019-07-01 23:50:00","device_id":260},{"sendto":"+4915752982212","body":"Test message 2","sim":1,"timetosend":"2019-07-01 23:50:00","device_id":260,"urgent":1}]}

в удобном виде

{
   "token":"df427bfcf113c9a21c6771803501",
   "smsdata":[
        {
            "sendto":"015752982212",
            "body":"Your password is 12345",
            "sim":1,
            "timetosend":"2019-07-01 23:50:00",
            "device_id":260,
            "customerid":122,
            "urgent":1
        },
        {
            "sendto":"015752982212",
            "body":"Regular SMS. Not urgnet",
            "sim":1,
            "timetosend":"2019-07-01 23:50:00",
            "device_id":260,
            "customerid":122,
            "urgent":0
        }
    ]
}

Получить все смс по критерию. (В том числе входящие смс)

Описание: Через этот запрос вы можете получить все смски которые связаны с вашим аккаунтом. В том числе вы можете получить все входящие смс которые приходят от клиентов. В этом методе есть все входные переменные обязательны. Смски различаются статусами.
Ссылка на приложение SmsGateWay24 PRO

Адрес https://smsgateway24.com/getdata/getallsms

Метод: POST | GET

Пример кода с использованием Curl

Пример кода с использованием Guzzle

входные параметры

Переменная Тип Описание
token* string Ваш токен полученый из метода 'Получение токена'
device_id integer Id Устройства. Список устройств
status integer 1 - Новая
2 - Сервер отдал смс телефону (но телефон еще не отправлял)
5 - Входящая
6 - Отправлено с телефона (но доставлено или нет - неизвестно)
7 - Доставлено
8 - Не доставлено
9 - Не отправлено - Generic failure
10 - Не отправлено - No service
11 - Не отправлено - Null PDU
12 - Не отправлено - Radio off
100 - Не отправлено - NOT ALLOWED (обычно когда не хватает разрешений)
101 - Не отправлено - Not Allowed At all
begindate datetime YYYY-MM-DD | YYYY-MM-DD HH:MM:SS Период с
enddate datetime YYYY-MM-DD | YYYY-MM-DD HH:MM:SS Период до
sim int sim - это номер слота в телефоне: 0 или 1 (необязательный)
customerid int Внутренний номер вашего клиента. Не обязательное поле
onlycount 0/1 Показывать только количество
phone string Номер телефон (не обязательно)
orderbydesc 0 | 1 Сортировка
timezone string Ваша локальная временная зона. Например Europe/Moscow get your zone name

Ответ

Переменная Тип Описание
error number 0 / 1 - есть ли ошибка в обработке запроса
message string Сообщение об ошибке
count integer Количество смс
smss json sms json object

Добавить тэг

Описание: Тег нужен чтобы создавать рассылку на группу номеров. Например тег *Сотрудники*.

Адрес https://smsgateway24.com/getdata/savetag

Метод: POST | GET

Пример кода с использованием Curl

Пример кода с использованием Guzzle

входные параметры

Переменная Тип Описание
token* string Ваш токен полученый из метода 'Получение токена'
title* string Название тега

Ответ

Переменная Тип Описание
error number 0 / 1 - есть ли ошибка в обработке запроса
message string Сообщение об ошибке
tag_id number ID тега

Получить статус одной смс

Описание: Вы можете узнавать статус каждой смс при помощи этого метода

Адрес https://smsgateway24.com/getdata/getsmsstatus

Метод: POST | GET

Пример кода с использованием Curl

Пример кода с использованием Guzzle

входные параметры

Переменная Тип Описание
token* string Ваш токен полученый из метода 'Получение токена'
sms_id* string СМС ID

Ответ

Переменная Тип Описание
sms_id integer СМС ID
status integer Статус СМС
1 - Новая
2 - Сервер отдал смс телефону (но телефон еще не отправлял)
5 - Входящая
6 - Отправлено с телефона (но доставлено или нет - неизвестно)
7 - Доставлено
8 - Не доставлено
9 - Не отправлено - Generic failure
10 - Не отправлено - No service
11 - Не отправлено - Null PDU
12 - Не отправлено - Radio off
100 - Не отправлено - NOT ALLOWED (обычно когда не хватает разрешений)
101 - Не отправлено - Not Allowed At all
status_description string Название статуса
error integer 0 / 1 - есть ли ошибка в обработке запроса
message string Сообщение об ошибке

Получить список устройств

Описание: Вы можете узнать все о своих устройствах

Адрес https://smsgateway24.com/getdata/getalldevices

Метод: POST | GET

Пример кода с использованием Curl

Пример кода с использованием Guzzle

входные параметры

Переменная Тип Описание
token* string Ваш токен полученый из метода 'Получение токена'

Ответ

Переменная Тип Описание
count integer Количество устройств
device json Описание каждого устройства

Значение полей
  • id - Id Устройства
  • title - Имя устройства
  • number - номер телефона
  • created - Дата создания устройства
  • createdhumanformat - Дата создания устройства в обычном формате
  • lastseen - Дата когда последний раз было видно устройство
  • lastseenhumanformat - Дата когда последний раз было видно устройство
  • serialnumber - Серийный номер устройства
  • siminfo - Информация о сим картах в JSON
  • appversion - The version of the application installed on the device
  • isappversionactual - Является ли версия приложения актуальной
  • delaybetweeneachsms - Динамическая задержка между каждой смс
  • delaybetweenrequest - Задержка между каждым запросом на сервер
  • subscription - Есть ли подписка на устройстве

Пример

    {
    "count": 2,
    "device": {
        "1576": {
            "id": 1576,
            "title": "AOSP_on_IA_Emulator",
            "number": null,
            "imei": "358240051111110",
            "created": {
                "date": "2020-03-28 20:10:29.000000",
                "timezone_type": 3,
                "timezone": "UTC"
            },
            "createdhumanformat": "28.03.2020 20:10:29",
            "lastseen": {
                "date": "2020-04-23 17:02:21.000000",
                "timezone_type": 3,
                "timezone": "UTC"
            },
            "lastseenhumanformat": "23.04.2020 17:02:21",
            "serialnumber": "EMULATOR30X0X5X0",
            "siminfo": [
                {
                    "Slot": "0",
                    "IccId": "89014103211118510720",
                    "Number": " 15555215554",
                    "Roaming": "0",
                    "CountryIso": "us",
                    "CarrierName": "Android (T-Mobile)"
                }
            ],
            "appversion": "12.1.18",
            "isappversionactual": false,
            "delaybetweeneachsms": null,
            "delaybetweenrequest": 1,
            "subscription": true
        },
        "1297": {
            "id": 1297,
            "title": "Android_SDK_built_for_x86",
            "number": null,
            "imei": "null",
            "created": {
                "date": "2020-01-20 14:01:05.000000",
                "timezone_type": 3,
                "timezone": "UTC"
            },
            "createdhumanformat": "20.01.2020 14:01:05",
            "lastseen": {
                "date": "2020-04-20 20:51:34.000000",
                "timezone_type": 3,
                "timezone": "UTC"
            },
            "lastseenhumanformat": "20.04.2020 20:51:34",
            "serialnumber": "unknown",
            "siminfo": [
                {
                    "Slot": "0",
                    "IccId": "8949226172233934327",
                    "Number": "+4915752982212",
                    "Roaming": "1",
                    "CountryIso": "de",
                    "CarrierName": "Drillisch (o2)"
                }
            ],
            "appversion": "12.1.18",
            "isappversionactual": false,
            "delaybetweeneachsms": 5,
            "delaybetweenrequest": 10,
            "subscription": false
        }
    }
}

Получить статус одного устройтва

Описание: Вы можете узнавать статус любого своего устройства

Адрес https://smsgateway24.com/getdata/getdevicestatus

Метод: POST | GET

Пример кода с использованием Curl

Пример кода с использованием Guzzle

входные параметры

Переменная Тип Описание
token* string Ваш токен полученый из метода 'Получение токена'
device_id* int ID устройства Список устройств

Ответ

Переменная Тип Описание
error integer СМС ID
message integer описание ошибки
lastseen datetime Время когда последний раз был в сети
device_id integer ID устройства
title string Имя устройства

Добавить контакты с тегом

Описание: Добавляйте контакты для какого нибудь тега. Например для тега *Сотрудники* отлично подойдут ваши коллеги.

Адрес https://smsgateway24.com/getdata/savecontact

Метод: POST | GET

Пример кода с использованием Curl

Пример кода с использованием Guzzle

входные параметры

Переменная Тип Описание
token* string Ваш токен полученый из метода 'Получение токена'
fullname string имя контакта
phone* string номер телефона
tag_id* integer ID тега

Ответ

Переменная Тип Описание
error number 0 / 1 - есть ли ошибка в обработке запроса
message string Сообщение об ошибке
contact_id number ID контакта

Создать рассылку

Описание: После того как вы создали тег, вы можете сделать рассылку на телефоны тега.

Адрес https://smsgateway24.com/getdata/savepaket

Метод: POST | GET

Пример кода с использованием Curl

Пример кода с использованием Guzzle

входные параметры

Переменная Тип Описание
token* string Ваш токен полученый из метода 'Получение токена'
title* string имя рассылки
device_id* number Id Устройства Список устройств
body* string Тело сообщения для абонента
tags* string Id тега. можно сразу несколько, через запятую. Например: 12,13,14
sim* int sim - это номер слота в телефоне: 0 или 1 (необязательный)

Ответ

Переменная Тип Описание
error number 0 / 1 - есть ли ошибка в обработке запроса
message string Сообщение об ошибке
paket number ID пакета

Вы можете воспользоваться Postman для отправки запросов

Используйте Excel для массовой отправки смс

Вы можете отправлять массово смс через Excel



1. download excel


2. Внесите токен и номер устройства в файл Excel

3. Dы можете отправлять смс прямо из excel

4. теперь вам доступна массовая рассылка через excel

Get PHP SDK from GitHub:

https://github.com/smsgateway24/smsgateway24-php-sdk

Get on Packagist.org

https://packagist.org/packages/smsgateway24/smsgateway24-php-sdk

Or use command

composer require smsgateway24/smsgateway24-php-sdk

composer require smsgateway24/smsgateway24-php-sdk

Используйте плагин для PrestaShop

Free SMS Notifications using own network Module

How to:


I. Install steps:


1. Download the module from your account
2. Go to your shop's dashboard
3. Go to Modules
4. Click Add Module and select the archive you've downloaded from your computer
5. Install the module

II. Configuration


1. Enable - Choose to enable/disable SMS Notifications on your website;
2. Customer SMS consent - Choose if customers should give their consent when receiving SMS notifications. A dedicated page will be displayed on customer's account for the SMS consent.
3. Active API - The Main API Service used for sending SMS notifications;
4. API Token– The token used for your sms gateway account;
5. Device ID - The Device ID from your smsgateway.me or smsgateway25.com account

6. SIM ID - The Device ID from your smsgateway25.com account. SIM ID is required only if you use smsgateway25.com!
7. Admin's mobile phone - The number used to receive Admin Notifications. It must start with "+" followed by the country code;
6. Customer notifications - Notifications send only to customers;
9. Admin notifications - Notifications send only to admin;
10. Supplier notifications - Notifications send only to suppliers;
11. SMS delay - Send SMS notifications with a delay using CRON JOB; This option us useful when the Mobile Network Provider does not allow sending SMS messages at a very short interval of time;
12. Feed generation interval - Set the cron run interval;
13. SMS HISTORY button – displays the history log of the sent messages on the shop;
14. CLEAR SMS HISTORY button – clears the history log of the sent messages on the shop;
15. CLEAR SMS HISTORY button – clears the history log of the sent messages on the shop;

III. SMS Templates




Each SMS notification message can be customised.
Each Order Status can sent a customised sms message to the customer.
You can also use shortcodes to build the SMS template.


IV. Send single/bulk SMS.




The module allows you to send a single SMS or you can send Bulk SMS. The bulk SMS option is often


used to send SMS Marketing campaigns to the store’s clients.

V. Check the history


The module has an option that allows you to see the SMS messages that have been sent on the shop.


VI. Abandoned cart sms reminders


The module has an option that allows you to send SMS reminders to customers that have abandoned carts.


VII. Frequently asked questions



. My clients, or the admin does not receive any messages
. - Check your Phone, it must be permanently connected to Internet (Mobile data or Wireless) and needs to have a Carrier SMS Plan. Also be sure the app on your phone is not put to sleep – tutorial here.

. How can I change the automatic messages that are being sent with the module?
- The messages can be customised from Translations > Module Translations.

. Does this module works on iPhone?
- No, at this moment there’s no app for iPhone. If you find one please contact us and we’ll help you with the integration.

Теперь вы можете использовать плагин AMOCRM - он доступен в магазине АМО

Включите плагин в магазине AMOCRM внутри вашей системы. Следуйте инструкции из видео для настройки

Пример кода для 1С 

 Процедура ГлВыполнитьОтправкуСМС(Телефон,ТекстСМС) Экспорт


Логин=СокрЛП(Константа.ЛогинСМС);
Пароль=СокрЛП(Константа.ПарольСМС);
КодУстр=СокрЛП(Константа.КодУстройстваСМС);
Получатель=СокрЛП(Телефон);
Сообщение=СокрЛП(Лев(ТекстСМС,256));
Сообщение=ГлПреобразоватьСтрокуВУТФ8(Сообщение);

ТекстЗапроса="http://smsgateway24.com/getdata/smstosend?sendto="+Получатель+"&body="+Сообщение+"&device_id="+СокрЛП(КодУстр)+"&email="+Логин+"&pass="+Пароль;
Результат="";
Если ЗагрузитьВнешнююКомпоненту("c:\v7plus.dll") <> 1 Тогда
ТекстОшибки = "Компонента v7plus.dll не найдена!";
Сообщить(ТекстОшибки);
Возврат;
КонецЕсли;

Ошибка=0;
Соединение = СоздатьОбъект("AddIn.V7HttpReader");
Попытка
Соединение.ОтправитьДляОбработки(ТекстЗапроса,каталогиб()+"\temp.txt", 1,Результат, 2);
Исключение
Ошибка=1;
Сообщить("СМС не сформировано! для телефона "+Получатель+" Ответ сервера: "+Результат);
КонецПопытки;

Если Ошибка=0 Тогда
Сообщить("ОК. СМС сформировано! для телефона "+Получатель+" Ответ сервера: "+Результат);
КонецЕсли;


КонецПроцедуры

Старый методы API (GET) (HTTPS + HTTP)

Ссылка на приложение SmsGateWay24

Отправка смс

Описание: Создает смс на сервере для отправки сразу одной партией. Позволяет создать сразу много смс одним запросом : Ссылка на приложение SmsGateWay24

Адрес https://smsgateway24.com/getdata/smstosend?sendto=Телефон &body=СООБЩЕНИЕ &device_id=ID_УСТРОЙСТВА&email=Вход &pass=ПАРОЛЬ

Адрес https://smsgateway24.com/getdata/smstosend?sendto=ТЕЛЕФОН&body=СООБЩЕНИЕ&device_id=ID_УСТРОЙСТВА&email=ЛОГИН&pass=ПАРОЛЬ&timetosend=2018-06-08 13:40:00

Метод: GET

входные параметры

Переменная Тип Описание
email string Ваш логин в системе. Обычно email
pass string ваш пароль
sendto string Телефонный номер абонента. Допускаются все требуемые символы. пример: +7-(928)-111-22-33, или через запятую: +792821121212, +7928215343412,+79282654662
body string Тело сообщения для абонента
device_id string Id Устройства
timetosend datetime [YYYY-mm-dd HH:MM:SS] [не обязательно] Время отправки сообщения Например 2018-10-25 00:00:00

Ответ

Переменная Тип Описание
error number 0 / 1 - есть ли ошибка в обработке запроса
message string Сообщение об ошибке
sms_id integer СМС ID
PHP:

$ch = curl_init();
$url = "https://smsgateway24.com/getdata/smstosend?sendto=" . $save->phone . "&body=" . $body . "&device_id=" . $device_id . "&email=support@smsgateway24.com&pass=123456";
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_USERAGENT, 'Mozilla/5.0 (Windows; U; Windows NT 5.1; en-US; rv:1.8.1.13) Gecko/20080311 Firefox/2.0.0.13');
$output = curl_exec($ch);
curl_close($ch);

Telegram Бот

Если вы хотите отправлять уведомления себе на телефон через телеграм, то подключите нашего бота

Отправить запрос

Описание: Отправляйте POST запрос на сервер а люди получат сообщение в telegram

перед тем как отправлять нужно сделать 3 шага:

  1. Скачать телеграм с официального сайта Telegram.org
  2. Что-нибудь написать боту @Smsgateway24bot
  3. Узнать свой ID через бота @userinfobot
  4. Отправить POST запрос

Адрес https://smsgateway24.com/getdata/telegrammessage

Сейчас Ваш токен: Вход

Метод: POST | GET

входные параметры

Переменная Тип Описание
token string Ваш токен полученый из метода 'Получение токена'
body string Тело сообщения для абонента
telegramid string Ваш Id в Телеграм через @getmyid_bot

Ответ

Переменная Тип Описание
error number 0 / 1 - есть ли ошибка в обработке запроса
message string Сообщение об ошибке