evernote-webhooks-events

Umożliwia integrację webhoków Evernote do swoich aplikacji. Skill obsługuje powiadomienia o zmianach notatek, aktualizacjach notesów i tworzeniu nowych wpisów. Po otrzymaniu sygnału z Evernote automatycznie pobiera zmienione dane za pośrednictwem sync API. Przydatny do budowania systemów, które muszą reagować na zmiany w Evernote w czasie rzeczywistym — bez konieczności ciągłego odpytywania serwera. Wymaga klucza API Evernote z uprawnieniami do webhoków oraz publicznie dostępnego HTTPS endpointa.

1. Przygotuj środowisko: upewnij się, że masz klucz API Evernote z włączonymi uprawnieniami do webhoków oraz publicznie dostępny HTTPS endpoint, na który Evernote będzie wysyłać powiadomienia.

2. Utwórz endpoint webhooka: skonfiguruj serwer (np. Express.js) aby odbierał żądania POST na ścieżce /evernote/webhook. Endpoint powinien natychmiast zwrócić kod HTTP 200, a następnie przetworzyć powiadomienie asynchronicznie.

3. Obsługuj parametry webhooka: Evernote wysyła trzy parametry — userId (identyfikator użytkownika), guid (identyfikator notesu), oraz reason (typ zdarzenia: create, update lub notebook). Na podstawie reason określ rodzaj zmiany.

4. Zarządzaj stanem synchronizacji: przechowuj ostatni numer USN (Update Sequence Number) dla każdego użytkownika. Po otrzymaniu webhooka pobierz aktualny USN serwera za pomocą getSyncState(), a następnie użyj getFilteredSyncChunk() aby pobrać tylko zmiany od ostatniej synchronizacji.

5. Przetwarzaj trzy typy zdarzeń: obsłuż zdarzenie create (nowa notatka), update (zmieniona notatka) i notebook (zmiana na poziomie notesu). Każde zdarzenie powinno wyzwolić synchronizację dotkniętego notesu.

6. Wdrażaj skill w Claude Code, Codex lub OpenClaw — tool obsługuje operacje Read, Write, Edit oraz Bash z dostępem do curl.