API документация P1sms

Запрос на отправку сообщения

URL:

https://admin.p1sms.kz/apiSms/create

Метод:

post

Пример PHP

• Цифровой канал
• Буквенный канал
• Viber
• VK
• Telegram
• Каскад

if( $curl = curl_init() ) {
          $jsonstr = '{"apiKey": "AbCd********", "sms": [{"channel":"digit", "text": "test1", "phone": "79*********", "plannedAt": 1490612400}, {"channel":"digit", "text": "test2", "phone": "79*********", "plannedAt": 1490612400}]}';
          curl_setopt($curl, CURLOPT_URL, 'https://admin.p1sms.kz/apiSms/create');
          curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
          curl_setopt($curl, CURLOPT_POST, true);
          curl_setopt($curl, CURLOPT_POSTFIELDS, $jsonstr);
          curl_setopt($curl, CURLOPT_HTTPHEADER, array('Content-Type: application/json', 'accept: application/json'));
          curl_setopt($curl, CURLOPT_IPRESOLVE, CURL_IPRESOLVE_V4);
          $out = curl_exec($curl);
          echo $out;
          curl_close($curl);
      }
  ?>

<?php
      if( $curl = curl_init() ) {
          $jsonstr = '{"apiKey": "AbCd********", "sms": [{"channel":"char", "sender": "VIRTA" ,"text": "test1", "phone": "79*********", "plannedAt": 1490612400}, {"channel":"digit", "text": "test2", "phone": "79*********", "plannedAt": 1490612400}]}';
          curl_setopt($curl, CURLOPT_URL, 'https://admin.p1sms.kz/apiSms/create');
          curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
          curl_setopt($curl, CURLOPT_POST, true);
          curl_setopt($curl, CURLOPT_POSTFIELDS, $jsonstr);
          curl_setopt($curl, CURLOPT_HTTPHEADER, array('Content-Type: application/json', 'accept: application/json'));
          curl_setopt($curl, CURLOPT_IPRESOLVE, CURL_IPRESOLVE_V4);
          $out = curl_exec($curl);
          echo $out;
          curl_close($curl);
      }
  ?>

<?php
      $url = "https://admin.p1sms.kz/apiSms/create";
      $requestArray = array(
          'apiKey' => "AbCd****",
          'sms' => array(
              array(
                  'channel' => 'viber',
                  'sender' => 'TEST',
                  'text' => 'TEST',
                  'phone' => '79*********',
              'plannedAt' => 1510000000,
                  'viberParameters' => array(
              'type' => 'link',
              'btnLink' => 'https://link.example.com',
                      'btnText' => 'click me',
                      'imageHash' => '15a27ef2c31999.jpg',
               ),
              )),
          'webhookUrl' => 'https://yoursite.com/viberUpdateStatusWebhook',
          );
      $json = json_encode($requestArray, JSON_UNESCAPED_UNICODE);
      $curl = curl_init();
      curl_setopt($curl, CURLOPT_URL, $url);
      curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
      curl_setopt($curl, CURLOPT_POST, true);
      curl_setopt($curl, CURLOPT_POSTFIELDS, $json);
      curl_setopt($curl, CURLOPT_HTTPHEADER, array('Content-Type: application/json', 'accept: application/json'));
      curl_setopt($curl, CURLOPT_IPRESOLVE, CURL_IPRESOLVE_V4);
      $out = curl_exec($curl);
      $response = json_decode($out);
      curl_close($curl);
  ?>

<?php
      $url = "https://admin.p1sms.kz/apiSms/create";
      $requestArray = array(
          'apiKey' => "AbCd****",
          'sms' => array(
              array(
                  'channel' => 'vk',
                  'phone' => '79*********',
                  'plannedAt' => 1510000000,
                  'vkParameters' => array(
                      'templateId' => 1,
                      'tmpl_data' => '{"servicename":"yourorganization", "managername":"nameofyourmanager"}'
                  ),
              )),
          'webhookUrl' => 'https://yoursite.com/vkUpdateStatusWebhook',
      );
      $json = json_encode($requestArray, JSON_UNESCAPED_UNICODE);
      $curl = curl_init();
      curl_setopt($curl, CURLOPT_URL, $url);
      curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
      curl_setopt($curl, CURLOPT_POST, true);
      curl_setopt($curl, CURLOPT_POSTFIELDS, $json);
      curl_setopt($curl, CURLOPT_HTTPHEADER, array('Content-Type: application/json', 'accept: application/json'));
      curl_setopt($curl, CURLOPT_IPRESOLVE, CURL_IPRESOLVE_V4);
      $out = curl_exec($curl);
      $response = json_decode($out);
      curl_close($curl);
  ?>

