Połącz Route Planner Teams z Zapierem

Co możesz zautomatyzować

Integracja Route Planner Teams w Zapierze ma jedną akcję, jedno wyszukiwanie i trzy wyzwalacze:

Create Order

Dodaje zamówienie do Skrzynki na dzień dostawy: adres, odbiorca, telefon, notatka, okno czasowe, czas na przystanku, typ przystanku, kod paczki, podpis.

Find Order

Znajduje zamówienie po External ID lub ID zamówienia — z odbiorcą, adresem i statusem.

Order Delivered

Uruchamia się, gdy kierowca oznaczy zamówienie jako dostarczone — z godziną i potwierdzeniem dostawy: linki do zdjęcia i podpisu, notatka.

Order Failed

Uruchamia się, gdy kierowca oznaczy zamówienie jako niedostarczone — z powodem.

Route Completed

Uruchamia się, gdy kierowca zakończy trasę — z liczbą dostarczonych i niedostarczonych przystanków.

Order Delivered i Order Failed działają dla zamówień, które przyszły przez Zapiera lub API. Przystanki dodane przez Ciebie na stronie ich nie uruchamiają; Route Completed działa dla każdej trasy.

Krok 1. Utwórz klucz API

Zapier loguje się do Twojego zespołu kluczem API. Może go utworzyć właściciel zespołu i dyspozytorzy.

1. Otwórz stronę Route Planner Teams i przejdź do sekcji Zespół.
2. Przewiń do sekcji Integracje i kliknij Utwórz klucz API.
3. W polu Nazwa wpisz, do czego jest klucz, na przykład Zapier, i kliknij Utwórz klucz API.
4. Kliknij Kopiuj i miej klucz pod ręką na krok 2. Zaczyna się od rpt_live_ i jest pokazywany tylko raz: po Gotowe lista pokazuje już tylko jego początek.

Krok 2. Połącz Route Planner Teams w Zapierze

Integracji nie ma jeszcze w publicznym katalogu aplikacji Zapiera, więc dodajesz ją przez link z zaproszeniem.

1. Otwórz link z zaproszeniem do Route Planner Teams, zaloguj się do Zapiera lub załóż darmowe konto i przyjmij zaproszenie (Accept Invite & Build a Zap).
2. W edytorze Zapa dodaj krok, wyszukaj Route Planner Teams i wybierz zdarzenie, na przykład Create Order.
3. W kroku konta połącz nowe konto: Zapier poprosi o API key. Wklej klucz z kroku 1 i przejdź dalej.
4. Połączenie nosi nazwę Twojego zespołu. Kolejne Zapy mogą korzystać z tego samego połączenia, więc robisz to tylko raz.

Zapier twierdzi, że klucz jest nieprawidłowy? Sprawdź, czy klucz został skopiowany w całości — od rpt_live_ do ostatniego znaku — i czy nie został unieważniony w sekcji Integracje.

Krok 3. Nowy wiersz w Arkuszach Google staje się zamówieniem

Najczęstszy Zap: Ty lub pracownicy sklepu wpisujecie zamówienia do arkusza, a każdy nowy wiersz pojawia się w Skrzynce. Zacznij od arkusza, którego pierwszy wiersz zawiera nazwy kolumn, na przykład:

1. Utwórz Zapa. Wyzwalacz: Google Sheets, zdarzenie New Spreadsheet Row; wybierz arkusz i kartę.
2. Akcja: Route Planner Teams, zdarzenie Create Order i połączenie z kroku 2.
3. Uzupełnij pola kolumnami arkusza, jak w tabeli. Bez kolumny Data zostaw Delivery Date puste: zamówienia trafią na dziś.
4. Kliknij Test step: testowe zamówienie pojawi się w Skrzynce w sekcji Trasy w dniu dostawy. Następnie opublikuj Zapa.
5. W sekcji Trasy zaznacz zamówienia w Skrzynce i kliknij Dodaj do trasy: utwórz nową trasę albo dodaj je do trasy z tego dnia. Potem jak zwykle zoptymalizuj trasę i wyślij ją kierowcy — zobacz Optymalizacja z oknami dostawy i Przypisz kierowcę i śledź dzień.

