Zarządzanie wywołaniami API integracji z Salesforce oraz błędami synchronizacji

W integracji HubSpot z Salesforce mogą wystąpić błędy synchronizacji, które uniemożliwiają synchronizację danych. Błędy te można zidentyfikować i usunąć w ustawieniach integracji z Salesforce.

Dostosuj limit wywołań API

1. Na koncie HubSpot kliknij ikonę ustawień w górnym pasku nawigacyjnym. W menu na lewym pasku bocznym przejdź do Integracje > Połączone aplikacje.
2. Na liście połączonych aplikacji kliknijSalesforce. 
3. Przejdź do zakładki Synchronizacja danych. 
4. W zakładce Stan synchronizacji, w sekcji Wykorzystanie wywołań API, sprawdź, ile wywołań API wykorzystałeś w ciągu ostatnich 24 godzin. Liczba„Ograniczone przez Salesforce” to liczba wywołań API, które możesz wykonać na podstawie ustawień Salesforce. Aby dostosować liczbę wywołań przydzielonych do HubSpot, edytuj pole Przydzielone do HubSpot. 

Wyświetl błędy synchronizacji Salesforce

1. Na koncie HubSpot kliknij ikonę ustawień w górnym pasku nawigacyjnym. W menu na lewym pasku bocznym przejdź do Integracje > Połączone aplikacje.
2. Na liście połączonych aplikacji kliknijSalesforce. 
3. Przejdź do zakładki „Synchronizacja danych”. 
4. W zakładce „Stan synchronizacji”, wsekcji„Błędy synchronizacji” , wyświetl karty dla każdego typu błędu wraz z liczbą bieżących błędów i rekordów, których dotyczą. Kliknij kartę typu błędu, aby wyświetlić szczegóły błędów w prawym panelu. Dowiedz się więcej o każdym typie błędu i zaleceniach dotyczących ich rozwiązywania. 

