speak-webhooks-events
Obsługuj zdarzenia webhooków platformy Speak do nauki języków
Instalacja
Wybierz klienta i sklonuj repozytorium do odpowiedniego katalogu skilli.
Instalacja
O skillu
Skill do zarządzania webhookami i powiadomieniami z platformy Speak. Implementuj walidację podpisów webhooków, obsługuj zdarzenia ukończenia lekcji, śledzenia postępów i osiągnięć użytkowników. Wymagane wcześniejsze skonfigurowanie autentykacji Speak oraz ważne poświadczenia API. Idealny do integracji operacji platformy edukacyjnej z Twoim systemem.
Jak używać
Upewnij się, że masz ukończoną konfigurację autentykacji Speak (skill speak-install-auth) i ważne poświadczenia API dostępne w zmiennych środowiskowych SPEAK_API_KEY i SPEAK_APP_ID.
Skonfiguruj webhooks poprzez utworzenie pliku konfiguracyjnego z kluczem API, identyfikatorem aplikacji i środowiskiem (development/production). Ustaw zmienne środowiskowe NODE_ENV oraz SPEAK_API_KEY.
Zaimplementuj klienta Speak przy użyciu biblioteki @speak/language-sdk. Inicjalizuj SpeakClient z przygotowaną konfiguracją i ustaw obsługę zdarzeń dla ukończenia lekcji, postępów i powiadomień o osiągnięciach.
Zweryfikuj połączenie z API Speak poprzez wysłanie żądania health check do https://api.speak.com/v1/health z nagłówkiem Authorization zawierającym token Bearer. Użyj curl lub innego narzędzia HTTP do testowania.
Wdrażaj obsługę błędów dla typowych kodów odpowiedzi (401 dla nieautoryzowanego dostępu, 429 dla ograniczenia częstotliwości). Sprawdzaj poprawność klucza API i dostosuj tempo żądań do limitów platformy.
Uruchom integrację w środowisku produkcyjnym i monitoruj zdarzenia webhooków. Webhook powinien być gotowy do odbierania powiadomień o zmianach stanu lekcji i postępów użytkowników.