speak-webhooks-events

Implement Speak webhook signature validation and event handling for language learning.\nUse when setting up webhook endpoints, implementing signature verification,\nor handling Speak event notifications for lessons and progress.\nTrigger with phrases like \

1. 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.

2. Skonfiguruj webhooks poprzez utworzenie pliku konfiguracyjnego z kluczem API, identyfikatorem aplikacji i środowiskiem (development/production). Ustaw zmienne środowiskowe NODE_ENV oraz SPEAK_API_KEY.

3. 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.

4. 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.

5. 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.

6. 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.