Funkciók

Hogyan kapcsold össze az SMSAPI-t az easySalesszel: teljes beállítási útmutató

easySales csapat · Frissítve 1 október 2026 · 6 perc olvasás

Hogyan kapcsold össze az SMSAPI-t az easySalesszel: teljes beállítási útmutató

Küldj rendelési SMS-eket a vásárlóidnak az SMSAPI-n keresztül: melyik kártyát válaszd az smsapi.ro vagy az smsapi.pl fiókhoz, token és callback, bejelentkezés, tesztelés, feladónév és értesítési szabályok.

Mit ad neked az SMSAPI összekapcsolása

Az SMSAPI egy előre fizetett SMS-szolgáltatás. Az easySalesszel összekapcsolva SMS-eket küld a vásárlóidnak a rendeléseikről: rendelésvisszaigazolást, a csomagszámot nyomkövetési linkkel, számlát, lemondást, visszaküldést. Az üzenetek automatikusan mennek ki, amikor az esemény bekövetkezik, egy automatizálási folyamatból, vagy kézzel, a rendelés oldaláról.

Két SMSAPI-kártya — válaszd a fiókodhoz illőt

Az SMSAPI két külön szolgáltatást működtet, és az easySalesben mindkettőhöz tartozik egy kártya:

  • A román zászlós SMSAPI-kártya (SmsApi Romania) a portal.smsapi.ro oldalon lévő fiókokhoz való. API-tokennel kapcsolod össze, és kézbesítési callbacket adsz hozzá.
  • A zászló nélküli SMSAPI-kártya (SmsApi) az smsapi.pl oldalon lévő fiókokhoz való. Úgy kapcsolod össze, hogy az easySalesből bejelentkezel az SMSAPI-ba — nincs kimásolandó token.

Az egyik szolgáltatás fiókja nem működik a másik kártyán. Kövesd az útmutató kártyádra vonatkozó részét, majd folytasd a feladónévvel és az értesítési szabályokkal, amelyek mindkét kártyánál azonosak.

Az easySales SMS Services oldala mindkét csatlakoztatott SMSAPI-kártyával: a román zászlóssal és a zászló nélkülivel.
Integrations → SMS Services (nálad: Integrációk → SMS szolgáltatások): két SMSAPI-kártya.

Mielőtt elkezded

✓

SMSAPI-fiók

A portal.smsapi.ro vagy az smsapi.pl oldalon, feltöltött egyenleggel.

✓

A portal.smsapi.ro fiókhoz: API-token

Az SMSAPI portálon létrehozva, lejárat nélkül.

✓

Feladónév

Az SMSAPI-fiókodban regisztrálva és az SMSAPI által jóváhagyva.

SMSAPI Románia (portal.smsapi.ro)

1. lépés — Hozz létre API-tokent

  1. A portal.smsapi.ro oldalon menj az API Settings → API tokens (OAuth) menübe, és kattints a Generate access token gombra.
  2. Adj neki egy felismerhető nevet, például SmsApi Romania easySales.
  3. A token lejárati dátumánál válaszd a Never lehetőséget, és engedélyezd az összes jogosultságot.
  4. Másold ki a tokent: a 3. lépésben illeszted be az easySalesbe.

2. lépés — Add meg a callback-címet

A callbacken keresztül jelzi az SMSAPI az easySalesnek, hogy az egyes SMS-ek kézbesítve lettek-e. Enélkül az SMS előzmények soha nem mutatják kézbesítettnek az üzeneteidet.

  1. A portal.smsapi.ro oldalon menj a Callback URLs menübe, és kattints az Add callback address gombra.
  2. A Type mezőben válaszd a Callback address - SMS DLR lehetőséget.
  3. Az URL mezőbe pontosan ezt írd: https://easy-sales.com/services/sms/external-webhooks/smsapi-ro/status-update — https-sel, a végén perjel nélkül.

3. lépés — Kapcsold össze a kártyát az easySalesben

Menj az Integrációk → SMS szolgáltatások oldalra, és kattints a Bejelentkezés gombra a román zászlós kártyán — vagy a Szerkesztés gombra, ha korábban már összekapcsoltad. Adj meg egy felismerhető Alias nevet, illeszd be a tokent a Token mezőbe, és kattints a Mentés gombra.