<?php
      $url = "https://admin.p1sms.kz/apiSms/create";
      $requestArray = array(
          'apiKey' => "AbCd****",
          'sms' => array(
              array(
                  'channel' => 'viber',
                  'sender' => 'TEST',
                  'text' => 'TEST',
                  'phone' => '79*********',
              'plannedAt' => 1510000000,
                  'viberParameters' => array(
              'type' => 'link',
              'btnLink' => 'https://link.example.com',
                      'btnText' => 'click me',
                      'imageHash' => '15a27ef2c31999.jpg',
               ),
              )),
          'webhookUrl' => 'https://yoursite.com/viberUpdateStatusWebhook',
          );
      $json = json_encode($requestArray, JSON_UNESCAPED_UNICODE);
      $curl = curl_init();
      curl_setopt($curl, CURLOPT_URL, $url);
      curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
      curl_setopt($curl, CURLOPT_POST, true);
      curl_setopt($curl, CURLOPT_POSTFIELDS, $json);
      curl_setopt($curl, CURLOPT_HTTPHEADER, array('Content-Type: application/json', 'accept: application/json'));
      curl_setopt($curl, CURLOPT_IPRESOLVE, CURL_IPRESOLVE_V4);
      $out = curl_exec($curl);
      $response = json_decode($out);
      curl_close($curl);
  ?>

<?php
      $url = "https://admin.p1sms.kz/apiSms/create";
      $requestArray = array(
          'apiKey' => "AbCd****",
          'sms' => array(
              array(
                  'channel' => 'vk',
                  'phone' => '79*********',
                  'plannedAt' => 1510000000,
                  'vkParameters' => array(
                      'templateId' => 1,
                      'tmpl_data' => '{"servicename":"yourorganization", "managername":"nameofyourmanager"}'
                  ),
              )),
          'webhookUrl' => 'https://yoursite.com/vkUpdateStatusWebhook',
      );
      $json = json_encode($requestArray, JSON_UNESCAPED_UNICODE);
      $curl = curl_init();
      curl_setopt($curl, CURLOPT_URL, $url);
      curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
      curl_setopt($curl, CURLOPT_POST, true);
      curl_setopt($curl, CURLOPT_POSTFIELDS, $json);
      curl_setopt($curl, CURLOPT_HTTPHEADER, array('Content-Type: application/json', 'accept: application/json'));
      curl_setopt($curl, CURLOPT_IPRESOLVE, CURL_IPRESOLVE_V4);
      $out = curl_exec($curl);
      $response = json_decode($out);
      curl_close($curl);
  ?>

<?php
      if( $curl = curl_init() ) {
          $url = "https://admin.p1sms.kz/apiSms/create";
          $params = [
            "apiKey" => "XXXXXXX",
            "sms" => [
              [
                "channel" => "telegram",
                "phone" => "7919XXXXXXX",
                "text" => "test",
                "telegramChatIds" => [999999999], // Можно установить ID чатов в телеграме, в которые нужно послать сообщение(у одного номера телефона может быть привязано несколько чатов)
                "tgParameters" => [
                  "botUsername" => "p1sms_test_bot",
                  "content" => [
                    [ //Отправляем основное сообщение
                      "baseMessage" => true, // В таком случае можно не указывать message - отправится то, что указано в качестве текста у смс. Если указать другой текст - основное сообщение(в данном случае "test") не будет отправлено
                      "priority" => 1, //Указываем то, что это сообщение должно отправиться самым первым
                      "buttons" => [ //Отправляем кнопки, которые будут являться inline-клавиатурой у сообщения
                        [
                            "caption" => "Нажми меня и перейди на наш сайт!",
                            "rowPriority" => 1, // Порядок кнопки в строках
                            "columnPriority" => 1, //Порядок кнопки в столбцах
                            "redirectUrl" => "https =>//admin.p1sms.kz",
                            "removeKeyboard" => true // Удалять после нажатия inline-клавиатуру, или нет
                        ]
                      ]
                    ],
                    [ // Отправляем какой то документ клиенту
                      "message" => "Подпись к документу, будет видна ниже прикрепляемого документа",
                      "fileId" => 1, //Идентификатор для отправляемого файла. Загружать можно по пути apiTelegramBots/files/upload
                      "priority" => 2,
                      "buttons" => [
                        [
                            "caption" => "Получить текущий курс доллара",
                            "rowPriority" => 1,
                            "columnPriority" => 1,
                            "action" => [ // Новое созданное действие идёт всегда в приоритете перед actionId(в случае если будут переданы оба параметра).
                              "name" => "get dollar rate",
                              "message" => "Текущий курс доллара => #rate# руб.",
                              "remoteScriptUrl" => "https =>//admin.p1sms.kz/api/telegramBots/getRate", //Вебхук на Ваш сервис. Формат входных и выходных данных можно увидеть в примере про вебхуки(читай ниже)
                              "tgParameters" => [ //Все параметры полностью аналогичны параметрам, указанным в текущем примере
                                "botUsername" => "p1sms_test_bot"
                              ]
                            ]
                        ],
                        [
                            "caption" => "Сделать какое-то действие",
                            "rowPriority" => 1,
                            "columnPriority" => 1,
                            "actionId" => 1 // Можно указать идентификатор уже созданного действия(по API или из ЛК), получить можно с помощью apiTelegramBots/actions/get
                        ]
                      ]
                    ]
                  ]
                ]
              ]
            ]
          ];
          $json = json_encode($params, JSON_UNESCAPED_UNICODE);
          $curl = curl_init();
          curl_setopt($curl, CURLOPT_URL, $url);
          curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
          curl_setopt($curl, CURLOPT_POST, true);
          curl_setopt($curl, CURLOPT_POSTFIELDS, $json);
          curl_setopt($curl, CURLOPT_HTTPHEADER, array('Content-Type: application/json', 'accept: application/json'));
          curl_setopt($curl, CURLOPT_IPRESOLVE, CURL_IPRESOLVE_V4);
          $out = curl_exec($curl);
          $response = json_decode($out);
          curl_close($curl);
      }
  ?>?>

POST /yourUrl
  {
    "spamBotId": 1, // Идентификатор телеграм бота
    "chatId": 999999999, //Идетификатор чата с клиентом
    "actionId": 1, // Идентификатор действия, которое вызвало вебхук
    "actionName": "unsubscribe", //Название действия, которое вызвало вебхук
    "variables": [{ // Переменные, которые будут использовать при заменах конечного сообщения
      "firstName": "first name of client",
      "lastName": "last name of client",
      "phone": "7999XXXXXXX"
    }],
    "parameters": "параметр1 параметр2 параметр3", //Параметры(строка), указанные при вызове команды. Если параметров не было - параметра не будет во входных данных. В данном примере могла быть вызвана команда /test параметр1 параметр2 параметр3
    "messageId": 999888777 //Идентификатор сообщения, у которого была нажата кнопка, которое вызвало данное действие. Если кнопки не было - параметра не будет во входных данных
  }

  {}

 {
    "message": "Новое сообщение с новой переменной #var1# и переменной, которая уже есть у нас: #firstName#", // Сообщение, которое заменит сообщение указанное как baseMessage в одном из telegramParameters.content массиве
    "variables": [{ // Дополнительные переменные, которые будут использоваться при отправке сообщения. Если новых переменных не будет - параметр не обязателен
      "var1": "переменная 1"
    }],
    "tgParameters": { //Все параметры телеграм сообщений совпадают с теми, которые используются при создании сообщения. Если не требуется менять content - параметр не обязателен
      "botUsername": "p1sms_bot",
      "content": [
        {
          "baseMessage": true,
          "priority": 1
        }
      ]
    }
  }

<?php
     $url = "https://admin.p1sms.kz/apiSms/create";
     $params = json_decode('{
        "apiKey":"AbCd****",
        "sms":[
           {
              "channel":"viber",
              "phone":"79*********",
              "sender":"VIRTA",
              "text":"text viber message 2",
              "viberParameters":{
                 "type":"text",
                 "smsLifetime":60000
              },
              "cascade":{
                 "name":"API CASCADE TEST",
                 "schemeDetail":[
                    {
                       "needStatus":"not_delivered",
                       "smstemplate":{
                          "channel":"char",
                          "texts":[
                             "test cascade message 2"
                          ],
                          "sender":"VIRTA"
                       }
                    }
                 ]
              }
           }
        ]
     }', true);
     $curl = curl_init();
     curl_setopt($curl, CURLOPT_URL, $url);
     curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
     curl_setopt($curl, CURLOPT_POST, true);
     curl_setopt($curl, CURLOPT_POSTFIELDS, $params);
     curl_setopt($curl, CURLOPT_HTTPHEADER, array('Content-Type: application/json', 'accept: application/json'));
     curl_setopt($curl, CURLOPT_IPRESOLVE, CURL_IPRESOLVE_V4);
     $out = curl_exec($curl);
     $response = json_decode($out);
     curl_close($curl);
  ?>

                                        {
      "status": "success",
      "data": [
          {
              "message": "test1 _\\",
              "id": 370506708,
              "status": "sent",
              "phone": "79991002233"
          },
          {
              "message": "test2 (/",
              "id": 370506709,
              "status": "sent",
              "phone": "79991112233"
          }
      ]
  }

Запрос на отправку сообщения

URL:

https://admin.p1sms.kz/apiSms/get

Метод:

post

Пример на PHP

<?php
      $jsonstr = '{"apiKey": "AbCd********", "apiSmsIdList": [1, 2, 3, 4, 5]}';
      if( $curl = curl_init() ) {
          curl_setopt($curl, CURLOPT_URL, 'https://admin.p1sms.kz/apiSms/get');
          curl_setopt($curl, CURLOPT_POST, true);
          curl_setopt($curl, CURLOPT_POSTFIELDS, $jsonstr);
          curl_setopt($curl, CURLOPT_HTTPHEADER, array('Content-Type: application/json', 'accept: application/json'));
          curl_setopt($curl, CURLOPT_IPRESOLVE, CURL_IPRESOLVE_V4);
          $out = curl_exec($curl);
          echo $out;
          curl_close($curl);
      }
  ?>

Пример на 1с

