Poskytovatel SMS Twilio
Twilio je cloudová komunikační platforma s programovatelným odesíláním SMS. nopCommerce podporuje Twilio přímo bez dalších úprav, takže není potřeba žádný plugin třetí strany.
V nopCommerce se poskytovatel SMS používá k odeslání jednorázového ověřovacího kódu (OTP), když se zákazník přihlašuje do obchodu pomocí telefonního čísla. Tato možnost je doplňková: zákazníci se mohou i nadále přihlašovat pomocí e-mailové adresy nebo uživatelského jména.
Účet Twilio
Poskytovatel funguje přes Twilio REST API, proto je vyžadován účet Twilio:
- Zaregistrujte si účet Twilio a dokončete ověření v konzoli Twilio.
- Pořiďte si telefonní číslo, které podporuje SMS. Na stránce Account Dashboard klikněte na Get a phone number nebo přejděte do Phone Numbers → Manage → Buy a number a ujistěte se, že má číslo povolenou funkci SMS.
- Zkopírujte přihlašovací údaje účtu ze stránky Account Dashboard:
- Account SID — 34znakový identifikátor začínající na „AC“. Slouží jako přihlašovací jméno a identifikuje účet (nebo podúčet), ze kterého se zprávy odesílají.
- Auth token — klíč používaný k autorizaci požadavků API.
Důležité
Odesílání SMS vyžaduje kladný zůstatek na účtu Twilio. Zprávy se účtují po segmentech a sazby závisí na cílové zemi.
Poznámka
Některé země a sítě vyžadují před doručením obchodních zpráv další postupy (registraci odesílatele, schválení krátkého kódu atd.). Splňte všechny příslušné požadavky na ověření nebo registraci pro země, ve kterých se nacházejí vaši zákazníci.
Konfigurace poskytovatele
Přejděte do Konfigurace → Poskytovatelé SMS (Configuration → SMS providers).
V seznamu najděte položku Twilio SMS provider a kliknutím na Označit jako primárního poskytovatele (Mark as primary provider) nastavte, aby jej nopCommerce používal k odesílání SMS. Současně lze používat pouze jednoho poskytovatele.
Poznámka
Pokud byl dříve používán jiný poskytovatel, jeho primární stav se automaticky odebere.
Klikněte na Konfigurovat (Configure) vedle možnosti Twilio SMS provider v seznamu a otevře se stránka s přihlašovacími údaji.

Vyplňte následující pole:
- Informace o zůstatku (Balance info): aktuální zůstatek vašeho účtu Twilio. Toto pole je pouze pro čtení a zobrazí se po nakonfigurování poskytovatele. Kliknutím na Zkontrolovat zůstatek účtu (Check the account balance) hodnotu aktualizujete.
- Account SID: Account SID zkopírovaný ze stránky Account Dashboard v konzoli Twilio.
- Auth token: Auth token zkopírovaný z podokna Account Info na stránce Console Dashboard. Zacházejte s ním jako s heslem: poskytuje úplný přístup k účtu.
- Telefonní číslo (Phone number): telefonní číslo účtu Twilio, ze kterého se ověřovací kódy odesílají. Zadejte číslo v mezinárodním formátu, například
+12345678900.
Klikněte na Uložit (Save).
Tip
Twilio filtruje zprávy podle účtu, takže odesílání můžete otestovat bez použití skutečného mobilního čísla: odešlete zprávu na číslo Twilio Virtual Phone +18777804236 a zkontrolujte zprávu v rozhraní Virtual Phone. Upozorňujeme, že se tam zobrazují pouze zprávy odeslané z vašeho účtu.
Řešení problémů
Pokud zákazníci ověřovací kód neobdrží, zkontrolujte následující:
- Hodnoty Account SID, Auth token a Telefonní číslo jsou zkopírovány správně a neobsahují nadbytečné mezery.
- Pole Informace o zůstatku ukazuje kladný zůstatek, protože při vyčerpaném účtu se ověřovací kódy neodesílají.
- Číslo odesílatele podporuje SMS a požadavky na ověření nebo registraci pro cílovou zemi jsou splněny.
- Číslo příjemce je zadáno v mezinárodním formátu, například
+12345678900. - Podrobnosti o neúspěšných požadavcích a konečný stav doručení jsou k dispozici v konzoli Twilio (Message → Logs).
Poznámka
Úspěšná odpověď z Twilio API znamená, že zpráva byla přijata k odeslání, nikoli že byla doručena. Konečný stav vždy ověřte v protokolu zpráv v konzoli Twilio.