Inne źródła działają tak samo: wybierz wyzwalacz „nowe zamówienie” swojego sklepu (na przykład w Shopify) lub „nowa odpowiedź” formularza, a potem Create Order. Niepotrzebne zamówienie usuniesz przyciskiem Odrzuć.

Krok 4. Powiadom klienta lub arkusz o dostawie

Aktualizacje od kierowców nie zawierają imienia, telefonu ani adresu odbiorcy — tylko External ID zamówienia, status, godzinę i potwierdzenie dostawy. Po External ID (Twoim numerze zamówienia) znajdziesz zamówienie we własnym arkuszu.

1. Utwórz Zapa z wyzwalaczem Route Planner Teams, zdarzenie Order Delivered. Zapier wczyta ostatnie dostarczone zamówienia albo przykład, jeśli jeszcze ich nie ma.
2. Aby prowadzić rejestr dostaw, dodaj Google Sheets → Create Spreadsheet Row i uzupełnij External ID, Delivered At oraz Proof of Delivery Photo URLs.
3. Aby wysłać e-mail klientowi, najpierw dodaj Google Sheets → Lookup Spreadsheet Row: szukaj External ID w kolumnie Nr zamówienia. Potem dodaj Gmail → Send Email na adres z kolumny E-mail znalezionego wiersza.
4. Opublikuj Zapa. Zapier od razu subskrybuje aktualizacje: w sekcji Integracje pod Webhooki pojawi się webhook. Wyłączenie Zapa go usuwa.

Zap uruchamia się kilka sekund po tym, jak kierowca oznaczy przystanek. Tak samo zrób z Order Failed, żeby oddzwonić do klienta lub umówić dostawę ponownie, i z Route Completed dla dziennego podsumowania.

Linki do zdjęć i podpisu działają 7 dni. Aby zachować je dłużej, zapisz pliki w kolejnym kroku, na przykład na Dysku Google. Zapy z więcej niż jedną akcją mogą wymagać płatnego planu Zapiera.

Warto wiedzieć

• External ID chroni przed duplikatami. Przypisz numer zamówienia do External ID. Jeśli Zap uruchomi się dwa razy dla tego samego zamówienia, drugie uruchomienie znajdzie istniejące zamówienie i nie utworzy nowego.
• Czas na przystanku. Pole Service Time (minutes) to czas, którego kierowca potrzebuje pod tym adresem, od 0 do 120. Puste — Minut na przystanek z trasy.
• Okna czasowe. Uzupełnij oba pola Time Window From i Time Window To w formacie GG:MM, 24-godzinnym. Optymalizacja zaplanuje przystanek w oknie.
• Daty i adresy. Pole Delivery Date ma format RRRR-MM-DD — tak sformatuj kolumnę Data w arkuszu; puste — dziś w strefie czasowej zespołu. Wysyłaj pełny adres z kodem pocztowym i miastem albo Latitude i Longitude. Jeśli adresu nie da się znaleźć, Zap pokaże błąd w historii i zamówienie nie powstanie; niepewny trafi do Skrzynki z oznaczeniem sprawdź adres.
• Co się liczy. Zamówienie z adresem liczy się w sekcji Subskrypcja w pozycji Adresy wyszukane z list; wysłane ze współrzędnymi — nie. Przystanek liczy się, gdy dodasz zamówienie do trasy, jak każdy inny przystanek.
• Limity. Każdy klucz API może wysłać do 600 zapytań na 10 minut i 5000 na dzień. Po osiągnięciu limitu Zapier odczeka i spróbuje ponownie.
• Pozycja kierowcy. Włącz Udostępniaj pozycję kierowcy na przystanku w sekcji Integracje, a aktualizacje będą zawierać miejsce, w którym kierowca oznaczył przystanek.
• Chroń klucz. Kto ma klucz, może tworzyć zamówienia i czytać Twoje dostawy. Używaj jednego klucza na usługę, a jeśli klucz wycieknie, kliknij Unieważnij w sekcji Integracje: Zapy z nim przestaną działać od razu. Utwórz nowy klucz i połącz konto w Zapierze ponownie.

Dla programistów: API

Wszystko, co robi integracja z Zapierem, jest też dostępne przez REST API z webhookami — dla Twojego sklepu, systemu zamówień lub własnych skryptów. Zobacz dokumentację API (po angielsku).