Technická reference: Hromadné SMS

Entita: SMS

Modul využívá (rozšiřuje) entitu Sms. V kontextu tohoto modulu slouží entita Sms jako definice kampaně, nikoliv jako záznam o jedné odeslané zprávě.

Pole

Název (System)	Typ	Popis
name	Varchar	Název kampaně/zprávy.
body	Text	Obsah SMS zprávy.
targetLists	LinkMultiple	Vazba na cílové skupiny (TargetList).

Logika odesílání (Service)

Třída: Espo\Modules\MassSms\Services\Sms

Metoda sendMassSms($smsId, $targetListsIds) provádí:

1. Načtení entity Sms.
2. Iteraci přes ID cílových skupin.
3. Pro každou skupinu načtení relací: accounts, contacts, leads, users.
4. Extrakci telefonních čísel (phoneNumber).
5. Filtraci:
   • Odstranění duplicit (array_unique).
   • Kontrola phoneNumberIsInvalid.
   • Kontrola phoneNumberIsOptedOut (GDPR).
   • Kontrola prázdných čísel.
6. Volání SmsSender -> TMobileSender.

T-Mobile Integrace

Třída: Espo\Modules\MassSms\TMobile\TMobileSender

• Endpoint: https://aweg.t-mobile.cz
• Autentizace: Basic Auth (user/password z Integrace TMobile).
• Metoda: GET request s parametry auth, receiver, smstext.
• Bulk ID: Při hromadném odesílání generuje unikátní bulk ID pro skupinu zpráv.
• Normalizace čísel:
  • Odstraní mezery a nečíselné znaky.
  • Pokud začíná 00, ponechá (bere jako mezinárodní).
  • Pokud začíná +, ponechá.
  • Jinak přidá prefix +420.