Соединение = Новый HTTPСоединение("https://admin.p1sms.kz/apiSms/",,,,,, Новый ЗащищенноеСоединениеOpenSSL());
   Запрос = Новый HTTPЗапрос("get");
   Запрос.Заголовки.Вставить("Content-Type", "application/json");
   Запрос.Заголовки.Вставить("accept", "application/json");
   Запрос.УстановитьТелоИзСтроки("{""apiKey"": ""AbCd********"",
                                   ""apiSmsIdList"": [1, 2, 3, 4, 5]}",
      "utf-8", ИспользованиеByteOrderMark.НеИспользовать);
   Ответ = Соединение.ОтправитьДляОбработки(Запрос);
   ТелоОтвет = Ответ.ПолучитьТелоКакСтроку();
                            

Пример ответа

                                      {
      "status": "success",
      "data": [
         {
             "id": "7777000",
             "errorDescription": null,
             "cost": "0.50",
             "createdAt": 1504988172,
             "updatedAt": 1504988191,
             "cascadeSmsId": null,
             "status": "delivered",
         }
      ],
  }

Запрос на создание схемы каскадных сообщений

URL:

https://admin.p1sms.kz/apiSms/create

Метод:

post

Пример PHP

<?php
      $params = json_decode('{
         "apiKey": "AbCd****",
         "cascade": {
             "name": "Api_Cascadee_Template_1",
             "schemeDetail":[
                {
                   "needStatus":"delivered",
                   "smstemplate":{
                      "channel":"digit",
                      "texts":[
                         "test"
                      ],
                      "minutesDelay":60,
                      "sendStartTime":420,
                      "sendEndTime":1020
                   },
                   "schemeDetail":[
                      {
                         "needStatus":"delivered",
                         "smstemplate":{
                            "channel":"digit",
                            "texts":[
                               "test2"
                            ],
                            "sendStartTime":420,
                            "sendEndTime":960
                         }
                      }
                   ]
                },
                {
                   "needStatus":"not_delivered",
                   "smstemplate":{
                      "channel":"digit",
                      "texts":[
                         "test"
                      ]
                   }
                }
             ]
         }

      }', true);
      $url = https://admin.p1sms.kz/apiSms/createCascadeScheme";
      $curl = curl_init();
      curl_setopt($curl, CURLOPT_URL, $url);
      curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
      curl_setopt($curl, CURLOPT_POST, true);
      curl_setopt($curl, CURLOPT_POSTFIELDS, $params);
      curl_setopt($curl, CURLOPT_HTTPHEADER, array('Content-Type: application/json', 'accept: application/json'));
      curl_setopt($curl, CURLOPT_IPRESOLVE, CURL_IPRESOLVE_V4);
      $out = curl_exec($curl);
      $response = json_decode($out);
      curl_close($curl);
  ?>

Загрузка изображения для Viber

URL:

https://admin.p1sms.kz/apiSms/loadImage

Метод:

post

Пример PHP

<?php
      $url = https://admin.p1sms.kz/apiSms/loadImage";
      $requestArray = array(
          'apiKey' => "AbCd****",
          'img' => new \CURLFile('/path_to_file/image.jpg'),
      );
      $curl = curl_init();
      curl_setopt($curl, CURLOPT_URL, $url);
      curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
      curl_setopt($curl, CURLOPT_POST, true);
      curl_setopt($curl, CURLOPT_POSTFIELDS, $requestArray);
      curl_setopt($curl, CURLOPT_HTTPHEADER, array('Content-Type: multipart/form-data', 'accept: multipart/form-data'));
      curl_setopt($curl, CURLOPT_IPRESOLVE, CURL_IPRESOLVE_V4);
      $out = curl_exec($curl);
      $response = json_decode($out);
      curl_close($curl);
  ?>
                            

Пример ответа

{
  "status": "success",
  "data": {},
  }

Запрос статуса сообщения

URL:

https://admin.p1sms.kz/apiSms/getSmsStatus

Метод:

get

Пример PHP

<?php
      $url = https://admin.p1sms.kz/apiSms/getSmsStatus?apiKey=AbCd****&smsId[0]=1&smsId[1]=2&smsId[2]=3";
      $curl = curl_init();
      curl_setopt($curl, CURLOPT_URL, $url);
      curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
      curl_setopt($curl, CURLOPT_HTTPHEADER, array('Content-Type: application/json', 'accept: application/json'));
      curl_setopt($curl, CURLOPT_IPRESOLVE, CURL_IPRESOLVE_V4);
      $out = curl_exec($curl);
      $response = json_decode($out);
      curl_close($curl);
  ?>

Пример ответа

[
      {
          "sms_id": 2222,
          "sms_status": "delivered",
          "receive_date": "2019-11-18 16:00:53"
      }
  ]

Запрос на получение баланса

URL:

https://admin.p1sms.kz/apiUsers/getUserBalanceInfo

Метод:

get

Пример PHP

<?php
      $url = https://admin.p1sms.kz/apiUsers/getUserBalanceInfo?apiKey=arEre****";
      $curl = curl_init();
      curl_setopt($curl, CURLOPT_URL, $url);
      curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
      curl_setopt($curl, CURLOPT_HTTPHEADER, array('Content-Type: application/json', 'accept: application/json'));
      curl_setopt($curl, CURLOPT_IPRESOLVE, CURL_IPRESOLVE_V4);
      $out = curl_exec($curl);
      $response = json_decode($out);
      curl_close($curl);
  ?>

