Integracje

Shopify SMS w Polsce — powiadomienia transakcyjne krok po kroku

Tomasz Lewandowski - Lead Developer, SMSIK 10 min czytania

Shopify rośnie w Polsce w szybkim tempie. Dowiedz się, jak dodać SMS-y transakcyjne — przez aplikacje, webhooks lub Shopify Flow. Instrukcja krok po kroku.

Shopify to globalny lider platform e-commerce, który w Polsce rośnie w bardzo szybkim tempie — zwłaszcza wśród sklepów premium i marek D2C. Jeśli prowadzisz sklep na Shopify i chcesz wysyłać SMS-y transakcyjne, ten artykuł pokaże Ci 3 drogi: gotowe aplikacje, webhooks i Shopify Flow.

Dlaczego SMS-y w Shopify?

Shopify ma świetny system e-maili transakcyjnych, ale e-mail ma ograniczenia:

  • Średni open rate e-maila: 20%
  • Open rate SMS-a: 98%
  • Średni czas otwarcia e-maila: kilka godzin
  • Średni czas otwarcia SMS-a: 90 sekund

Dla polskich klientów SMS jest szczególnie ważny — 87% Polaków akceptuje SMS jako kanał komunikacji z e-commerce.

Trzy drogi integracji

Metoda Trudność Koszt Kiedy wybrać
Aplikacja Shopify Łatwa Abonament (50-200 zł/mies.) Mały sklep, brak programisty
Webhooks + własny serwer Średnia 0 zł (poza hostingiem) Średni/duży sklep, jest programista
Shopify Flow (Plus) Łatwa W pakiecie Shopify Plus Sklep na Shopify Plus

Opcja 1: Gotowa aplikacja Shopify

W Shopify App Store znajdziesz kilka aplikacji SMS. Popularne:

  • SMSBump — od 39 USD/mies., integracja z polskimi bramkami przez API
  • Postscript — od 50 USD/mies., głównie SMS-y marketingowe
  • Shopify SMS Marketing — wbudowane (Shopify Email Marketing)

Uwaga: większość aplikacji to SMS-y marketingowe (subskrypcje, kampanie). SMS-y transakcyjne (o zamówieniu, wysyłce, dostawie) najczęściej trzeba skonfigurować osobno.

Opcja 2: Webhooks + własny serwer (rekomendowane)

Shopify oferuje webhooks — powiadomienia HTTP o zdarzeniach (utworzenie zamówienia, zmiana statusu, wysyłka). Możesz nasłuchiwać ich na własnym serwerze i wywoływać SMSIK API.

Krok 1: Klucz API SMSIK

Zarejestruj się na smsik.pl, wejdź w panel developera, kliknij "Nowy klucz".

Krok 2: Endpoint webhooka

Utwórz endpoint (np. /webhooks/shopify) na swoim serwerze, który odbiera webhooks z Shopify i wywołuje SMSIK API. Przykład w Node.js (Express):

const express = require('express');
const crypto = require('crypto');

const app = express();
app.use(express.json({
  verify: (req, res, buf) => { req.rawBody = buf; },
}));

const SMSIK_API_KEY = process.env.SMSIK_API_KEY;
const SHOPIFY_WEBHOOK_SECRET = process.env.SHOPIFY_WEBHOOK_SECRET;

// Weryfikacja podpisu Shopify (HMAC-SHA256)
function verifyShopifyWebhook(req) {
  const hmac = req.headers['x-shopify-hmac-sha256'];
  if (!hmac) return false;
  const expected = crypto
    .createHmac('sha256', SHOPIFY_WEBHOOK_SECRET)
    .update(req.rawBody)
    .digest('base64');
  return crypto.timingSafeEqual(
    Buffer.from(expected),
    Buffer.from(hmac),
  );
}

