Как да свържете SMSAPI с easySales: пълно ръководство за настройка

Какво Ви дава свързването на SMSAPI

SMSAPI е предплатена SMS услуга. Свързана с easySales, тя изпраща на Вашите клиенти текстови съобщения за поръчките им: потвърждение на поръчката, номера на пратката с линк за проследяване, фактура, анулиране, връщане. Съобщенията се изпращат автоматично, когато настъпи събитието, от поток за автоматизация или ръчно от страницата на поръчката.

Две карти SMSAPI — изберете тази за Вашия акаунт

SMSAPI има две отделни услуги и easySales има карта за всяка от тях:

• Картата SMSAPI с румънското знаме (SmsApi Romania) е за акаунти в portal.smsapi.ro. Свързвате я с API токен и добавяте callback за доставка.
• Картата SMSAPI без знаме (SmsApi) е за акаунти в smsapi.pl. Свързвате я, като влезете в SMSAPI от easySales — няма токен за копиране.

Акаунт в едната услуга не работи с другата карта. Следвайте частта от ръководството за Вашата карта, след това продължете с името на подателя и правилата за известия, които са еднакви и за двете карти.

Преди да започнете

SMSAPI Румъния (portal.smsapi.ro)

Стъпка 1 — Създайте API токен

1. В portal.smsapi.ro отворете API Settings → API tokens (OAuth) и натиснете Generate access token.
2. Дайте му име, което ще разпознаете, например SmsApi Romania easySales.
3. За дата на изтичане на токена изберете Never и активирайте всички права.
4. Копирайте токена: ще го поставите в easySales в стъпка 3.

Стъпка 2 — Добавете callback адреса

Чрез callback SMSAPI съобщава на easySales дали всяко SMS е доставено. Без него SMS история никога не показва съобщенията Ви като доставени.

1. В portal.smsapi.ro отворете Callback URLs и натиснете Add callback address.
2. В Type изберете Callback address - SMS DLR.
3. В URL въведете точно https://easy-sales.com/services/sms/external-webhooks/smsapi-ro/status-update — с https и без наклонена черта в края.

Стъпка 3 — Свържете картата в easySales

Отворете Интеграции → SMS услуги и натиснете Свържи на картата с румънското знаме — или Редактирай, ако вече сте я свързвали. Въведете Псевдоним, който ще разпознаете, поставете токена в Жетон и натиснете Запази.

Запази съхранява токена, без да го проверява. За да го проверите, отворете запазената връзка и натиснете Test connection: въведете своя мобилен номер с кода на държавата, само цифри — например 40722123456 — и натиснете Продължи. easySales изпраща истинско SMS, заплатено от Вашия баланс в SMSAPI; когато пристигне, връзката работи. Ако SMSAPI откаже, вместо това се показва причината, посочена от SMSAPI.

SMSAPI Полша (smsapi.pl)

Стъпка 1 — Влезте в SMSAPI от easySales

1. Отворете Интеграции → SMS услуги и натиснете Свържи на картата SMSAPI без знаме.
2. Натиснете Удостоверяване. Отваря се страницата за вход на SMSAPI: влезте с акаунта си в smsapi.pl и разрешете на easySales да изпраща SMS от него.
3. SMSAPI Ви връща в SMS услуги, където картата вече е свързана.

Стъпка 2 — Наименувайте връзката

Отворете връзката отново, въведете Псевдоним, който ще разпознаете — по него избирате връзката в правилата за известия — и натиснете Запази.

Натиснете Test connection, за да си изпратите тестово SMS: въведете мобилния си номер с кода на държавата, само цифри — например 48601234567 — и натиснете Продължи. Тестовото SMS е истинско и се заплаща от Вашия баланс в SMSAPI.

Вашето име на подател

Клиентите виждат SMS-а от името на подателя по подразбиране на Вашия акаунт в SMSAPI. За да изпращате с името на магазина си, регистрирайте го в акаунта си в SMSAPI — Sender names в portal.smsapi.ro, Pola nadawcy в smsapi.pl — и го задайте по подразбиране, след като SMSAPI го одобри. Името на подателя е от 4 до 11 знака — латински букви, цифри и няколко знака, като ., &, @ или интервал. Клиентите не могат да отговорят на име на подател.

Изберете кои съобщения да се изпращат

Правилата за известия изпращат SMS, когато нещо се случи с поръчка: създаден е етикет, поръчката е създадена, фактурирана, анулирана или приключена, статусът на доставката се промени, създадено е връщане. Първо напишете съобщението в Клиенти → Шаблони, в раздела SMS, след това създайте правилото в Клиенти → Известия, при желаното събитие.

• Избери услуга — SMS услугата, през която правилото изпраща: картата SMSAPI, която сте свързали, и Псевдоним на връзката.
• Изпратете съобщение за следните канали — отметнете всеки marketplace и магазин, чиито поръчки трябва да получат SMS-а. Поръчките от неотметнат канал не получават нищо.
• Избери подходящия шаблон — текстът на SMS-а.

Съобщенията могат да се изпращат и от поток за автоматизация, с действието Изпрати SMS уведомление за поръчката, или ръчно от страницата на поръчката, с Известяване на потребителя. SMS-ът отива на телефонния номер на клиента, записан в международен формат според държавата от адреса за доставка.

Проверка на изпратеното

Съобщенията, които easySales изпраща, се показват в Клиенти → SMS история, с поръчката, клиента и текста. С картата SMSAPI Румъния и настроен callback статусът става Доставено, когато SMS-ът стигне до телефона на клиента, или не доставено, когато мрежата не е успяла да го достави.

Когато SMS не бъде изпратено

Съобщенията, които ще виждате най-често, при Test connection или в SMS история: