Документация проекта


    • 📡 API для интеграции с приложением и облачными сервисами «СМС-Визитка»


      Через мобильное приложение «СМС-Визитка» доступны каналы: SMS, WhatsApp, Viber, Telegram .

      Через облако доступны каналы: MAX, WhatsApp, Telegram-бот.

      Можно использовать приложение и облако совместно, включая каскадный режим рассылок: Облако → Приложение: 

      Telegram-бот → WhatsApp → MAX → SMS.


      🚀 Как подключить интеграцию

      1. Установите приложение "СМС-Визитка" на android телефон 

            4.   Скопируйте ключ API, это будет api_key для метода send-sms

      Или

      Чтобы подключить тестовый период облачных  🟢 виджетов MAX, WhatsApp, Telegram-бота на 7 дней, выполните, пожалуйста, следующие шаги:

      1️⃣ Перейдите по ссылке: https://onlinevizitka.com/login/

      2️⃣ Авторизуйтесь через Google-аккаунт

      3️⃣ Заполните профиль (название, номер, краткое описание)

      4️⃣ Пришлите нам почту, с которой вы вошли на наш WhatsApp https://wa.me/79277101234


      ПРИМЕР api

      1 ВАРИАНТ (аналог старого api)

      Ответ в web-странице

      https://onlinevizitka.com/api/v2/send-sms/?api_key=7777777777777&to=89171234567&text=Сообщение

      “/” - обязателен в конце URL после “send-sms” 


      2 ВАРИАНТ

      Ответ в джейсоне.

      https://onlinevizitka.com/api/v2/send-sms/?api_key=7777777777777&format=json&to=89171234567&text=ТекстСообщения

      “/” - обязателен в конце URL после “send-sms” 


      3 ВАРИАНТ 

      через POST запрос

      —-----------------

      curl --location 'https://onlinevizitka.com/api/v2/send-sms/' \

      --header 'Content-Type: application/json' \

      --data '{

          "api_key": "777777777777",

          "to": "89171234567",

          "text": "Тест"

      }'

      —------------------
      wget --method POST --header "Content-Type: application/json" --body-data '{"api_key": "777777777777", "to": "89171234567", "text": "ТЕКСТ СООБЩЕНИЯ"}' --no-verbose --output-document - https://onlinevizitka.com/api/v2/send-sms/

      “/” - обязателен в конце URL после “send-sms” 


      МЕТОД SEND-SMS ПРИНИМАЕТ ПАРАМЕТРЫ:

      api_key - ключ api из вашего android приложения ( находится в настройках приложения - Интеграция - копировать ключ)

      to - номер телефона, на который необходимо отправить смс. В POST запросе можно указывать несколько номеров для отправки через запятую.

      text - текст сообщения (лимит до 1 000 символов в Get запросе, и до 2 000 символов в Post запросе)


      type_sender - необязательный параметр.

      Это - тип мессенджера. Определяет по какому каналу отправить сообщение. Работает в приложении СМС-Визитка на версии 7.*.*.* и выше.

      type_sender=0 - отправка по умолчанию, как указано в приложении, так и будет отправляться,

      type_sender=1 - отправить через Whatsapp,

      type_sender=2 - отправить через Whatsapp Business,

      type_sender=3 - отправить через Viber,

      type_sender=4 - отправить через Sms.

      type_sender=10 - отправить через Telegram 

      type_sender=11 - отправить через Telegram X

      type_sender=12 - отправить через Telegram Web


      ОТЛОЖЕННАЯ РАССЫЛКА

      Если добавить параметры к запросу: &delay_duration=1&delay=0&text=текст.

      То  текст отправится с задержкой через 1 минуту

      Пример GET запроса:

      https://onlinevizitka.com/api/v2/send-sms/?api_key=7777777777777&format=json&to=89171234567&text=ТекстСообщения&delay_duration=1&delay=0

      ------------

      🤝 Тех. поддержка  СМС-Визитка

      ❔ По вопросам можно писать, звонить или отправлять голосовые сообщения на WhatsApp:

       https://wa.me/79277101234

      📱тел.: +7(927)-71-01234

      support@smsvizitka.com

      Чтение и запись входящих сообщений полученных с MAX, WhatsApp. 

      Отчет об отправки MAX, WhatsApp, Viber, Telegram и sms в вашу CRM систему или на сервер.


      Установите приложения с Google Play:

      https://play.google.com/store/apps/details?id=com.smsvizitka.smsvizitka

      и скачайте последнее обновление - полную версию с доступом к СМС с Google диска.

      https://drive.google.com/drive/folders/1ZI-QdQAq7-mbRKGxOF3Tdxr9rPFG6trU

      ✅ Открывайте ссылку через Google Диск (установите приложение Google Диск, если его нет),

      ✅ Скачайте файл и откройте его

      ✅ Установка пакетов

      ✅  Настройки, разрешите установку с других источников, далее НАЗАД

      ✔  Установить приложение


      После установки, откройте меню, настройки, интеграция. 

      Далее в самом низу - кнопка “Сторонние сервисы”.

      Нажмите “Добавить сервер”. 

      Укажите имя сервера и ваш url - куда будут отправляться данные.

      POST - Запрос

            Тело запроса FormUrlEncoded

            Ответы в формате JSON.

            В заголовках запроса указано

            "Content-Type" = "application/json"

            А так же можно вставить свои значения типа String

            Пример:

            "Servicekey" = "АпиКлюч"


      Параметры запроса:

      action   - Int    - Id действия

      1 - Отправлено

      2 - Доставлено

      3 - Ошибка

      4 - Принятое сообщение от клиента

      5 - в очереди на отправку

      10 - окончена работа с пушом

      action - может приходить в нескольких запросах под разными цифрами.

      Поэтому его не нужно использовать для определения статуса отправки сообщения.


      SendingStatus - описанный ниже рекомендуем использовать для определения успешности отправки сообщения.


      pack_code    - Int    - Id пакета   

      0 СМС

      1 - WhatsApp

      2 - WhatsApp Бизнеc

      3 - Viber

      14 - MAX

      999 - в работе


      send_source  - Int    - Источник отправки 

      0 - Default (Неизвестно) 

      1 - После звонка 

      2 - Отправлено по API

      3 - Ручная отправка из  приложения (Визитка)

      9 - С журнала из приложения 

      10 - Входящее сообщение


              name         - String - имя

              number       - String - номер

              text_message - String - текст сообщения

              text_status  - String - текст статуса

              date         - Long   - время приема сообщения

              push_id      - String - Пуш id, если есть


              В приложении можно добавить свои значения,

              доступно 3 типа значений:

              -String

              -Long

              -Int

              Пример:

              idmanager    - String - Если есть то указывается ID менеджера

              device_name  - String - Имя устройства


              А так же можно указать где значение будет установлено в теле или заголовке.


              Результат запроса:

              В случае успеха запроса (статус код 200)

              {

              "status": "ok"

              }

              А так же успешный запрос будет засчитан если, status будет true или 200

              Иначе:

              {

              "status": "error",

              "errors": [{

                  "code": "400",

                  "description": "Bad Request"

                  }, {

                  "code": "404",

                  "description": "Bad Request"

                  }]

              }

              description при тесте будут отображены в тостере


      ЧТО НОВОГО в версии с 7 и выше new 

      В сторонних сервисах новый пункт, отправлять на сервер результат обработки пуша.


      action = 10 - будет приходить после окончания работы с пушом на клиенте а приложении СМС-Визитка.


      В сторонний сервис также при отправке нового запроса о результате обработки пуша, отправляются 3 новых данных:

      Есть ли Мессенджер на данном номере телефона: 

      iHaveWhatsApp

      Есть ли Viber: 

      iHaveViber

      Есть ли Telegram: 

      iHaveTelegram

      Варианты значений:

      0 Нет, 

      1 Есть, 

      -1 Не установлено, значение по умолчанию, означает что отправка этим методом не происходила


      iSendingStatus 

      Статус отправки, значение по умолчанию -1, 

      1,2 Отправлено, 3 Ошибка


      iSendingStatusWhatsApp 

      Статус отправки по whatsapp, значение по умолчанию -1, 

      1,2 Отправлено, 3 Ошибка


      iSendingStatusViber 

      Статус отправки по Viber, значение по умолчанию -1, 

      1,2 Отправлено, 3 Ошибка


      iSendingStatusTelegram 

      Статус отправки по телеграму, значение по умолчанию -1, 

      1,2 Отправлено, 3 Ошибка


      iSendingStatusSms 

      Статус отправки по SMS, значение по умолчанию -1, 

      1,2 Отправлено, 3 Ошибка



      Если вы представляете крупный сервис CRM системы и готовите интеграцию с приложением СМС-Визитка, свяжитесь с нами и мы встроим ваш сервис в приложение на экран “Сторонние сервисы”  укажем вашу ссылку по умолчанию - куда отправлять данные.


      И вашим клиентам останется только выбрать ваш сервис, указать ключ авторизации и включить сервис.


      НАШИ КОНТАКТЫ:

      WhatsApp: wa.me/79277101234

      тел.: +7(927)-71-01234

      8(347)266-69-77

      email: support@smsvizitka.com



      КАКОЙ ТАРИФ НЕОБХОДИМ ДЛЯ ОТПРАВКИ СООБЩЕНИЙ ЧЕРЕЗ ИНТЕГРАЦИЮ  ПО API:

      • Отправка текста SMS (+ шаблоны SMS ); WhatsApp сообщений (+шаблоны WhatsApp с файлами: картинки, видио, pdf и другие); Viber сообщений (и шаблоны) - доступна на тарифе "Бизнес+" и “Максимальный”. 

      • Запись сообщение в CRM систему доступно на тарифе: “Максимальный”. 

      • Первые 7 дней после установки - доступен тестовый период. Если вам потребуется больше времени для теста, напишите нам на WhatsApp wa.me/79277101234.

      • ✅ С ценами и ВОЗМОЖНОСТЯМИ тарифов можно ознакомиться здесь:

      https://docs.google.com/document/d/1xLj9pOGkv5XyiY7cKr3tvWXer1YXwIhCNZ6KcR-5tIM/edit

      • ПРИОБРЕСТИ ЛИЦЕНЗИЮ можно 4-мя способами. Указано ниже. 

      Поддержка по WhatsApp, пишите, отправляйте голосовые сообщения или звоните:

      https://wa.me/79277101234      8-(927)-71-01234       support@smsvizitka.com







      УСТАНОВКА ПРИЛОЖЕНИЯ И НАСТРОЙКА КАНАЛОВ ДЛЯ ОТПРАВКИ

      ✓ Для отправки сообщений по интеграции  только по WhatsApp или Viber, установите в телефон приложение СМС-Визитка с RuStore.

      ✓ Сообщения отправится, если у вас на телефоне android установлено приложение СМС-Визитка,

      включена интеграция и включен интернет!

      ✓ Для отправки SMS установите в телефон SIM-карту (в настройках приложения - настройки 2SIM - укажите с какой SIM-карты отправлять SMS ). Если SMS не требуется отправлять - укажите: в настройках - Режим отправки SMS - “Отправка SMS Визиток отключена”

      ✓ Укажите с какого мессенджера по умолчанию отправлять  сообщения: с WhatsApp, WhatsApp  Бизнес, Telegram или Viber. (Настройки приложения - настройки мессенджеров).

      ✓ Укажите последовательность отправки (в - Настройках - настройки мессенджеров - Автоматическая отправка… - Очередность отправки сообщений). 

      ✓ Рекомендации по включенным галочкам в разделе Меню - Интеграция:

      Фото: https://drive.google.com/file/d/1Ojgaes89DVg1c5mvJs4Oza7YNYvjgcO9/view?usp=sharing

      Включен умный, каскадный режим отправки сообщений. Отправка через WhatsApp, если у клиента нет WhatsApp, то по Viber, если нет Viber, то по sms. Или без sms.

      ✅ Видео о том, как настроить приложение для автоматической отправки сообщений по WhatsApp-Viber-СМС: https://youtu.be/kTzMfBjjez0

      Как отправлять файлы с тексьом через приложение при рассылках:

      СПОСОБ 1:

      - только для WhatsApp

      https://t.me/sms_vizitka_info/44/180


      СПОСОБ 2:

      - для WhatsApp/Telegram/Viber

      https://t.me/sms_vizitka_info/44/182

      Для *Xiaomi, Realme, HONOR и др*. 

      смотрите видео как отключить блокировку экрана:* при рассылках по интеграции.

      ЧЕРЕЗ РЕЖИМ РАЗРАБОТЧИКА.

      https://youtu.be/fXiE31b2Y_o





      ДЛЯ ПРАВИЛЬНОЙ РАБОТЫ ПРИЛОЖЕНИЯ

      *

      *Xiaomi и Realme* 👇

      👉 Настройки телефона -диспетчер приложений или ПРИЛОЖЕНИЯ - проверьте все 3 приложения: СМС-Визитка, WhatsApp и Viber :

      1) Чтобы было включено разрешение на Автозагрузку.

      2) Другие разрешения - включите Запуск в фоне.

      3) Контроль активности или БАТАРЕЯ - укажите Нет ограничений.

      *

      *Samsung* 👇

      ☑ Батарея - отключите энергосбережение.

      ☑ Батарея - добавьте приложение СМС-Визитка, WhatsApp и Viber в исключения - описание - может расходовать батарею без ограничения (много не ест, не переживайте)

      ☑ Оптимизация работы батареи или ЗАПУСК ПРИЛОЖЕНИЙ - СМС-Визитка, WhatsApp и Viber - запретите оптимизацию или автоматическое управление (не должна стоять галочка напротив этих приложений.

      *HONOR, Huawei* 👇

      👉 Настройки телефона -диспетчер приложений или ПРИЛОЖЕНИЯ - СМС-Визитка

      Использование батареи - отключите одну верхнюю галочку: "Автоматическое управление" в Запуске приложений

      👉 При  рассылках сообщений через интеграцию - некоторые телефоны рекомендуем *держать на зарядке* (чтобы система android не засыпала и не уходила в энергосбережение).
      Или для 200% надежности, если вам это не мешает - настройте экран, чтобы он не выключался - можно убавить подсветку на минимум. (необязательно)


      👉 Не используйте режим экономии или сбережения энергии.

      👉 В некоторых моделях (Samsung) можно в  настройках телефона (батарея или оптимизация) добавить приложение СМС-Визитка в исключения.

      ❗ 1 раз в месяц перезагружайте телефон или в настройках на некоторых моделях можно настроить автоматическую ежедневную перезагрузку, например ночью.

      📲 рекомендуем ОТКЛЮЧИТЬ АВТОМАТИЧЕСКОЕ ОБНОВЛЕНИЕ СМС-Визитки в Google Play, чтобы у приложения не пропал доступ к смс и к журналу звонков.

      Для этого откройте приложение Play Маркет

       - найдите в поиске приложение СМС-Визитка 

      - нажмите на логотип приложения

      - далее на 3 точки - в правом верхнем углу

      - Автообновление - снимите галочку


      ✔ Обновлять версию приложения можно по ссылке через Google Диск.

      И в приложении будет появляться уведомление о новом обновление и ссылка на скачивание








      *Для рассылки сообщений особенно через интеграцию по WhatsApp или Viber требуется отключить блокировку экрана* - экран можно выключать.

      1️⃣ *ПЕРВЫЙ вариант* 

      При включении экрана не потребуется проводить пальцем по экрану.

      👉 Экран будет выключен и сможет включатся, когда потребуется отправить сообщение по WhatsApp или Viber. 


      Для *Samsunga и некоторых др. телефонов:* 

      Настройки - “блокировка экрана” ИЛИ “безопасность”.

      Блокировка экрана - укажите НЕТ (не блокировать). И в дисплее тайм-аут экрана укажите не менее 1 мин.


      Для *Xiaomi, Realme, HONOR и др*. ЧЕРЕЗ РЕЖИМ РАЗРАБОТЧИКА.

      смотрите видео как отключить блокировку экрана:* при рассылках по интеграции

      https://youtu.be/fXiE31b2Y_o


      *Как отключить блокировку экрана с картинками для HONOR и Xiaomi:* https://docs.google.com/document/d/e/2PACX-1vQ26duWZ6kJq76Gfd4jV47Xq0l92Pr0YKa7W2G_KsKKuDPqB254FShLsGE7_8TDJJZUphCd8bgyjf2R/pub

      2️⃣ *ВТОРОЙ вариант для всех:*

      Можно настроить, чтобы экран вовсе никогда не выключался, пока вы его сами не выключите.

      И можно убавить подсветку экрана.


      1. На некоторых телефонах данная функция есть в Настройках - Экран или Дисплей - Режим ожидания.

      2. Если включили режим “разработчика”, в разделе “Для разработчиков” можно поставить галочку - не выключать экран во время зарядки.

      3. Для этого откройте настройки приложения СМС-Визитка - Интеграция - Автоматическая отправка по WhatsApp через интеграцию (вкл.) - нажмите на серую кнопку: "Разрешение изменения системных настроек" (включите доступ "СМС-Визитка" и назад). Далее нажмите на серую кнопку "Установить максимальное время" - ГОТОВО.

      3️⃣ *ТРЕТИЙ вариант для всех:*

      Перед рассылками можно  разблокировывать экран вручную.


      И в настройках - дисплей или блокировка экрана  - тайм-аут экрана можно указать 1-30 минут.

      И можно убавить подсветку экрана.




      СПОСОБЫ ПРИОБРЕСТИ ЛИЦЕНЗИЮ


      СПОСОБ №1

      В приложении через меню - "Оплата лицензии" 

      Временно не работает

      СПОСОБ №2 

      На сайте: https://onlinevizitka.com/payment/order_form/

      Срок лицензий: 1 мес.(скидка 0%), 3 мес. (-18%) 

      или 1 год (-35%) - есть рассрочка на 3 мес

      СПОСОБ №3 

      На карту Сбербанка

      Срок лицензий: 3 мес. (-22%)  

      или за 9 мес. или 1 год ( -35%) 

      Подробнее: WhatsApp wa.me/79277101234

      СПОСОБ №4

      Банковский платеж

      Карту партнера отправляйте на: abssms@mail.ru 

      или на WhatsApp wa.me/79277101234



      ООО “АБС СМС” 

      с 2014г.

      WhatsApp: wa.me/79279554477

      Телефон: 8(927)-71-01234    8(347)266-69-77



      Мы очень рады стараться для вас и делать наш продукт все лучше и лучше.

      Нам нравиться быть ТОП бестселлеров в Google Play - категория БИЗНЕС.

      И мы готовим новые бомбические функции!!!

      Всем Спасибо! Желаю всем успехов, высоких полетов, и продаж!









      🏠 Наши контакты


      Электронная. почта 

      support@smsvizitka.com

      WhatsApp

      wa.me/79277101234

      Номер телефона поддержки

      +7(927)71-01234

      https://onlinevizitka.com/business

      ВИДЕО о приложении на канале в Ютубе:

      https://www.youtube.com/@smsvizitka

      ВКонтакте

      vk.com/sms_vizitka

      Telegram

      t.me/smsvizitka

      Сайт СМС-Визитка

      https://www.smsvizitka.com  


      Умный чат-бот WhatsApp для бизнеса. В мобильном приложении.

      Создай сам в конструкторе за 7 минут!

      https://whatsapbot.com

      Поднятие в ТОП - выше конкурентов. 

      +Сбор положительных отзывов от клиентов.


      ВОЗВРАЩАЕМ ДО 70% КЛИЕНТОВ

      К ПОВТОРНЫМ ПОКУПКАМ


      Бесплатно: САЙТ ВИЗИТКА или ВИДЖЕТ "ЗАКАЗ ОБРАТНОГО ЗВОНКА" для вашего сайта и instagram.

      onlinevizitka.com

      Приложение в Google Play

      https://play.google.com/store/apps/details?id=com.smsvizitka.smsvizitka







Используя данный сайт, вы даёте согласие на использование файлов cookie, а также принимаете наше пользовательское соглашение и политику конфиденциальности.