app.post('/webhooks/shopify/orders-create', async (req, res) => {
  if (!verifyShopifyWebhook(req)) {
    return res.status(401).send('Invalid signature');
  }

  const order = req.body;
  const phone = order.customer?.phone || order.billing_address?.phone;
  if (!phone) {
    return res.status(200).send('No phone');
  }

  const message =
    `Zamowienie #${order.order_number} przyjete. ` +
    `Dziekujemy za zakupy!`;

  try {
    const response = await fetch('https://smsik.pl/api/v1/sms/send', {
      method: 'POST',
      headers: {
        'X-API-Key': SMSIK_API_KEY,
        'Content-Type': 'application/json',
      },
      body: JSON.stringify({
        to_number: phone,
        message,
        idempotency_key: `shopify-order-${order.id}-created`,
      }),
    });

    if (!response.ok) {
      console.error('SMSIK error:', await response.text());
    }
  } catch (err) {
    console.error('SMSIK request failed:', err);
  }

  res.status(200).send('OK');
});

app.listen(3000, () => console.log('Webhook server on :3000'));

Krok 3: Zarejestruj webhook w Shopify

  1. Panel Shopify → Ustawienia → Powiadomienia → Webhooks
  2. Kliknij "Utwórz webhook"
  3. Event: orders/create, orders/paid, orders/fulfilled
  4. Format: JSON
  5. URL: https://twoj-serwer.pl/webhooks/shopify/orders-create
  6. Webhook API version: 2024-10 (najnowsza stabilna)

Shopify od razu wyśle testowe żądanie — sprawdź logi serwera.

Krok 4: Statusy do obsłużenia

Event ShopifyKiedyTreść SMS
orders/createPo złożeniu zamówienia"Zamówienie przyjęte"
orders/paidPo opłaceniu"Płatność potwierdzona"
orders/fulfilledPo wysyłce"Nadane, numer: XYZ"
orders/cancelledPo anulowaniu"Anulowane"
fulfillments/updatePo zmianie statusu przesyłki"W drodze / dostarczone"

Opcja 3: Shopify Flow (tylko Shopify Plus)

Shopify Flow to wizualny edytor automatyzacji — dostępny w planie Shopify Plus. Nie wymaga kodowania.

Jak skonfigurować:

  1. Panel Shopify → Aplikacje → Shopify Flow
  2. Kliknij "Utwórz workflow"
  3. Trigger: Order created
  4. Condition: Customer phone is not empty
  5. Action: Send HTTP request
  6. Wypełnij:
    • Method: POST
    • URL: https://smsik.pl/api/v1/sms/send
    • Headers: X-API-Key: sk_live_..., Content-Type: application/json
    • Body: JSON z numerem i treścią

Przykładowy body (w edytorze Flow, z użyciem {{ }}

{
  "to_number": "{{ order.customer.phone }}",
  "message": "Zamowienie #{{ order.name }} przyjete. Dziekujemy!",
  "idempotency_key": "shopify-order-{{ order.id }}-created"
}

RODO — co musisz wiedzieć

  • SMS-y transakcyjne (o zamówieniu, wysyłce) — bez zgody marketingowej, podstawa prawna: wykonanie umowy (art. 6 ust. 1 lit. b RODO)
  • SMS-y marketingowe (promocje, oferty) — wymagają zgody (art. 6 ust. 1 lit. a RODO)
  • DPA z SMSIK — gotowa do pobrania

Uwaga: Shopify przechowuje numery telefonów klientów. Musisz mieć podstawę prawną do ich użycia — najlepiej wyraźny checkbox przy checkout: "Chcę otrzymywać SMS-y o statusie zamówienia".

Koszty

Dla sklepu z 500 zamówieniami miesięcznie i 3 SMS-ami na zamówienie:

  • 1500 SMS × 1 gr = 15 zł miesięcznie

Alternatywa (aplikacja SMSBump): 39 USD/mies. = ~160 zł/mies. — nawet nie licząc kosztu SMS-ów.

Oszczędność z własną integracją: ~145 zł/mies. = 1740 zł rocznie.

Podsumowanie

  • ✅ 3 drogi integracji: aplikacja (łatwa, droga), webhooks (średnia, tania), Shopify Flow (tylko Plus)
  • ✅ Rekomendacja: webhooks + własny serwer (elastyczne, tanie)
  • ✅ Koszt SMS: 1 gr brutto
  • ✅ Weryfikacja HMAC webhooków Shopify — obowiązkowa
  • ✅ Zgodne z RODO (transakcyjne = wykonanie umowy)

Zarejestruj się bezpłatnie — 5 groszy na start.

Wyprobuj SMSIK bezplatnie

Rejestracja zajmuje 2 minuty. Otrzymasz 5 groszy na start.

Utworz darmowe konto