Konfiguracja integracji Webhook

Cel

Automatyczne wysyłanie każdego dokumentu wygenerowanego przez POP (XML lub PDF) do zewnętrznego narzędzia: Zapier, Make (Integromat), CRM, Google Drive lub niestandardowego endpointu.

Wymagania wstępne

• Plan POP Basic lub wyższy — dostarczanie przez webhook nie jest dostępne w planie darmowym.
• Nasłuchujący endpoint HTTP (docelowy adres URL webhooka).

Kroki

1. Na popapi.io przejdź do Moje konto > Integracje > POP to Webhook > Połącz.
2. Skonfiguruj:
   • nazwę identyfikującą
   • docelowy adres URL webhooka
   • format danych: JSON lub XML
   • przełącznik aktywacji
3. W WordPressie: we wtyczce POP przejdź do Zaawansowane > Webhook, wpisz identyfikator webhooka utworzony w poprzednim kroku, włącz go i — jeśli chcesz wysyłkę w tle zamiast synchronicznej — włącz również automatyczną wysyłkę przez CRON.
4. W Shopify: wpisz identyfikator webhooka w ustawieniach aplikacji; na liście faktur pojawi się ikona umożliwiająca wysłanie danych.

Formaty

• JSON — zaprojektowany dla platform no-code (Zapier, Make): dane są automatycznie spłaszczane do struktury łatwej do zmapowania.
• XML — odpowiedni do archiwizacji lub systemów wymagających standardu FatturaPA; można go też wysłać jako załącznik.

Możesz jednocześnie skonfigurować wiele webhooków z różnymi adresami URL i formatami.

Typowe błędy

• Nieprawidłowy adres URL webhooka — sprawdź, czy adres URL jest publicznie dostępny i odpowiada poprawnie (samo poprawnej składni nie wystarczy).
• Nieobsługiwany format danych — używaj wyłącznie JSON lub XML; inne formaty są odrzucane.
• Webhook nic nie odbiera w środowisku testowym — oczekiwane ograniczenie: dostarczanie przez webhook nie jest dostępne w środowisku sandbox (zobacz use-sandbox-environment).

Powiązana konfiguracja

W przypadku przekazywania do n8n za pomocą dedykowanego konektora (np. Zoho), zobacz api/connectors oraz n8n.