E-mail na SMS z monitoringu a aplikací

Jak to funguje

1. V dashboardu v sekci API přístup vytvořte API klíč se scope send (nebo použijte stávající) a u něj otevřete GET a e-mail.
2. Zapněte E-mail na SMS a do Povolené e-maily odesílatelů zapište adresy, ze kterých budete posílat (alarm@firma.cz), nebo celou vlastní doménu (@firma.cz).
3. Pošlete e-mail na 420601234567@sms.topsms.cz. Text těla odejde jako SMS na +420 601 234 567.

Účet, kredit, odesílatele SMS (výchozí odesílatel účtu), oprávnění a testovací režim určuje API klíč. Zprávy najdete v historii a v logu klíče jako každou jinou SMS z API.

Tvar adresy

420601234567.tok_xxxxxxxxxxxxxxxx@sms.topsms.cz   (doporučeno: s tokenem klíče)
420601234567@sms.topsms.cz
+420601234567@sms.topsms.cz
601234567@sms.topsms.cz                          (národní formát podle země účtu)
4915112345678@sms.topsms.eu                      (funguje i doména sms.topsms.eu)

• Číslo mezinárodně s + nebo bez, s 00, nebo v národním formátu země vašeho účtu.
• Až 10 čísel v polích Komu a Kopie jednoho e-mailu; při víc číslech e-mail odmítneme celý.
• Token klíče (tok_ a 16 znaků) najdete u klíče v dashboardu. Adresa s tokenem projde i od zařízení, jejichž poštovní server nemá SPF ani DKIM (routery, NAS, kamery), a vybere správný klíč, když stejného odesílatele povoluje víc klíčů. Token držte v tajnosti, nový vygenerujete jedním kliknutím.

Co se stane s textem

• Použijeme textovou část e-mailu, HTML převedeme na prostý text.
• Odřízneme citovanou předchozí zprávu („Dne … napsal(a):“, „On … wrote:“, řádky s „>“), podpis za oddělovačem -- a „Odesláno z iPhonu“.
• Mezery a zalomení sloučíme do jedné mezery a text zkrátíme na 1 600 znaků. Diakritika projde (SMS pak má 70 znaků na segment).
• Když je tělo prázdné, použijeme předmět (bez „Re:“ a „Fwd:“). Přílohy ignorujeme.

Kdo smí posílat

Otevřená e-mailová brána by byla zneužitá během dnů. E-mail proto přijmeme jen tehdy, když:

• adresa odesílatele v hlavičce From (a obálkový odesílatel, nebo jeho doména) je v seznamu povolených odesílatelů některého API klíče, a
• e-mail prošel kontrolou DMARC, DKIM nebo SPF pro doménu odesílatele na našem příjmu pošty, nebo adresa příjemce nese token klíče.

Celou doménu veřejné schránky (@gmail.com, @seznam.cz, @email.cz a podobné) povolit nejde, jen konkrétní adresu. Limit je 60 e-mailů za hodinu na klíč a zvlášť na adresu odesílatele, platí i minutový rate limit klíče. Nepovolené e-maily odmítneme už při doručení (SMTP), žádnou odpověď ani nedoručenku neposíláme.

Chyby, kredit a testovací klíč

• Když SMS odejít nemůže (nedostatek kreditu, neplatné číslo, neschválený odesílatel), e-mail odmítneme s důvodem a váš poštovní server vám vrátí nedoručenku.
• Každý přijatý e-mail (odeslaný i odmítnutý) vidíte u klíče v dashboardu v seznamu Poslední e-maily.
• S testovacím klíčem se e-mail zpracuje celý, ale SMS se neodešle ani nezaúčtuje.
• Opakované doručení stejného e-mailu (stejné Message-ID) do 24 hodin SMS znovu nepošle.