5. Aby wyświetlić więcej szczegółów dotyczących błędu, kliknij ikonę informacji w kolumnie „Typ błędu ”.
6. Aby podjąć działania dotyczące poszczególnych rekordów, kliknij [#] rekordów w kolumnie „Rekordy, których dotyczy błąd”, a następnie kliknij „Działania” > „Utwórz tymczasowy widok rekordów HubSpot”, aby utworzyć przefiltrowany widok rekordów, których dotyczy błąd. 
7. Po usunięciu błędów wróć do listy błędów. Zaznaczpole wyboru po lewej stronie każdego usuniętego błędu i kliknij opcję „Resync”.
8. Aby wyeksportować błędy, kliknij opcję Eksportuj błędy (CSV) w lewym górnym rogu listy błędów.

Rodzaje błędów synchronizacji Salesforce

Powiązania

Przykłady błędów powiązań 

• Osiągnięto limit powiązań
• Oczekiwanie na synchronizację konta

• Niezgodność kardynalności powiązań

Co oznaczają te błędy

Rekordy nie są synchronizowane, ponieważ są powiązane z kontami w Salesforce, które nie zostały jeszcze zsynchronizowane z firmami w HubSpot, lub ponieważ są powiązane z rekordami, które osiągnęły limit powiązań rekordów w HubSpot. 

Błąd niezgodności kardynalności powiązania występuje, gdy aktywność powiązana z wieloma kontaktami w HubSpot próbuje zsynchronizować się z Salesforce. Integracja obsługuje synchronizację tylko jednego powiązania z kontaktem na aktywność.

Jak rozwiązać te błędy 

Aby rozwiązać błąd „Osiągnięto limit powiązań”, możesz usunąć niektóre z powiązanych rekordów lub powiązać je z innym rekordem w Salesforce, a następnie kontynuować synchronizację.

Aby rozwiązać błąd „Oczekiwanie na synchronizację konta ”, zaleca się przeprowadzenie importu kont z Salesforce. 

Aby rozwiązać błąd „Niezgodność kardynalności powiązania”, usuń dodatkowe powiązania z kontaktami, tak aby tylko jeden kontakt pozostał powiązany z działaniem.

Kod niestandardowy

Przykłady błędów kodu niestandardowego 

• Automatyzacja Salesforce
• Brak identyfikatora kontaktu
• Reguła walidacji pola niestandardowego w Salesforce
• Przepływ w Salesforce

Co oznaczają te błędy

Rekordy nie są synchronizowane z powodu problemu spowodowanego automatyzacją, przepływami lub regułami walidacji na koncie Salesforce.

Jak rozwiązać te błędy

Duplikaty

Przykłady błędów związanych z duplikatami

• Adres e-mail jest już używany
• Reguła dotycząca duplikatów w Salesforce

Co oznaczają te błędy

Potencjalny klient lub kontakt z Salesforce nie może zostać zsynchronizowany z HubSpot, ponieważ adres e-mail już istnieje w rekordzie kontaktu w HubSpot lub z powodu reguły deduplikacji w Salesforce. 

Jak rozwiązać te błędy

Aby rozwiązać błąd „Adres e-mail jest już używany ”, usuń ten adres e-mail z istniejącego kontaktu w HubSpot.

Aby rozwiązać błąd związany z regułą deduplikacji w Salesforce , zaleca się , aby administrator Salesforce sprawdził reguły dopasowywania ustawione w Salesforce w celu deduplikacji. Następnie przed ponowną próbą synchronizacji w HubSpot należy scalić, zaktualizować lub usunąć wszelkie konfliktowe rekordy w Salesforce albo dostosować regułę deduplikacji w Salesforce.

Uprawnienia

Przykłady błędów związanych z uprawnieniami

• Niewystarczające uprawnienia lub brakujący rekord w Salesforce
• Uprawnienia do pól w Salesforce
• Niewystarczający dostęp do Salesforce

Co oznaczają te błędy

Zmiany wprowadzone w HubSpot nie mogą zostać zsynchronizowane z Salesforce, ponieważ połączony użytkownik nie ma dostępu do niezbędnego pola lub obiektu w Salesforce.

Jak rozwiązać te błędy

W większości przypadków błąd „Niewystarczający dostęp” lub „Brakujący rekord w Salesforce ” występuje, gdy integracja próbuje zaktualizować pole w Salesforce nieprawidłową wartością lub utworzyć nieprawidłowe powiązanie. 

Aby rozwiązać błąd uprawnień do pola w Salesforce , upewnij się , że użytkownik integracji z Salesforce ma uprawnienia do odczytu i edycji tego pola w Salesforce. 

Błąd „Niewystarczający dostęp do Salesforce ” pojawia się, gdy użytkownik integracji z Salesforce nie może wykonać danej czynności w Salesforce z powodu swoich uprawnień w tym systemie. Zaleca się sprawdzenie uprawnień użytkownika integracji z Salesforce w samym Salesforce.

Listy wyboru

Przykłady błędów związanych z listami wyboru

• Brak opcji na liście wyboru w Salesforce
• Niezgodna wartość stanu lub kraju
• Niezgodne opcje
• Nieaktywny właściciel w Salesforce
• Ograniczona wartość listy wyboru
• Nieaktywny etap szansy sprzedaży
• Właściciele w Salesforce nie są zsynchronizowani
• Przekroczono limit opcji
• Domyślny proces sprzedaży niedostępny
• Brakujący lub nieprawidłowy etap szansy sprzedaży

Co oznaczają te błędy

Rekordy nie są synchronizowane z powodu rozbieżności między wartościami pól list wyboru w HubSpot i Salesforce. Może się to zdarzyć, gdy wartość z listy wyboru w jednym systemie nie pasuje do żadnej z aktualnych wartości w drugim, jeśli lista wyboru osiągnęła limit wartości lub jeśli przekazana wartość jest nieprawidłowa.

Jak rozwiązać te błędy

Aby rozwiązać błąd„Niezgodna wartość stanu lub kraju ”, zaleca się sprawdzenie, czy spełnione są następujące wymagania:

• Wartość wewnętrzna opcji właściwości „Kraj ” w HubSpot musi odpowiadać istniejącej opcji „Kraj” w ustawieniach listy wyboru „Stan i kraj/terytorium ” w Salesforce. 
• Wartość „State” musi istnieć jako dostępna opcja „State/Province”dla wartości „Country” rekordu w Salesforce. Ponadto wewnętrzna wartość opcji właściwości „State” w HubSpot musi odpowiadać istniejącej opcji „State” w Salesforce. 

Aby rozwiązać błąd „Niezgodne opcje ”, zaleca się zaktualizowanie nazwy wewnętrznej/API opcji pola w Salesforce tak, aby odpowiadała wartości wewnętrznej opcji właściwości w HubSpot. 

Aby rozwiązać błąd „Nieaktywny właściciel w Salesforce ”, przypisz rekord HubSpot do użytkownika, który jest aktywnym użytkownikiem w Salesforce. 

Błąd „Ograniczona wartość listy wyboru” występuje, gdy dla pola w Salesforce włączone jest ustawienie „Ogranicz listę wyboru do wartości zdefiniowanych w zestawie wartości ”. Gdy opcja ta jest włączona w Salesforce, wartość, którą próbujesz zsynchronizować z HubSpot do Salesforce, musi istnieć jako opcja na liście wyboru w Salesforce. Zaleca się wyłączenie ustawienia „Ogranicz listę wyboru do wartości zdefiniowanych w zestawie wartości ” w Salesforce, aby umożliwić synchronizację dowolnych wartości z HubSpot do Salesforce. 

Błąd „Nieaktywny etap szansy sprzedaży ”występuje , gdy szansa sprzedaży w Salesforce o nieaktywnym etapie próbuje zsynchronizować się z HubSpot. Aby rozwiązać ten błąd, zmień etap szansy sprzedaży w Salesforce na aktywnylub przenieś szansę sprzedaży do aktywnego etapu. 

Aby rozwiązać błąd „Właściciele w Salesforce nie zostali zsynchronizowani ”, upewnij się, że użytkownicy w Salesforce mają typ użytkownika ustawiony na „Standardowy”, „Power Partner” lub „Gość ”. 

Aby rozwiązać błąd „Przekroczono limit opcji ”, zaleca się usunięcie zbędnych opcji właściwości w HubSpot i Salesforce, z których Twój zespół nie korzysta. Ponadto upewnij się, że wszystkie zmapowane właściwości mają odpowiadające im typy pól. 

W większości przypadków błąd „Domyślny proces sprzedaży niedostępny” występuje, gdy szanse sprzedaży w Salesforce próbują zsynchronizować się z HubSpot przy brakującym typie rekordu. Jeśli włączyłeś typy rekordów w Salesforce, ale ich nie używasz, lub masz szanse sprzedaży w Salesforce bez typu rekordu, zaleca się skontaktowanie się z zespołem Salesforce w celu dezaktywacji wszystkich typów rekordów lub utworzenia nowego typu rekordu. 

Aby rozwiązać błąd „Brakujący lub nieprawidłowy etap szansy sprzedaży ”, upewnij się, że wartość etapu szansy sprzedaży w Salesforce istnieje w potoku HubSpot.

W przypadku błędów dotyczących pól zadań w Salesforce porównaj wartości priorytetu, statusu lub typu zadania w Salesforce z odpowiadającymi im opcjami właściwości zadań w HubSpot. Priorytet zadania obsługuje wyłącznie wartości: Wysoki, Średni, Niski i Brak. W przypadku statusu i typu zaktualizuj wartości w Salesforce tak, aby dokładnie odpowiadały opcjom dostępnym w HubSpot, lub dodaj pasujące opcje w HubSpot.

Mapowanie właściwości

Przykłady błędów mapowania właściwości 

• Niezgodność typów
• Brak identyfikatora Salesforce
• Nieprawidłowy identyfikator Salesforce

Co oznaczają te błędy

Rekordy nie są synchronizowane z powodu rozbieżności w mapowaniu między właściwością HubSpot a polem Salesforce. Może to oznaczać, że typy właściwości i pól nie są kompatybilne, że właściwość lub pole już nie istnieje albo że należy utworzyć mapowanie pola referencyjnego w Salesforce.

Jak rozwiązać te błędy 

Aby rozwiązać błąd „Niezgodność typów”, upewnij się, że typ właściwości w HubSpot i typ pola w Salesforce są kompatybilne. Dowiedz się więcej o typach pól właściwości HubSpot, które można zsynchronizować z Salesforce. 

Błąd „Brakujący identyfikator Salesforce ” występuje, gdy HubSpot próbował zsynchronizować wartość inną niż istniejący identyfikator Salesforce z polem referencyjnym/wyszukiwawczym w Salesforce. 

Aby rozwiązać błąd „Nieprawidłowy identyfikator Salesforce ”, zaleca się sprawdzenie niestandardowej reguły walidacji skonfigurowanej w Salesforce. 

Wartości właściwości

Przykłady błędów związanych z wartościami właściwości

• Zbyt długi ciąg znaków
• Nieprawidłowy adres e-mail
• Brak wymaganego kraju
• Nieprawidłowa wartość
• Przypisanie właściciela
• Ograniczona unikalna wartość
• Brak wymaganej wartości

Co oznaczają te błędy

Rekordy nie są synchronizowane między HubSpot a Salesforce, ponieważ zawierają nieprawidłowe wartości właściwości. Błędy te zazwyczaj wymagają aktualizacji poszczególnych rekordów, których dotyczą, w celu ich skorygowania.

Jak rozwiązać te błędy

Aby rozwiązać błąd „Ciąg znaków jest zbyt długi ”, skróć wartość pola w Salesforce lub HubSpot albo zwiększ limit znaków dla tego pola w Salesforce. 

Aby rozwiązać błąd „Nieprawidłowy adres e-mail ”, zaktualizuj formatowanie adresu e-mail w rekordzie Salesforce, który próbuje zsynchronizować się z HubSpot.

Aby rozwiązać błąd „Brak wymaganego kraju ”, zaleca się sprawdzenie, czy spełnione są następujące wymagania:

• Wewnętrzna wartość opcji właściwości „Kraj ” w HubSpot musi odpowiadać istniejącej opcji „Kraj” w ustawieniach listy wyboru „Stan i kraj/terytorium ” w Salesforce. 
• Wartość „State” musi istnieć jako opcja „Available State/Province”dla wartości „Country” danego rekordu w Salesforce. Ponadto wewnętrzna wartość opcji właściwości „State” w HubSpot musi odpowiadać istniejącej opcji „State” w Salesforce. 

Aby rozwiązać błąd „Nieprawidłowa wartość ”, zaleca się zaktualizowanie wartości właściwości w rekordzie Salesforce tak, aby spełniała wymagania HubSpot dotyczące wartości właściwości. 

W większości przypadków błąd „Przypisanie właściciela ” występuje, gdy aktywność z HubSpot jest synchronizowana z Salesforce jako zadanie Salesforce, a HubSpot próbuje przypisać to zadanie właścicielowi kolejki w Salesforce.

Aby rozwiązać problem związany z błędem „Ograniczona unikalność wartości ”, zaleca się sprawdzenie reguł dopasowywania służących do deduplikacji, które skonfigurowano w Salesforce. 

Aby rozwiązać błąd „Brak wymaganej wartości”, należy dodać wartość do rekordu w Salesforce dla każdej właściwości oznaczonej jako wymagana w HubSpot. 

Inne / Nieznane

Przykład błędu „inne / nieznane”

• Wystąpił nieznany błąd duplikatu w Salesforce: Podano zduplikowany identyfikator.

Co oznacza ten błąd

Ten błąd może wystąpić, jeśli utworzysz mapowanie pól zawierające domyślne pole identyfikatora Salesforce, takie jak „Lead ID” lub „Contact ID”, i przypiszesz je do odpowiedniej właściwości „Salesforce Lead ID” lub „Salesforce Contact ID” w HubSpot.

Jak rozwiązać ten błąd

Wartości tych identyfikatorów są zarządzane automatycznie przez integrację i nie powinny być uwzględniane w niestandardowych mapowaniach pól. Utworzenie takich mapowań może spowodować nieoczekiwane zachowanie synchronizacji, szczególnie gdy reguła synchronizacji jest ustawiona na dwukierunkową.

W przypadku innych nieznanych błędów skontaktuj się z pomocą techniczną HubSpot w celu uzyskania dalszej pomocy.

Uwaga: możliwe jest zbiorcze ponowne zsynchronizowanie 100 błędów Salesforce naraz. Aby zsynchronizować więcej niż 100 błędów, zaimportuj rekordy z Salesforce lub zaktualizuj zmapowaną właściwość.

Skonfiguruj powiadomienia o błędach synchronizacji

1. Na koncie HubSpot kliknij ikonę ustawień w górnym pasku nawigacyjnym. W menu na lewym pasku bocznym przejdź do Integracje > Połączone aplikacje.
2. Na liście połączonych aplikacji kliknijSalesforce. 
3. Przejdź do karty Synchronizacja danych. 
4. Na karcie „Stan synchronizacji ”, w sekcji „Błędy synchronizacji ”, kliknij opcję„Zarządzaj powiadomieniami”. 
5. W oknie dialogowym włącz przełącznikWłącz powiadomienia. 
6. Zaznacz przycisk opcji obok opcjiNatychmiast,Codziennie lubCo tydzień, aby ustawić częstotliwość powiadomień. 
7. Kliknij„Zapisz”.