Пример ответа

{
  "status": "success",
  "data": "15.0000"
  }

Запрос на получения списка отправителей

URL:

https://admin.p1sms.kz/apiUsers/getUserSenders

Метод:

get

Пример PHP

<?php
      $url = https://admin.p1sms.kz/apiUsers/getUserSenders?apiKey=arEre****";
      $curl = curl_init();
      curl_setopt($curl, CURLOPT_URL, $url);
      curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
      curl_setopt($curl, CURLOPT_HTTPHEADER, array('Content-Type: application/json', 'accept: application/json'));
      curl_setopt($curl, CURLOPT_IPRESOLVE, CURL_IPRESOLVE_V4);
      $out = curl_exec($curl);
      $response = json_decode($out);
      curl_close($curl);
  ?>

Пример ответа

{
      "status": "success",
      "data": [
            {
          "senderName": "SENDER",
          "status": null
          }
      ],
  }

Запрос на получение списка отправленных сообщений

URL:

https://admin.p1sms.kz/apiSms/getSmsList

Метод:

get

Пример PHP

<?php
      $url = https://admin.p1sms.kz/apiSms/getSmsList?apiKey=arEre****";
      $curl = curl_init();
      curl_setopt($curl, CURLOPT_URL, $url);
      curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
      curl_setopt($curl, CURLOPT_HTTPHEADER, array('Content-Type: application/json', 'accept: application/json'));
      curl_setopt($curl, CURLOPT_IPRESOLVE, CURL_IPRESOLVE_V4);
      $out = curl_exec($curl);
      $response = json_decode($out);
      curl_close($curl);
  ?>

Пример ответа

{
      "status": "success",
      "data": [
          {
          "smsId": 9345490,
          "receiveDate": {
              "date": "2019-04-18 07:05:12.000000",
              "timezone_type": 3,
              "timezone": "UTC"
          },
          "senderPhone": "72343534534",
          "phone": "79091112233",
          "text": "test1 ]-"
          },
          ]
  }

Запрос на получение информации по номеру телефона

URL:

https://admin.p1sms.kz/apiPhones/getPhoneInfo

Метод:

get

Пример PHP

<?php
      $url = https://admin.p1sms.kz/apiPhones/getPhoneInfo?apiKey=arEre****";
      $curl = curl_init();
      curl_setopt($curl, CURLOPT_URL, $url);
      curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
      curl_setopt($curl, CURLOPT_HTTPHEADER, array('Content-Type: application/json', 'accept: application/json'));
      curl_setopt($curl, CURLOPT_IPRESOLVE, CURL_IPRESOLVE_V4);
      $out = curl_exec($curl);
      $response = json_decode($out);
      curl_close($curl);
  ?>

Пример ответа

{
      "status": "success",
      "data": {
          "phone": "79091111212",
          "operator": "Теле2",
          "region": "Пермский край",
          "additionalInfo": null
      }
  }

Запрос на получение информации об операторах по номерам телефонов

URL:

https://admin.p1sms.kz/api/v2/phones

Метод:

get

Пример PHP

<?php
      $url = https://admin.p1sms.kz/api/v2/phones?p[0]=79637303932&apiKey=8xn****7cbms;
      $curl = curl_init();
      curl_setopt($curl, CURLOPT_URL, $url);
      curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
      curl_setopt($curl, CURLOPT_HTTPHEADER, array('Content-Type: application/json', 'accept: application/json'));
      curl_setopt($curl, CURLOPT_IPRESOLVE, CURL_IPRESOLVE_V4);
      $out = curl_exec($curl);
      $response = json_decode($out);
      curl_close($curl);
  ?>

Пример ответа

{
      "status": "success",
      "data": {
          "79637303932": {
              "operator": "Билайн",
              "country": "Россия",
              "region": "Вологодская область",
          }
      }
  }

Запрос на получение списка баз

URL:

https://admin.p1sms.kz/apiUsers/getUserBases

Метод:

get

Пример PHP

<?php
      $url = https://admin.p1sms.kz/apiUsers/getUserBases?apiKey=arEre****";
      $curl = curl_init();
      curl_setopt($curl, CURLOPT_URL, $url);
      curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
      curl_setopt($curl, CURLOPT_HTTPHEADER, array('Content-Type: application/json', 'accept: application/json'));
      curl_setopt($curl, CURLOPT_IPRESOLVE, CURL_IPRESOLVE_V4);
      $out = curl_exec($curl);
      $response = json_decode($out);
      curl_close($curl);
  ?>

Пример ответа

{
      "status": "success",
      "data": [
          {
          "baseId": 4464,
          "baseName": "18.04.2019 (14:38:33)"
          }
      ],
  }

Запрос на получение списка абонентов базы

URL:

https://admin.p1sms.kz/apiUsers/getBasePhones

Метод:

get

Пример PHP

