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

W integracji HubSpot-Salesforce mogą wystąpić błędy synchronizacji, które uniemożliwiają synchronizację danych. Błędy te można zidentyfikować i usunąć w ustawieniach integracji 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 karty 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. LiczbaOgraniczona przez Salesforce to liczba wywołań API, które możesz wykonać na podstawie ustawień Salesforce. Aby dostosować liczbę wywołań, które mogą być przydzielone 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 karty Synchronizacja danych. 
4. W zakładce Stan synchronizacji, wsekcjiBłę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 rozwiązań. 

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ć filtrowany 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 Eksportuj błędy (CSV) w lewym górnym rogu listy błędów.

Typy błędów synchronizacji Salesforce

Powiązania

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

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

Co oznaczają te błędy

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

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 Salesforce, a następnie kontynuować synchronizację.

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

Kod niestandardowy

Przykłady błędów kodu niestandardowego 

• Automatyzacja Salesforce
• Brak identyfikatora kontaktu
• Reguła walidacji pola niestandardowego 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 dotyczących duplikatów

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

Co oznaczają te błędy

Potencjalny klient lub kontakt w Salesforce nie może zsynchronizować się z HubSpot, ponieważ adres e-mail już istnieje w rekordzie kontaktu 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ń adres e-mail z istniejącego kontaktu w HubSpot.

Aby rozwiązać błąd reguły duplikatów w Salesforce , zaleca się , aby administrator Salesforce sprawdził reguły dopasowywania do deduplikacji skonfigurowane w Salesforce. 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ący dostęp 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 Salesforce ma uprawnienia do odczytu i edycji tego pola w Salesforce. 

Błąd „Niewystarczający dostęp do Salesforce ” występuje, gdy użytkownik integracji Salesforce nie może wykonać czynności w Salesforce ze względu na swoje uprawnienia użytkownika w Salesforce. Zaleca się sprawdzenie uprawnień użytkownika integracji Salesforce w Salesforce.

Listy wyboru

Przykłady błędów list wyboru

• Brak opcji listy 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 listy wyboru w HubSpot i Salesforce. Może się to zdarzyć, gdy wartość z listy wyboru w jednym systemie nie pasuje do żadnej aktualnej 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łądniezgodności wartości 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 opcja „Available 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ę aktualizację nazwy wewnętrznej/API opcji pola Salesforce, tak aby odpowiadała ona 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 w Salesforce włączono ustawienie „Ogranicz listę wyboru do wartości zdefiniowanych w zestawie wartości ” dla danego pola. Gdy ta opcja 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 opcji „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 ”pojawia się , gdy szansa sprzedaży w Salesforce z nieaktywnym etapem próbuje zsynchronizować się z HubSpot. Żeby rozwiązać ten błąd, zmień etap szansy sprzedaży w Salesforce na aktywnyalbo przenieś szansę do aktywnego etapu. 

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

Aby rozwiązać błąd „Przekroczono limit opcji ”, zaleca się usunięcie dodatkowych opcji właściwości w HubSpot i Salesforce, których Twój zespół nie używa. Ponadto upewnij się, że wszystkie zmapowane właściwości mają odpowiednie 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ę współpracę z 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 lejku HubSpot.

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

Mapowania 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 lub że należy utworzyć mapowanie pola referencyjnego Salesforce.

Jak rozwiązać te błędy 

Aby rozwiązać błąd niezgodności 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 mogą być synchronizowane z Salesforce. 

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

Aby rozwiązać błąd „Nieprawidłowy identyfikator Salesforce ”, zaleca się sprawdzenie niestandardowej reguły walidacji, którą skonfigurowałeś w Salesforce. 

Wartości właściwości

Przykłady błędów dotyczących wartości 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” 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, 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ść HubSpot jest synchronizowana z Salesforce jako zadanie Salesforce, a HubSpot próbuje przypisać to zadanie właścicielowi kolejki Salesforce.

Aby rozwiązać błąd „Ograniczona unikalna wartość ”, zaleca się sprawdzenie reguł dopasowywania dla deduplikacji, które skonfigurowałeś w Salesforce. 

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

Inne

Rekordy nie są synchronizowane z powodu nieznanego błędu. Skontaktuj się z pomocą techniczną HubSpot, aby uzyskać dalszą pomoc w związku z tymi błędami.

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 , kliknijZarzą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. KliknijZapisz.