Skip to content

SMS brány

SMS brána je propojení CRM s technickým prostředím, které přenáší SMS zprávy — hardwarovým modemem, softwarovou službou nebo externí webovou bránou. Před prvním odesláním SMS musí být v systému nakonfigurovaná alespoň jedna brána.

K čemu to slouží

InTouch CRM sám SMS nerozesílá — zprávy vždy předává nějaké bráně, která je fyzicky odešle. Podle toho, jakou bránu používáte, nastavíte v tomto dialogu odpovídající typ a jeho parametry. Po instalaci CRM obvykle najdete automaticky vytvořený účet typu SMSbrana.cz — můžete ho přizpůsobit nebo smazat a založit jiný.

Podporované typy bran

Typ brányFyzický kanálK čemu se hodí
SMS Server Tools GatewayHW modem na Linuxu (služba SMSTools)Vlastní HW vybavení
SMSLib.org GatewayHW modem na Windows (aplikace SMSLib)Vlastní HW vybavení
SMSbrana.cz GatewayHTTP webová služba smsbrana.czRychlé spuštění bez HW, platí se za SMS
O2 GatewaySlužba SMS Connector od O2Firmy s O2 připojením
URL GatewayVolání libovolné HTTP URLJiné brány, custom integrace (pouze odesílání)

Otevření

V hlavní navigaci klepněte na Nastavení, najděte blok Marketing nebo Rozšířené a zvolte SMS účty / SMS brány. Zobrazí se seznam nakonfigurovaných účtů.

Formulář SMS účtu

Společné parametry pro všechny typy:

  • Název — interní označení účtu (uvidíte ho při odesílání SMS).

  • Vlastník — uživatel nebo skupina, která smí účet používat. Pokud nevyplněno, účet je přístupný všem uživatelům s právem odesílat SMS.

  • Tel. číslo — číslo, z něhož budou SMS odcházet a na které budou příchozí SMS směrovány.

  • Brána — vyberte typ (viz tabulka výše). Podle typu se změní obsah pole Konfigurace níže.

  • Odstranit diakritiku před odesláním — diakritika zkracuje SMS z 160 na 70 znaků. Pokud ji odstraníte, zpráva bude levnější.

  • Výchozí účet pro odesílání — tento účet se automaticky nabídne u nových SMS.

  • Zjišťovat příchozí SMS zprávy — CRM se bude pokoušet stahovat SMS došlé na toto číslo. Pokud účet slouží jen k odesílání, ponechte nezaškrtnuté.

  • Sdílení SMSek — kdo uvidí příchozí SMS:

    • nesdílet — pouze vlastník účtu
    • automaticky — podle párování na kontakt
    • přidělit práva po přijetí — viditelné všem, lze upravit po přijetí
  • Konfigurace — technické parametry brány (viz níže podle typu).

Parametry podle typu brány

SMS Server Tools Gateway

Integrace s HW modemem na Linuxu přes službu SMSTools. SMS zprávy se předávají soubory ve sdílených adresářích.

ParametrVýznam
inCesta do adresáře s příchozími SMS
outCesta do adresáře pro odchozí SMS
sentCesta do adresáře pro odeslané SMS (nepovinný)
failedCesta do adresáře pro neúspěšné SMS (nepovinný)
modemIdentifikátor modemu v SMSTools (např. GSM1)

SMSbrana.cz Gateway

Webová služba smsbrana.cz. Nejdříve si na této platformě založte účet, nabijte kredit a povolte službu SMS Connect (která umožní odesílání přes HTTP). Do CRM pak stačí zadat přihlašovací údaje hlavního účtu — speciální údaje pro SMS Connect není třeba.

ParametrVýznam
loginPřihlašovací jméno
passwordPřihlašovací heslo
urlURL webové služby (nepovinný — výchozí směřuje na smsbrana.cz)
hashtrue/false — zda heslo posílat hashované (výchozí true)

Odesílací číslo

SMS odeslané přes smsbrana.cz mají systémové číslo odesílatele 774 884 138, nezávisle na vyplnění pole Tel. číslo. Pokud potřebujete odesílat pod vlastním číslem, zaregistrujte si vlastní SIM kartu v účtu smsbrana.cz. Nevýhoda: odpovědi pak přijdou na tuto SIM kartu, ne zpět do CRM.

Chybové kódy SMSbrana.cz:

KódVýznam
err=1Neznámá chyba
err=2Neplatný login
err=3Neplatný hash nebo heslo
err=4Čas mezi servery je příliš vzdálený
err=5Nepovolená IP adresa
err=6Neplatný název akce
err=7Daná sůl už byla dnes použita
err=8Chyba spojení s databází
err=9Nedostatečný kredit
err=10Neplatné číslo příjemce
err=11Prázdný text zprávy
err=12Zpráva delší než 459 znaků

SMSLib.org Gateway

Integrace s aplikací SMSLib (Windows) přes sdílenou SQL databázi. Tvar databáze je popsán v dokumentaci SMSLib.

ParametrVýznam
sqlDriverJava SQL driver třída
sqlURLJDBC URL databáze
sqlUserUživatel pro přístup k DB
sqlPasswordHeslo
gatewayIdID brány v konfiguraci SMSLib

O2 Gateway

Integrace se službou SMS Connector od O2. Službu je třeba nejdříve sjednat u O2.

ParametrVýznam
idIdentifikátor služby od O2
certCesta k souboru s privátním klíčem (formát PKCS, typicky v dokumentech CRM)
certPasswdHeslo k privátnímu klíči

Soubor .p12 musí obsahovat také kořenový certifikát certifikační autority CA O2 CZ (lze stáhnout z https://ca.o2.cz) a certifikát stránky smsconnector.o2.cz.

URL Gateway

Volání libovolné HTTP URL — pro vlastní integrace. Funguje pouze pro odesílání.

ParametrVýznam
urlAdresa pro volání. Musí obsahovat zástupce [PHONE] (cílové číslo) a [MSG] (text zprávy).

Příklad URL:

http://127.0.0.1:8080/cgi/SmsCGI?account=test&password=heslo&destination=[PHONE]&content=[MSG]

Přístupová práva

Uživatel smí odeslat SMS, pokud má v profilu zaškrtnuté Může odesílat SMSky. Hromadné SMS vyžadují navíc Může odesílat hromadné SMSky. Pro čtení příchozích SMS je potřeba Může číst SMSky.

Viz také