<?php
      $url = https://admin.p1sms.kz/apiUsers/getBasePhones?apiKey=arEre****";
      $curl = curl_init();
      curl_setopt($curl, CURLOPT_URL, $url);
      curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
      curl_setopt($curl, CURLOPT_HTTPHEADER, array('Content-Type: application/json', 'accept: application/json'));
      curl_setopt($curl, CURLOPT_IPRESOLVE, CURL_IPRESOLVE_V4);
      $out = curl_exec($curl);
      $response = json_decode($out);
      curl_close($curl);
  ?>

Пример ответа

{
      "status": "success",
      "data": {
          "total": 4,
          "perPage": 100,
          "currentPage": 1,
          "lastPage": 1,
          "nextPageUrl": null,
          "prevPageUrl": null,
          "from": 1,
          "to": 4,
          "data": [
                {
              "phone": "79092342312"
              },
                {
              "phone": "79091234353"
              },
                {
              "phone": "79091233523"
              },
                {
              "phone": "79091141212"
              }
          ],
      }
  }

Запрос на добавление номера телефона в базу номеров

URL:

https://admin.p1sms.kz/apiPhoneBases/{phone_base_id}/phones

Метод:

POST

Пример PHP

<?php
      $params = json_decode('{
         "apiKey":"arEre****",
         "phones":[
            {
               "phone":"79999996669"
            },
            {
               "phone":"Номер_2"
            }
         ]
      }', true);
      $url = https://admin.p1sms.kz/apiPhoneBases/999999/phones";
      $curl = curl_init();
      curl_setopt($curl, CURLOPT_URL, $url);
      curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
      curl_setopt($curl, CURLOPT_POST, true);
      curl_setopt($curl, CURLOPT_POSTFIELDS, $params);
      curl_setopt($curl, CURLOPT_HTTPHEADER, array('Content-Type: application/json', 'accept: application/json'));
      curl_setopt($curl, CURLOPT_IPRESOLVE, CURL_IPRESOLVE_V4);
      $out = curl_exec($curl);
      $response = json_decode($out);
      curl_close($curl);
  ?>

Пример ответа

{
      "status": "success",
      "data": {
          "total": 4,
          "perPage": 100,
          "currentPage": 1,
          "lastPage": 1,
          "nextPageUrl": null,
          "prevPageUrl": null,
          "from": 1,
          "to": 4,
          "data": [
                {
              "phone": "79092342312"
              },
                {
              "phone": "79091234353"
              },
                {
              "phone": "79091233523"
              },
                {
              "phone": "79091141212"
              }
          ],
      }
  }

Запрос на получение списка номеров из черного списка

URL:

https://admin.p1sms.kz/apiUsers/getUserBlacklist

Метод:

GET

Пример PHP

<?php
      $url = https://admin.p1sms.kz/apiUsers/getUserBlacklist?apiKey=arEre****";
      $curl = curl_init();
      curl_setopt($curl, CURLOPT_URL, $url);
      curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
      curl_setopt($curl, CURLOPT_HTTPHEADER, array('Content-Type: application/json', 'accept: application/json'));
      curl_setopt($curl, CURLOPT_IPRESOLVE, CURL_IPRESOLVE_V4);
      $out = curl_exec($curl);
      $response = json_decode($out);
      curl_close($curl);
  ?>

Пример ответа

{
      "status": "success",
      "data": [
          {
          "phone": "71231231211",
          "additionalInfo": null
          }
      ],
  }

Запрос на получение списка запланированных сообщений

URL:

https://admin.p1sms.kz/apiUsers/getPlannedSms

Метод:

GET

Пример PHP

<?php
      $url = https://admin.p1sms.kz/apiUsers/getPlannedSms?apiKey=arEre****";
      $curl = curl_init();
      curl_setopt($curl, CURLOPT_URL, $url);
      curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
      curl_setopt($curl, CURLOPT_HTTPHEADER, array('Content-Type: application/json', 'accept: application/json'));
      curl_setopt($curl, CURLOPT_IPRESOLVE, CURL_IPRESOLVE_V4);
      $out = curl_exec($curl);
      $response = json_decode($out);
      curl_close($curl);
  ?>

Пример ответа

{
  "status":"success",
  "data":
  []
  }

Запрос на просмотр доступных шаблонов Вконтакте

URL:

https://admin.p1sms.kz/apiSms/listMessageTemplates

Метод:

GET

Пример PHP

<?php
      $url = https://admin.p1sms.kz/apiSms/listMessageTemplates?apiKey=AbCd****";
      $curl = curl_init();
      curl_setopt($curl, CURLOPT_URL, $url);
      curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
      curl_setopt($curl, CURLOPT_HTTPHEADER, array('Content-Type: application/json', 'accept: application/json'));
      curl_setopt($curl, CURLOPT_IPRESOLVE, CURL_IPRESOLVE_V4);
      $out = curl_exec($curl);
      $response = json_decode($out);
      curl_close($curl);
  ?>

Пример ответа