Az SMSAPI Románia kapcsolat: Alias „SMSAPI Demo Store” és a maszkolt Token, a Test connection, Delete és Save gombokkal.
SMSAPI Románia: illeszd be a tokent az SMSAPI portálról.

A Mentés ellenőrzés nélkül tárolja a tokent. Az ellenőrzéshez nyisd meg a mentett kapcsolatot, és kattints a Kapcsolat tesztelése gombra: add meg a saját mobilszámodat az országhívószámmal, csak számjegyekkel — például 40722123456 —, és kattints a Tovább gombra. Az easySales egy valódi SMS-t küld, amelyet az SMSAPI-egyenlegedből vonnak le; ha megérkezik, a kapcsolat működik. Ha az SMSAPI elutasítja, helyette az SMSAPI indoklását látod.

SMSAPI Lengyelország (smsapi.pl)

1. lépés — Jelentkezz be az SMSAPI-ba az easySalesből

  1. Menj az Integrációk → SMS szolgáltatások oldalra, és kattints a Bejelentkezés gombra a zászló nélküli SMSAPI-kártyán.
  2. Kattints a Hitelesítés gombra. Megnyílik az SMSAPI bejelentkezési oldala: jelentkezz be az smsapi.pl fiókoddal, és engedélyezd, hogy az easySales SMS-t küldjön róla.
  3. Az SMSAPI visszairányít az SMS szolgáltatások oldalra, ahol a kártya már össze van kapcsolva.

2. lépés — Nevezd el a kapcsolatot

Nyisd meg újra a kapcsolatot, adj meg egy felismerhető Alias nevet — az értesítési szabályokban ez alapján választod ki a kapcsolatot —, és kattints a Mentés gombra.

Az smsapi.pl-hez tartozó SMSAPI-kapcsolat: Alias „SMSAPI Poland store”, a Reauth gomb, valamint a Test connection, Delete és Save gombok.
SMSAPI az smsapi.pl-hez: bejelentkezve, saját Alias névvel.

Kattints a Kapcsolat tesztelése gombra, és küldj magadnak egy teszt-SMS-t: add meg a mobilszámodat az országhívószámmal, csak számjegyekkel — például 48601234567 —, és kattints a Tovább gombra. A teszt-SMS valódi, és az SMSAPI-egyenlegedből fizetődik.

A feladóneved

A vásárlók az SMSAPI-fiókod alapértelmezett feladónevétől kapják az SMS-t. Ha a webshopod nevével szeretnél küldeni, regisztráld az SMSAPI-fiókodban — a portal.smsapi.ro oldalon a Sender names, az smsapi.pl oldalon a Pola nadawcy menüben —, és állítsd be alapértelmezettnek, miután az SMSAPI jóváhagyta. A feladónév 4–11 karakterből áll — betűkből, számjegyekből és néhány jelből, például ., &, @ vagy szóköz. A vásárlók nem tudnak válaszolni egy feladónévre.

Válaszd ki, milyen üzenetek menjenek ki

Az értesítési szabályok SMS-t küldenek, amikor valami történik egy rendeléssel: létrejön a címke, a rendelés létrejön, számlázásra, lemondásra vagy lezárásra kerül, megváltozik a kézbesítési állapot, visszaküldés jön létre. Először írd meg az üzenetet az Ügyfelek → Sablonok oldalon, az SMS fülön, majd hozd létre a szabályt az Ügyfelek → Értesítések oldalon, a kívánt eseménynél.

Az „SMS - order shipped” értesítési szabály az AWB Created eseményhez, amely SMSAPI-n keresztül küld, három bejelölt webshoppal a Send message for following channels alatt és az „Order shipped SMS” sablonnal.
A szabály a kiválasztott szolgáltatáson keresztül küld, a bejelölt csatornákhoz.
  • Válasszon szolgáltatást — az SMS-szolgáltatás, amelyen keresztül a szabály küld: az összekapcsolt SMSAPI-kártya és a kapcsolat Alias neve.
  • Üzenet küldése a következő csatornákhoz — jelölj be minden marketplace-t és webshopot, amelynek a rendelései megkapják az SMS-t. A be nem jelölt csatornák rendelései nem kapnak semmit.
  • Válassza ki a megfelelő sablont — az SMS szövege.

