Simply ConnectPrzejdź do panelu
IntegracjeNode.js

Node.js bez NestJS · v0.1.0

Simply Connect
dla Node.js.

Instalujesz tylko klienta @simply-connect/node. Dostajesz ESM, CommonJS i typy bez dependency injection ani panelu frameworkowego.

Pobierz klienta v0.1.0 Pokaż instrukcję
Gotowa integracja · v0.1.0

Dla kogo jest ta integracja

Najpierw sprawdź, czy to rozwiązanie dla Ciebie.

Dla backendów, workerów i skryptów Node.js w JavaScript lub TypeScript. Jeśli aplikacja korzysta z NestJS, wybierz osobny poradnik modułu frameworkowego.

Co dostajesz

Mniej ręcznej pracy.
Więcej pewności.

01

ESM, CommonJS i deklaracje TypeScript

02

Lekki klient oparty o natywny fetch

03

SMS-y i dostępne bramki

04

Historia, IVR i kolejka połączeń

05

Brak automatycznych powtórek mutacji

Instalacja krok po kroku

Bez zgadywania. Zrobisz to po kolei.

Każdy krok mówi, gdzie wejść i czego oczekiwać. Najpierw uruchom podstawową wysyłkę, dopiero potem włącz kolejne automatyzacje.

  1. 1

    Zainstaluj klienta Node.js

    Pierwsze wydanie instalujesz z niezmiennego artefaktu GitHub. W kodzie nadal importujesz kanoniczną nazwę @simply-connect/node.

    npm install \
  https://github.com/karlos1998/simply-connect-node/releases/download/v0.1.0/simply-connect-node-0.1.0.tgz
  2. 2

    Utwórz klucz API

    W panelu Simply Connect otwórz Developer → API keys. Do wysyłki SMS wystarczy SMS_SEND; historia wymaga MESSAGES_READ, a kolejka połączeń CALL_QUEUE_READ i CALL_QUEUE_WRITE.

    Otwórz panel Simply Connect
  3. 3

    Dodaj sekrety do środowiska

    Klucz i UUID bramki trzymaj poza repozytorium. Id bramki znajdziesz w szczegółach klucza API albo pobierzesz metodą listSmsEndpoints().

    SIMPLY_CONNECT_API_KEY=msc_live_twoj_sekret
SIMPLY_CONNECT_SMS_ENDPOINT_ID=uuid_twojej_bramki
  4. 4

    Utwórz klienta

    Kod działa w TypeScript oraz JavaScript, w ESM i CommonJS. Utwórz jedną instancję na proces.

    import { SimplyConnectClient } from '@simply-connect/node';

const client = new SimplyConnectClient({
  apiKey: process.env.SIMPLY_CONNECT_API_KEY!,
  defaultSmsEndpointId:
    process.env.SIMPLY_CONNECT_SMS_ENDPOINT_ID,
});
  5. 5

    Wyślij pierwszy SMS

    Przekaż biznesowy klucz idempotencji. SDK nie ponawia automatycznie operacji, która mogła już wysłać wiadomość.

    await client.sendSms(
  {
    to: '+48500100200',
    body: 'Zamówienie jest gotowe.',
  },
  { idempotencyKey: 'order-1842-ready' },
);

Test po instalacji

Po czym poznasz, że wszystko działa?

Nie zaczynaj od masowej wysyłki. Przejdź tę krótką listę na jednym kontrolowanym numerze.

  1. 1Import działa zarówno przez import, jak i require.
  2. 2listSmsEndpoints() pokazuje bramki dozwolone dla klucza.
  3. 3Wysłanie zwraca identyfikatory wiadomości i status QUEUED.
  4. 4Wiadomość pojawia się w panelu Simply Connect i wychodzi wybraną bramką.

Gdy coś nie ruszy

Najczęstsze problemy

Najpierw sprawdź poniższe rzeczy — zwykle rozwiązanie jest tutaj.

Node zgłasza błąd wersji lub ładowania ESM

Użyj Node.js 22.12+, 24 albo 26. Paczka ma osobne wejścia ESM i CommonJS; nie uruchamiaj jej bezpośrednio w przeglądarce.

Czy klient ma panel WWW?

Nie. Panel jest funkcją osobnego modułu NestJS. Czysty klient Node.js pozostaje mały i framework-neutralny.

Operacja zakończyła się jako UNKNOWN

Nie twórz nowego SMS-a ani połączenia w ciemno. UNKNOWN oznacza niejednoznaczny wynik. Sprawdź stan i ponów wyłącznie tę samą operację z tym samym kluczem idempotencji lub requestId.

Gotowe do uruchomienia

Połącz Node.js z własnym numerem.

Integracja jest otwarta i wersjonowana. Kod możesz sprawdzić przed instalacją, a w razie pytania napisać do nas.

Nazwy i znaki należą do ich właścicieli. Integracja nie oznacza partnerstwa ani certyfikacji przez właściciela danego narzędzia.
Pobierz klienta v0.1.0 Zobacz kod na GitHubiePotrzebujesz pomocy?