Czy Ko-fi ma API lub webhook?

Ko-fi oferuje API z webhookami, które automatycznie wysyłają informacje o płatnościach, co umożliwia twórcom natychmiastowe powiadomienia o darowiznach i członkostwach. Twórcy mogą konfigurować webhooki, aby automatyzować działania, takie jak aktualizacje stron czy zarządzanie sklepem. Webhooki działają w czasie rzeczywistym, dostarczając powiadomienia bez potrzeby ciągłego sprawdzania. Można je integrować z narzędziami jak Zapier, a także testować za pomocą Webhook.site. Obecnie API Ko-fi obsługuje tylko powiadomienia o płatnościach.

Krótko mówiąc, tak! Ko-fi ma API, które pozwala na przesyłanie informacji o płatnościach za pomocą webhooka. Możesz to skonfigurować i zobaczyć, jakie informacje są wysyłane na naszej stronie Webhooków.

Jak to działa?

Webhooki to zautomatyzowane wiadomości wysyłane, gdy coś się dzieje na platformie. Na Ko-fi webhooki są wysyłane, gdy następuje płatność.

Oto jak to działa:

1. Otrzymanie płatności: Najpierw na platformie odbywa się zdarzenie płatności. Może to być coś takiego jak wsparcie, które dokonuje darowizny na twojej stronie Ko-fi lub nowy członek dołączający do twojej społeczności.
2. Konfiguracja webhooka: Ty, jako twórca, konfigurujesz webhook z wyprzedzeniem. Informujesz Ko-fi, gdzie wysyłać powiadomienia, gdy wystąpią określone zdarzenia. Podajesz konkretny adres URL, na który twój webhook powinien dostarczać wiadomości.
3. Natychmiastowe powiadomienie: Gdy nastąpi zdarzenie płatności (np. nowa darowizna), Ko-fi natychmiast wysyła wiadomość na podany przez ciebie URL. Ta wiadomość zawiera wszystkie ważne szczegóły dotyczące zdarzenia, takie jak kto dokonał darowizny i ile.
4. Twoja akcja: Możesz zaprogramować swoje systemy lub aplikacje, aby automatycznie podejmowały określone działania na podstawie informacji otrzymanych z webhooka. Na przykład możesz zarejestrować informacje o zamówieniach sklepu w arkuszu kalkulacyjnym lub zaktualizować swoją stronę internetową, aby odzwierciedlić nową darowiznę.
5. Korzyści w czasie rzeczywistym: Webhooki dostarczają powiadomienia o płatnościach w czasie rzeczywistym, więc nie musisz ich ciągle sprawdzać. Webhook dostarcza ci wiadomości, gdy tylko to się wydarzy. To pomaga ci pozostać w kontakcie z twoją publicznością i podejmować działania na czas.

Webhook to jak cyfrowy pomocnik, który utrzymuje cię na bieżąco i automatyzuje zadania, co sprawia, że twoje doświadczenie z Ko-fi jest płynniejsze.

Jak mogę używać webhooka?

Możesz używać webhooków Ko-fi na różne kreatywne sposoby, aby wzbogacić swoje doświadczenie z Ko-fi i skuteczniej angażować swoich zwolenników. Oto kilka sposobów, aby w pełni wykorzystać webhooki Ko-fi:

1. Powiadomienia w czasie rzeczywistym: Otrzymuj natychmiastowe powiadomienia o nowych darowiznach, członkostwach i innych płatnościach na swojej stronie Ko-fi, co pozwala ci szybko dziękować wspierającym.
2. Dostarczenie treści: Automatyzuj dostarczanie treści cyfrowych do wspierających, gdy tylko dokonają darowizny lub zostaną członkami.
3. Narzędzie e-commerce: Skutecznie zarządzaj swoim sklepem Ko-fi, otrzymując powiadomienia o nowych zamówieniach, aktualizując arkusze kalkulacyjne i śledząc sprzedaż za pomocą webhooków.
4. Wzrost listy e-mailowej: Automatycznie dodawaj nowych wspierających do swojej listy marketingowej e-mailowej, co pomaga ci poszerzyć zasięg i informować wspierających o twojej najnowszej pracy.

Zarządzanie twoim webhookiem

Aby rozpocząć, przejdź do swojej strony webhooków i określ adres URL, na który Ko-fi powinien wysyłać webhook.

Gdy dokonana zostanie płatność, Ko-fi wyśle żądanie HTTP POST zawierające wszystkie dane płatności.

Oto przykład danych, które otrzymasz dla pojedynczej darowizny:

  Wskazówka

Na stronie webhooków możesz wysyłać testowe płatności, aby zobaczyć dane wysyłane po zakończeniu płatności.

Do testowania przykładowych płatności możesz spróbować Webhook.site.

Łączenie z Zapier

Zamiast samodzielnie konfigurować webhooka, możesz użyć Zapier. Dzięki Zapier możesz automatyzować zadania, łączyć Ko-fi z ulubionymi narzędziami i osiągać więcej bez większego wysiłku.

Aby uzyskać więcej informacji na temat łączenia Ko-fi z innymi aplikacjami za pośrednictwem Zapier, sprawdź nasz artykuł pomocy tutaj.

Przyznawanie ról z Discordem

Aby przyznać i zarządzać rolami z Discordem, zalecamy użycie naszego oficjalnego bota Ko-fi zamiast korzystania z webhooka. Więcej informacji na temat konfiguracji tego rozwiązania można znaleźć tutaj.

Mój webhook nie wysyła

Twój odbiornik powinien zwrócić kod statusu 200. Jeśli nie otrzymamy tego kodu statusu, spróbujemy ponownie w rozsądnej liczbie razy z tym samym message_id.

Możesz przetestować, czy webhooki są wysyłane poprawnie, korzystając z https://webhook.site/. Jeśli możesz odbierać żądania na tej stronie, może być problem z możliwością twojej aplikacji do odbierania webhooków.

Masz nadal problemy? Skontaktuj się z nami tutaj i postaramy się pomóc tak najlepiej, jak potrafimy.

Czy mogę używać webhooków do czegoś innego niż płatności?

Nasze API jest obecnie ograniczone do sytuacji, gdy dokonana jest płatność. Na przykład webhook może powiadomić cię, gdy otrzymasz płatność za członkostwo, ale nie może poinformować cię, jeśli członkostwo wygasło. Dodamy więcej funkcji do funkcjonalności webhooków, gdy tylko będziemy mogli.

Jeśli jest jakaś funkcja, którą chciałbyś dodać do API, możesz przesłać nam prośbę o funkcję.

Jesteśmy tutaj, jeśli nas potrzebujesz. Nie wahaj się wysłać zapytania w naszą stronę. 💌