How do I register a webhook endpoint?

Create the endpoint from the API or in Settings, then Developer, give it your URL, and choose the events to subscribe to. Mercateer returns a signing secret you use to verify deliveries, and you can update or remove the endpoint at any time.

What events can I subscribe to?

New lead captured, contact created, conversation started, conversation handoff requested, conversation closed, call completed, missed call, appointment booked, appointment rescheduled, and quote accepted. Subscribe to all of them or only the ones you need.

How do I verify a delivery came from Mercateer?

Every payload is signed with HMAC-SHA256 using your endpoint secret. Read the timestamp and signature from the signature header, compute the HMAC of "{timestamp}.{raw request body}", and compare it to the signature value, dropping the request if it does not match or if the timestamp is over 5 minutes old. That way a forged or replayed call can never trigger your handler. Our SDK ships a verify helper so you don’t have to implement this by hand.

What happens when my endpoint is down?

Failed deliveries retry with backoff for a window, so a brief outage does not lose events. Make your handler idempotent by keying on the event ID, since a retried delivery can arrive more than once.

Which Mercateer plan do I need?

Webhooks are part of API access, which is included on the Crew and Fleet plans. You can start building free to set up your agent, then upgrade to register endpoints.

Dla programistów

Otrzymuj zdarzenia z działu obsługi klienta Mercateer jako webhooki

Subskrybuj punkt końcowy (endpoint) na zdarzenia Mercateer i otrzymuj podpisaną paczkę danych dokładnie w momencie zakończenia rozmowy, przyjścia leada lub zarezerwowania zlecenia. Rejestruj i zarządzaj punktami końcowymi przez API lub panel, a każdą dostarczoną wiadomość weryfikuj za pomocą HMAC.

Zainstaluj w kilka minut Wszystkie integracje

Czym jest Webhooks?

Webhooki przesyłają zdarzenia z działu obsługi klienta Mercateer w czasie rzeczywistym na kontrolowany przez Ciebie adres URL, dzięki czemu Twoje własne systemy mogą reagować bez konieczności cyklicznego odpytywania API. Każda przesyłka to podpisany HMAC-em ładunek JSON; punkty końcowe rejestrujesz i zarządzasz przez API lub panel, a nieudane dostawy są ponawiane z wykładniczym opóźnieniem.

Co możesz zrobić z Webhooks

Nowy lead przechwycony i kontakt utworzony

Rozmowa rozpoczęta, zamknięta lub z prośbą o przekazanie do człowieka

Zakończone połączenie

Termin spotkania zarezerwowany i termin spotkania zmieniony

Zaakceptowana wycena

Ładunki podpisane HMAC-em, które weryfikujesz przy odbiorze

Rejestruj i zarządzaj punktami końcowymi przez API lub panel

Zainstaluj w kilka minut

Utwórz punkt końcowy

Zarejestruj swój adres URL i wybierz zdarzenia, na które chcesz subskrybować, przez API lub w Ustawienia → Deweloper. Mercateer zwróci sekret podpisywania dla tego punktu końcowego. Dostęp do API jest dostępny w planach Crew i Fleet.

Zweryfikuj podpis

Przy każdej dostawie odczytaj znacznik czasu (t) i podpis (v1) z nagłówka podpisu, następnie policz HMAC-SHA256 z ciągu "{timestamp}.{raw request body}" swoim sekretem podpisującym i porównaj go z wartością v1. Odrzuć każde żądanie, które się nie zgadza albo którego znacznik czasu jest starszy niż 5 minut, żeby działać wyłącznie na świeżych danych, które naprawdę przyszły z Mercateer. (Funkcja pomocnicza verify w naszym SDK robi to wszystko za Ciebie.)

Obsługuj ponowne próby idempotentnie

Szybko odpowiadaj kodem 2xx, aby potwierdzić odbiór. Nieudane dostawy są ponawiane z wykładniczym opóźnieniem, więc zaprojektuj swój program obsługujący tak, by identyfikował zdarzenia po ich ID – dzięki temu zignoruje duplikaty i przetworzy każde zdarzenie tylko raz.

Najczęściej zadawane pytania

Działa ze wszystkimi Twoimi narzędziami

Mercateer używa tych samych protokołów co narzędzia, z których już korzystasz.

Claude Desktop Claude Code Claude Cowork ChatGPT Cursor Codex OpenCode Zapier n8n Make.com

Zobacz wszystkie integracje

Wykorzystaj Mercateer razem z Webhooks

Zacznij za darmo i podłącz swoje biuro obsługi klienta w kilka minut.

Zacznij za darmo

Nie wymaga karty kredytowej

Otrzymuj zdarzenia z działu obsługi klienta Mercateer jako webhooki

Czym jest Webhooks?

Co możesz zrobić z Webhooks

Zainstaluj w kilka minut

Utwórz punkt końcowy

Zweryfikuj podpis

Obsługuj ponowne próby idempotentnie

Najczęściej zadawane pytania

Jak zarejestrować punkt końcowy webhooka?

Na jakie zdarzenia mogę się subskrybować?

Jak zweryfikować, że dostawa faktycznie pochodzi od Mercateer?

Co się dzieje, gdy mój punkt końcowy jest niedostępny?

Który plan Mercateer mi potrzebny?

Działa ze wszystkimi Twoimi narzędziami

Wykorzystaj Mercateer razem z Webhooks