Jak podłączyć integrację przez marketplace:
- Użytkownik klika «Podłącz» na stronie Twojej aplikacji w marketplace Altegio.
- Altegio poprosi użytkownika o zgodę na dostęp do jego konta przez API. Następnie integrację można podłączyć zapytaniem API po Twojej stronie.
- Z Altegio użytkownik zostanie przekierowany na adres URL formularza rejestracji w Twoim serwisie, podany w ustawieniach aplikacji w polu «Registration redirect url».
- Do adresu URL formularza rejestracji zostanie dodany parametr GET salon_id. Jego wartość to ID lokalizacji w Altegio (
salon_idto ID lokalizacji).
Po rejestracji/autoryzacji po stronie Twojego serwisu musisz wysłać zapytanie API, aby podłączyć integrację — w ciągu 1 godziny od udzielenia dostępu przez użytkownika (w przeciwnym razie otrzymasz błąd, a użytkownik będzie musiał ponownie podłączyć integrację przez marketplace).
Zapytanie o podłączenie
Wyślij z Twojego serwisu następujące zapytanie, aby podłączyć integrację:
- Metoda i URL:
POST https://app.alteg.io/marketplace/partner/callback— uwaga: katalog główny app.alteg.io, a nieapi.alteg.io/api/v1. - Authorization:
Bearer <Partner Token>— Twój Partner Token z sekcji Marketplace → Account settings. - Treść:
{"salon_id": <ID lokalizacji>, "application_id": <ID aplikacji>}—salon_idto ID lokalizacji. - Wynik:
201— powiązanie aplikacji z lokalizacją zmienia się z pending na active. - Termin: w ciągu 1 godziny od udzielenia dostępu przez użytkownika.
Pełny przykład krok po kroku (właściciel podłącza → potwierdzenie → weryfikacja) znajdziesz w przewodniku dla deweloperów Install & test your app before moderation.
Po wysłaniu zapytania API o podłączenie integracja z Twoim serwisem zostanie włączona na koncie lokalizacji Altegio:
- Do konta klienta zostanie dodany Twój użytkownik systemowy. ID użytkownika systemowego podajesz w ustawieniach aplikacji w polu «User Id». Za pomocą tokena bearer tego użytkownika będziesz wysyłać zapytania do API lokalizacji zgodnie z żądanymi uprawnieniami.
- Na podane przez Ciebie adresy webhooków zaczną przychodzić zdarzenia o zmianach w lokalizacji.
- Jeśli Twoja integracja jest w kategorii «Powiadomienia», do ustawień lokalizacji zostanie też dodany Twój API_KEY do wysyłania powiadomień systemowych.
Dobre praktyki
Zalecamy wysłanie zapytania o podłączenie integracji od razu po zakończeniu rejestracji użytkownika po stronie Twojego serwisu. Uzyskasz wtedy dostęp do API lokalizacji i będziesz mógł pobrać potrzebne dane o lokalizacji i użytkowniku, aby uprościć dalszą konfigurację integracji po Twojej stronie.
Weź też pod uwagę, że z marketplace Altegio może trafić do Ciebie użytkownik już zarejestrowany/zalogowany w Twoim serwisie. Wysyłaj zapytanie o podłączenie nie tylko przy rejestracji, ale też gdy użytkownik loguje się do Twojego serwisu lub przechodzi z marketplace Altegio bezpośrednio do konta w Twoim serwisie.
Zwróć uwagę
Automatyczna rejestracja użytkownika w Twoim systemie
Aby uprościć podłączanie integracji, możesz włączyć przekazywanie danych użytkownika przy podłączeniu. Wtedy przy podłączaniu integracji otrzymasz dane użytkownika (imię, telefon, e-mail) i automatycznie zarejestrujesz go w swoim systemie, bez wypełniania formularza. Według naszych danych zwiększa to konwersję podłączeń o 30–40%. Więcej.
Podłączanie integracji do kilku lokalizacji jednocześnie
Jeśli Twoja integracja działa z kilkoma lokalizacjami Altegio, włącz ustawienie «Zezwól na dodawanie aplikacji do kilku lokalizacji». Wtedy przy podłączaniu użytkownik będzie mógł wybrać, do których lokalizacji zainstalować integrację. Więcej.
Podłączanie i konfiguracja integracji w iframe
Możesz włączyć ustawienie «Otwieraj formularz rejestracji w iframe». Wtedy po kliknięciu «Podłącz» strona rejestracji Twojego serwisu otworzy się w zakładce «Ustawienia» w karcie Twojej aplikacji w marketplace. Znacznie zwiększa to zaufanie użytkowników, ponieważ interakcja odbywa się w znajomym interfejsie Altegio. Więcej.