Üzenetek automatizálási folyamatból is kimehetnek, a Rendelés SMS értesítés küldése művelettel, vagy kézzel a rendelés oldaláról, a Felhasználó értesítése gombbal. Az SMS a vásárló telefonszámára megy, nemzetközi formátumban, a szállítási cím országa szerint.

Mi ment ki

Az easySales által küldött üzenetek az Ügyfelek → SMS előzmények oldalon jelennek meg, a rendeléssel, a vásárlóval és a szöveggel. Az SMSAPI Románia kártyánál, beállított callbackkel, az állapot Kézbesítve lesz, amikor az SMS megérkezik a vásárló telefonjára, vagy Nem kézbesített, ha a hálózat nem tudta kézbesíteni.

Ha egy SMS nem megy ki

Az üzenetek, amelyekkel a leggyakrabban találkozol a Kapcsolat tesztelése során vagy az SMS előzmények között:

Üzenet Mit tegyél
Cannot send sms, account balance is low Elfogyott az SMSAPI-egyenleged. Töltsd fel az egyenleget az SMSAPI-fiókodban.
Sending date does not fulfill the time limit set on your account Az SMSAPI-fiókod csak bizonyos órákban enged küldeni. Módosítsd a küldési órákat az SMSAPI-fiókodban, vagy késleltesd az értesítést, hogy ezen belül menjen ki.
No correct phone numbers A rendelésen nincs használható telefonszám — üres, vagy a marketplace elrejtette. Add hozzá a vásárló telefonszámát a rendeléshez.
Message is too long. A szöveghez több SMS-rész kell, mint amennyit az SMSAPI-fiókod enged. Rövidítsd a sablont, és hagyd ki a különleges karaktereket.
Üzenetek, amelyeket láthatsz

Gyakran ismételt kérdések

A román zászlós kártyát a portal.smsapi.ro oldalon lévő fiókhoz, a zászló nélkülit az smsapi.pl oldalon lévő fiókhoz. Az egyik szolgáltatás fiókja nem működik a másik kártyán.

A portal.smsapi.ro oldalon, az API Settings → API tokens (OAuth) menüben, a Generate access token gombbal. Lejárati dátumnak válaszd a Never lehetőséget, és engedélyezd az összes jogosultságot.

A zászló nélküli SMSAPI-kártyán kattints a Hitelesítés gombra, jelentkezz be az smsapi.pl fiókoddal, és engedélyezd, hogy az easySales SMS-t küldjön. Az easySalesbe visszatérve nyisd meg a kapcsolatot, adj meg egy Alias nevet, és kattints a Mentés gombra.

Az SMSAPI Románia kártyánál az SMSAPI a callback-címen keresztül jelzi a kézbesítéseket. Add meg az SMSAPI portálon, a Callback URLs menüben, Callback address - SMS DLR típussal, a 2. lépésben szereplő pontos címmel.

Nyisd meg a mentett kapcsolatot, kattints a Kapcsolat tesztelése gombra, add meg a mobilszámodat az országhívószámmal, csak számjegyekkel, és kattints a Tovább gombra. Ha a teszt-SMS megérkezik, működik. A teszt-SMS díját az SMSAPI-egyenlegedből vonják le.

Az SMSAPI-fiókod alapértelmezett feladónevét. Regisztráld a webshopod nevét az SMSAPI-fiókodban, és állítsd be alapértelmezettnek, miután az SMSAPI jóváhagyta.

Az összekapcsolás önmagában semmit nem küld. Hozz létre egy SMS-sablont az Ügyfelek → Sablonok oldalon, majd egy szabályt az Ügyfelek → Értesítések oldalon, amely ezt használja, a kiválasztott SMSAPI-kapcsolatoddal és a bejelölt értékesítési csatornáiddal.

A szabványos SMS-ábécén kívüli karakter — például ő, ű, á, í, ó, ú, egy emoji, cirill vagy kínai betűk — Unicode-ra váltja az SMS-t, ahol egy üzenet 160 helyett 70 karakteres. A sablonokat ilyen karakterek nélkül írd, és tartsd őket röviden.

Hasznos volt ez az útmutató?