{
      "status": "success",
      "data": [
          {
          "id": 14,
          "name": "zvonobot_communicate_soon",
          "status": "available",
          "tmpl": "Наш специалист в ближайшее время свяжется в вами, #user#",
          "vkGroupUrl": "https://vk.com/zvonobot",
          "okGroupUrl": null,
          "attdir": null,
          "attachments": [],
          }
      ],
  }

Запрос на просмотр доступных шаблонов каскадных сообщений

URL:

https://admin.p1sms.kz/apiSms/getCascadeSchemes

Метод:

GET

Пример PHP

<?php
      $url = https://admin.p1sms.kz/apiSms/getCascadeSchemes?apiKey=AbCd****";
      $curl = curl_init();
      curl_setopt($curl, CURLOPT_URL, $url);
      curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
      curl_setopt($curl, CURLOPT_HTTPHEADER, array('Content-Type: application/json', 'accept: application/json'));
      curl_setopt($curl, CURLOPT_IPRESOLVE, CURL_IPRESOLVE_V4);
      $out = curl_exec($curl);
      $response = json_decode($out);
      curl_close($curl);
  ?>

Запрос на получение списка Telegram ботов

URL:

URL: https://admin.p1sms.kz/apiTelegramBots/get

Метод:

GET

Пример PHP

<?php
      $url = https://admin.p1sms.kz/apiTelegramBots/get?apiKey=AbCd****";
      $curl = curl_init();
      curl_setopt($curl, CURLOPT_URL, $url);
      curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
      curl_setopt($curl, CURLOPT_HTTPHEADER, array('Content-Type: application/json', 'accept: application/json'));
      curl_setopt($curl, CURLOPT_IPRESOLVE, CURL_IPRESOLVE_V4);
      $out = curl_exec($curl);
      $response = json_decode($out);
      curl_close($curl);
  ?>

Пример ответа

{
      "status": "success",
      "data": [
          {
              "id": 4,
              "name": "Тестовый бот",
              "username": "test1111_bot",
              "welcomeMessage": "Вас приветствует тестовый бот!",
              "phoneInputMessage": "Укажите ваш номер телефона",
              "lang": "ru",
              "createdAt": 1589810295,
              "updatedAt": 1589810295,
          }
      ]
  }

Запрос на получение списка файлов для Telegram

URL:

https://admin.p1sms.kz/apiTelegramBots/files/get

Метод:

GET

Пример PHP

<?php
      $url = https://admin.p1sms.kz/apiTelegramBots/files/get?apiKey=AbCd****&botUsername=test111_bot";
      $curl = curl_init();
      curl_setopt($curl, CURLOPT_URL, $url);
      curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
      curl_setopt($curl, CURLOPT_HTTPHEADER, array('Content-Type: application/json', 'accept: application/json'));
      curl_setopt($curl, CURLOPT_IPRESOLVE, CURL_IPRESOLVE_V4);
      $out = curl_exec($curl);
      $response = json_decode($out);
      curl_close($curl);
  ?>
                   

Запрос на загрузку файла для Telegram

URL:

https://admin.p1sms.kz/apiTelegramBots/actions/get

Метод:

GET

Пример PHP

<?php
      $url = https://admin.p1sms.kz/apiTelegramBots/actions/get?apiKey=AbCd****&botUsername=test111_bot";
      $curl = curl_init();
      curl_setopt($curl, CURLOPT_URL, $url);
      curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
      curl_setopt($curl, CURLOPT_HTTPHEADER, array('Content-Type: application/json', 'accept: application/json'));
      curl_setopt($curl, CURLOPT_IPRESOLVE, CURL_IPRESOLVE_V4);
      $out = curl_exec($curl);
      $response = json_decode($out);
      curl_close($curl);
  ?>

Запрос на создание нового действия для Telegram

URL:

https://admin.p1sms.kz/apiTelegramBots/files/upload

Метод:

POST

Пример PHP

<?php
      $url = https://admin.p1sms.kz/apiTelegramBots/files/upload";
      $requestArray = array(
          "botUsername" => "p1sms_bot",
          "name" => "Новое действие", // Название действие, возвращается в вебхуке
          "comment" => "Комментарий",
          "message" => "Совершено действие 1", //baseMessage у нового действия
          "tgParameters" => [], // По аналогии с выше
          "remoteScriptUrl" => "https://admin.p1sms.kz/api/actions/getRate", //Webhook на удалённый адрес
           mayUsedAsButton" => false, // Может ли данное действие использоваться в клавиатуре у телеграма ( если есть обязательные параметры - не может)

      );
      $json = json_encode($requestArray, JSON_UNESCAPED_UNICODE);
      $curl = curl_init();
      curl_setopt($curl, CURLOPT_URL, $url);
      curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
      curl_setopt($curl, CURLOPT_POST, true);
      curl_setopt($curl, CURLOPT_POSTFIELDS, $json);
      curl_setopt($curl, CURLOPT_HTTPHEADER, array('Content-Type: application/json', 'accept: application/json'));
      curl_setopt($curl, CURLOPT_IPRESOLVE, CURL_IPRESOLVE_V4);
      $out = curl_exec($curl);
      $response = json_decode($out);
      curl_close($curl);
  ?>

Пример тела запроса remoteScriptUrl

POST /yourUrl
  {
    "spamBotId": 1, // Идентификатор телеграм бота
    "chatId": 999999999, //Идетификатор чата с клиентом
    "actionId": 1, // Идентификатор действия, которое вызвало вебхук
    "actionName": "unsubscribe", //Название действия, которое вызвало вебхук
    "variables": [{ // Переменные, которые будут использовать при заменах конечного сообщения
      "firstName": "first name of client",
      "lastName": "last name of client",
      "phone": "7999XXXXXXX"
    }],
    "parameters": "параметр1 параметр2 параметр3", //Параметры(строка), указанные при вызове команды. Если параметров не было - параметра не будет во входных данных. В данном примере могла быть вызвана команда /test параметр1 параметр2 параметр3
    "messageId": 999888777 //Идентификатор сообщения, у которого была нажата кнопка, которое вызвало данное действие. Если кнопки не было - параметра не будет во входных данных
  }

Ответ вашего сервера на webhook remoteScriptUrl (Status code: 200)
Если не требуется совершать никаких действий, менять сообщение

    {}

Если требуется изменить сообщение

  {}{
    "message": "Новое сообщение с новой переменной #var1# и переменной, которая уже есть у нас: #firstName#", // Сообщение, которое заменит сообщение указанное как baseMessage в одном из telegramParameters.content массиве
    "variables": [{ // Дополнительные переменные, которые будут использоваться при отправке сообщения. Если новых переменных не будет - параметр не обязателен
      "var1": "переменная 1"
    }],
    "tgParameters": { //Все параметры телеграм сообщений совпадают с теми, которые используются при создании сообщения. Если не требуется менять content - параметр не обязателен
      "botUsername": "p1sms_bot",
      "content": [
        {
          "baseMessage": true,
          "priority": 1
        }
      ]
    }
  }

Запрос на генерацию ссылок для пользователей Telegram бота

URL:

https://admin.p1sms.kz/apiTelegramBots/getLinks

Метод:

POST

Пример PHP

<?php
      $url = https://admin.p1sms.kz/apiTelegramBots/getLinks?apiKey=AbCd****&botUsername=test1111_bot&phones[]=79991234455";
      $curl = curl_init();
      curl_setopt($curl, CURLOPT_URL, $url);
      curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
      curl_setopt($curl, CURLOPT_HTTPHEADER, array('Content-Type: application/json', 'accept: application/json'));
      curl_setopt($curl, CURLOPT_IPRESOLVE, CURL_IPRESOLVE_V4);
      $out = curl_exec($curl);
      $response = json_decode($out);
      curl_close($curl);
  ?>

Пример ответа

{
      "status": "success",
      "data": [
          {
              "phone": "79991234455",
              "link": "t.me/test1111_bot?start=fgdf",
          }
      ]
  }

Коды ошибок

Статусы рассылок

Запрос на просмотр статистики

URL:

https://admin.p1sms.kz/api/statistics

Метод:

GET

Пример PHP

<?php
      $url = https://admin.p1sms.kz/api/statistics?startDate=15554****";
      $curl = curl_init();
      curl_setopt($curl, CURLOPT_URL, $url);
      curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
      curl_setopt($curl, CURLOPT_HTTPHEADER, array('Content-Type: application/json', 'accept: application/json'));
      curl_setopt($curl, CURLOPT_IPRESOLVE, CURL_IPRESOLVE_V4);
      $out = curl_exec($curl);
      $response = json_decode($out);
      curl_close($curl);
  ?>

Пример ответа

{
      "status": "success",
      "data": [
          {
          "delivered": 0,
          "read": 0,
          "notDelivered": 0,
          "sent": 0,
          "cost": null,
          "smsCount": null,
          "compensation": null
          }
      ],
  }

Запрос на просмотр статистики (Новый)

URL:

https://admin.p1sms.kz/api/statistics

Метод:

GET

Пример ответа

{
  "status": "success",
  "data": [
      {
          "currency": "USD",
          "cCost": 0.16,
          "cComp": 0,
          "notDelivered": 0,
          "delivered": 4,
          "read": 0,
          "sent": 0,
          "totalSent": 4,
          "cesCost": 0.9,
          "pesCost": 0,
          "esNotDelivered": 0,
          "esDelivered": 1,
          "esRead": 0,
          "esSent": 0,
          "esTotalSent": 1,
          "notSended": 0,
          "esNotSended": 0
      },
      {
          "currency": "RUB",
          "cCost": 553.3,
          "cComp": 69.34,
          "notDelivered": 23,
          "delivered": 200,
          "read": 7,
          "sent": 14,
          "totalSent": 273,
          "cesCost": 0.9,
          "pesCost": 0,
          "esNotDelivered": 0,
          "esDelivered": 1,
          "esRead": 0,
          "esSent": 0,
          "esTotalSent": 2,
          "notSended": 29,
           "esNotSended": 1
      }
  ]
  }
          "smsCount": null,
          "compensation": null
          }
      ],
  }