API i webhooki
API i webhooki
Publiczne API PingsYou dla programisty: dodawanie kontaktów, zamówień i zdarzeń oraz webhooki sklepów.
Ostatnia aktualizacja:
Na tej stronie
Ten artykuł jest dla osoby, która podłącza PingsYou do Twojej strony lub sklepu.
Klucz API
Utwórz klucz w Połącz z AI → Klucz z własną nazwą → Utwórz klucz. Ten sam klucz działa w API i MCP. Wysyłaj go w nagłówku Authorization: Bearer py_…. API pozwala na zapytania z przeglądarek (CORS).
Adresy
| Metoda i adres | Do czego |
|---|---|
POST /api/public/contacts | Dodaje lub uzupełnia kontakt: email, first_name, last_name, tags (do 20), fields, consent. Do 500 osób naraz w contacts. Tagi uruchamiają ścieżki. |
POST /api/public/orders | Zamówienie: email, total (wymagane), currency, items (nazwa, ilość, cena), external_id. Dodaje tagi klient i kupil-<produkt> i uruchamia ścieżki po zakupie. |
POST /api/public/events | Z kluczem: back_in_stock albo price_drop dla produktu. Bez klucza, z ?k=KLUCZ_STRONY: zdarzenia ze strony (page_view, product_view, cart, custom). |
GET/POST /api/public/forms/{klucz} | Dane formularza / zapis przez własny formularz (z double opt-in, jeśli włączony). |
curl -X POST https://pingsyou.com/api/public/contacts \
-H "Authorization: Bearer py_TWÓJ_KLUCZ" \
-H "Content-Type: application/json" \
-d '{"email":"anna@example.com","first_name":"Anna","tags":["webinar"]}'Webhooki sklepów
- Shopify: webhook zamówień na adres
/api/webhooks/shopify?k=KLUCZ_STRONY(podpis HMAC Shopify). - WooCommerce: webhook na
/api/webhooks/woocommerce?k=KLUCZ_STRONY(statusy w realizacji, zrealizowane, wstrzymane). - Klucz strony znajdziesz w Ustawienia → Śledzenie.