Интеграция для АТС и CRM
ОТПРАВКА SMS и WhatsApp сообщений
Через приложение ”СМС-Визитка” по API
Метод send-sms принимает параметры:
api_key - ключ api из вашего android приложения (находится в настройках приложения - Интеграция - копировать ключ)
to - номер телефона, на который необходимо отправить смс
text - текст сообщения
%0A - перенос строки
--------------------------------
КАК НАСТРОИТЬ ИНТЕГРАЦИЮ:
- Установите приложение "СМС-Визитка" на android телефон
- Запустите приложение
- Включите интеграцию: меню - настройки - интеграция
4. Скопируйте ключ API, это будет api_key для метода send-sms
--------------------------------
ДЛЯ НАСТРОЙКИ ИНТЕГРАЦИИ ОБРАЩАЙТЕСЬ ПО URL, ПРИМЕР:
https://crm.smsvizitka.com/api/send-sms?api_key=Ваш_api_ключ&to=На_номер_телефона&text=Текст_сообщения
Например через curl - PHP или библиотека - php_curl_class
Конечная ссылка будет выглядеть так, пример:
https://crm.smsvizitka.com/api/send-sms?api_key=80011111111111&to=89171234567&text=Текст_Сообщения
80011111111111 - пример, ключ api из вашего android приложения.
"89171234567" - пример телефона, на который нужно отправить сообщение.
"Текст Сообщения" - текст, который отправится в сообщении на номер телефона 89171234567
--------------------------------
УСЛОВИЯ ДЛЯ ОТПРАВКИ:
Сообщения отправится с вашего телефона, от которого вы указали "ключ api".
Сообщения отправится, если у вас на телефоне установлено приложение СМС-Визитка,
включена интеграция и включен интернет!
--------------------------------
КАКОЙ ТАРИФ НЕОБХОДИМ ДЛЯ ОТПРАВКИ СООБЩЕНИЙ ПО API?
● Отправка текста по SMS доступна на тарифе: "Бизнес"
● Отправка текста SMS (+ шаблоны SMS); WhatsApp сообщений (+шаблоны WhatsApp с файлами: картинки, видио, pdf и другие) доступна на тарифе "Бизнес+".
--------------------------------
НОВЫЕ ФУНКЦИИ начиная с версии 5.6.3
ВАРИАНТЫОТПРАВКИ ШАБЛОНОВ ПО API на тарифе "Бизнес+"
Каждому шаблону можно задать индивидуальное название. (Меню - Шаблоны - редактировать шаблон)
| @название_шаблона; - для отправки шаблона по WhatsApp. @@название_шаблона; - для отправки шаблона по WhatsApp Бизнес. $название_шаблона; - для отправки шаблонаSMS с первой SIMкарты. $$название_шаблона; - для отправки шаблонаSMS со второй SIMкарты. %текст сообщения; - для отправки любого текста по смс с SIM-карты, которая назначена для отправки по умолчанию и по WhatsApp или WhatsApp Бизнес указанный по умолчанию в настройках приложения. , - разделение одного шаблона от другого в одной рубрике. ; - символ указывает где заканчивается название шаблона, рубрики шаблонов или текста. |
Разберем примеры, если включен умный режим (в настройках - интеграция):
" Отправлять сначала по WhatsApp, если у номера нет WhatsApp, то отправлять SMS "
- @название1; - "шаблон1" отправится только по WhatsApp, даже если у номера нет WhatsApp по SMS ничего отправляться не будет.
- @название1,название2; - "шаблон1" и "шаблон2" отправится по WhatsApp, даже если у номера нет WhatsApp по SMS ничего отправляться не будет.
- @название1;$название2; - "шаблон1" отправится по WhatsApp,
если у номера нет WhatsApp, то отпарвится по SMS "шаблон2" с первой SIM-карты.
- @@название1;$$название2; - "шаблон1" отправится по WhatsApp Бизнес,
если у номера нет WhatsApp, то отправится по SMS "шаблон2" со второй SIM-карты.
- @название1;$название2;%текст сообщения; - " шаблон1 " отправится по WhatsApp, если у номера нет WhatsApp, то отправится по SMS " шаблон2 " с первой SIM-карты. Текст сообщения отправится по смс с SIM-карты, которая назначена для отправки по умолчанию (при условии, если у номера нет WhatsApp) и по WhatsApp или WhatsApp Бизнес указанный по умолчанию в настройках приложения.
- @название1;$название2;%@текст сообщения; - " шаблон1 " отправится по WhatsApp, если у номера нет WhatsApp, то отправится по SMS " шаблон2 " с первой SIM-карты. Текст сообщения отправится только через WhatsApp.
- @название1;$название2;%@$текст сообщения; - " шаблон1 " отправится по WhatsApp, если у номера нет WhatsApp, то отправится по SMS " шаблон2 " с первой SIM-карты. Текст сообщения отправится по WhatsApp, если у номера нет WhatsApp, то отправится по SMS с первой SIM-карты.
- %$Текст сообщения; - Текст отправится с первой SIMкарты.
- %$$Текст сообщения; - Текст отправится со второй SIMкарты.
- %@Текст сообщения; - Текст отправится с WhatsApp.
- %@@Текст сообщения; - Текст отправится с WhatsApp Бизнес.
- %@$Текст сообщения; - Текст отправится по WhatsApp,
если у номера нет WhatsApp, то отпарвится по SMS с первой SIM-карты.
- %@@$$Текст сообщения; - отправится по WhatsApp Бизнес,
если у номера нет WhatsApp, то отправится по SMS со второй SIM-карты.
Разберем примеры, если отключен умный режим (в настройках - интеграция) - " По умолчанию и WhatsApp и SMS ":
- @название1; - "шаблон1" отправится только по WhatsApp, даже если у номера нет WhatsApp по SMS ничего отправляться не будет.
- @название1,название2; - "шаблон1" и "шаблон2" отправится по WhatsApp, даже если у номера нет WhatsApp по SMS ничего отправляться не будет.
- @название1;$название2; - "шаблон1" отправится по WhatsApp,
"шаблон2" отправится по SMS с первой SIM-карты.
- @@название1;$$название2; - "шаблон1" отправится по WhatsApp Бизнес,
"шаблон2" отправится по SMS со второй SIM-карты.
- @название1;$название2;%текст сообщения; - " шаблон1 " отправится по WhatsApp, "шаблон2" отправится по SMS с первой SIM-карты.
Текст сообщения отправится по смс с SIM-карты, которая назначена для отправки по умолчанию и по WhatsApp или WhatsApp Бизнес указанный по умолчанию в настройках приложения.
- @название1;$название2;%@текст сообщения; - " шаблон1 " отправится по WhatsApp, "шаблон2" отправится по SMS с первой SIM-карты.
Текст сообщения отправится только через WhatsApp.
- @название1;$название2;%@$текст сообщения; - " шаблон1 " отправится по WhatsApp, "шаблон2" отправится по SMS с первой SIM-карты.
Текст сообщения отправится по WhatsApp и по SMS с первой SIM-карты.
- %$Текст сообщения; - Текст отправится с первой SIMкарты.
- %$$Текст сообщения; - Текст отправится со второй SIMкарты.
- %@Текст сообщения; - Текст отправится с WhatsApp.
- %@@Текст сообщения; - Текст отправится с WhatsApp Бизнес.
- %@$Текст сообщения; - Текст отправится по WhatsApp и по SMS с первой SIM-карты.
- %@@$$Текст сообщения; - отправится по WhatsApp Бизнес и по SMS со второй SIM-карты.
---------------------------
ПРИМЕР ОТПРАВКИ СООБЩЕНИЙ ПО ОБРАЩЕНИЮ ЧЕРЕЗ URL:
Конечная ссылка третьего варианта будет выглядеть по обращению через URL так:
https://crm.smsvizitka.com/api/send-sms?api_key=80011111111111&to=89171234567&text=@название1;$название2;%@$Добрый день!;
----------------------------
ПРИМЕР ОТПРАВКИ ШАБЛОНОВ ЧЕРЕЗ amoCRM:
| (ЕСЛИ в настройках телефона - интеграция - отключен умный режим и указано: "По умолчанию и WhatsApp и SMS” "шаблон1" отправится по WhatsApp, "шаблон2" отправится по SMS с первой SIM-карты. Текст сообщения(Добрый день) отправится по WhatsApp и по SMS с первой SIM-карты. -------------------------------------------------------------- (ЕСЛИ в настройках телефона - интеграция - включен умный режим: "Отправлять сначала по WhatsApp, если у номера нет WhatsApp, то отправлять SMS") "шаблон1" отправится по WhatsApp, если у номера нет WhatsApp, то отправится по SMS "шаблон2" с первой SIM-карты. Текст сообщения(Добрый день) отправится по WhatsApp, если у номера нет WhatsApp, то отправится по SMS с первой SIM-карты. |