Pomoc i wdrożenie

Dokumentacja Vistrify

Jeden przewodnik dla nowych użytkowników: od konfiguracji konta do automatycznej publikacji artykułów.

1. Szybki start (10 minut)

  1. Załóż konto i potwierdź adres e-mail.
  2. Dodaj stronę w zakładce Sites i wybierz rynek docelowy (kraj + język).
  3. Wygeneruj słowa kluczowe, utwórz szkice, sprawdź treść.
  4. Podłącz publikację (WordPress lub API), a potem zaplanuj daty w Calendar.

2. Integracja z WordPress (najprostsza)

Użyj tej opcji, jeśli Twój blog działa na WordPress.

  1. W WordPress przejdź do Users -> Profile -> Application Passwords i utwórz nowe hasło aplikacji.
  2. W Vistrify: Integrations -> WordPress.
  3. Uzupełnij pola: wp_url (adres strony), wp_username (użytkownik WP), wp_app_password (hasło aplikacji).
  4. Kliknij Save WordPress, następnie opublikuj testowo jeden szkic z Drafts -> Publish to WordPress.

Jeśli publikacja się powiedzie, artykuł pojawi się od razu jako wpis w WordPress.

3. Integracja przez Custom API / Webhook

Użyj tej opcji, jeśli nie masz WordPress albo publikujesz do własnego CMS.

  1. Przygotuj endpoint API, który przyjmuje żądanie POST.
  2. W Vistrify wpisz webhook_url (pełny URL endpointu) oraz opcjonalnie api_key.
  3. Zapisz połączenie i przetestuj publikację na jednym szkicu.

Format żądania wysyłany przez Vistrify

POST /your-endpoint
Content-Type: application/json
Authorization: Bearer <api_key>   // only if api_key is set

{
  "title": "Article title",
  "body": "# Markdown content",
  "format": "markdown"
}

Minimalna odpowiedź endpointu

HTTP/1.1 200 OK
{ "ok": true }

4. Jak działa auto-publikacja

  1. W Calendar przeciągnij słowa kluczowe na konkretne dni albo użyj Auto-schedule.
  2. Dzienny cron generuje i publikuje zaplanowane wpisy.
  3. Jeśli publikacja się nie powiedzie, szkic zostaje wygenerowany i czeka na ręczne kliknięcie Publish.

5. Najczęstsze błędy i szybkie rozwiązania

  • 401 / 403: niepoprawny login, hasło aplikacji lub token API.
  • 404: zły adres webhooka lub endpoint nie istnieje.
  • 502: Vistrify nie może połączyć się z Twoim endpointem albo endpoint zwrócił błąd.
  • "No connection configured": połączenie publikacji nie zostało zapisane dla aktywnej strony.
  • Wpis nie pojawia się na stronie: endpoint przyjmuje dane, ale nie zapisuje ich do CMS/bazy.

6. Wsparcie

Jeśli chcesz, abyśmy sprawdzili integrację krok po kroku, napisz na info@vistrify.com i podaj domenę oraz typ integracji (WordPress lub API).