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

Integracja HubSpot-Salesforce może napotkać błędy synchronizacji, które uniemożliwiają synchronizację danych. Możesz zidentyfikować i rozwiązać te błędy synchronizacji w ustawieniach integracji Salesforce.

Dostosowanie limitu wywołań API

• Na koncie HubSpot kliknij settings ikonę ustawień w górnym pasku nawigacyjnym. W menu na lewym pasku bocznym przejdź do Integracje > Połączone aplikacje.
• Na liście połączonych aplikacji kliknij Salesforce.
• Na karcie Kondycja synchronizacji w sekcji Wykorzystanie wywołań API wyświetl liczbę połączeń API wykorzystanych w ciągu ostatnich 24 godzin. Liczba Limited by Salesforce to kwota wywołań API, które można wykonać na podstawie ustawień Salesforce. Aby dostosować liczbę połączeń, które można przypisać do HubSpot, edytuj pole Allocated to HubSpot.

Wyświetlanie błędów synchronizacji Salesforce

• Na koncie HubSpot kliknij settings ikonę ustawień w górnym pasku nawigacyjnym. W menu na lewym pasku bocznym przejdź do Integracje > Połączone aplikacje.
• Na liście połączonych aplikacji kliknij Salesforce.
• Na karcie Kondycja synchronizacji, w sekcji Błędy synchronizacji, wyświetl karty dla każdego typu błędu, z liczbą bieżących błędów i rekordów, których one 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ązania.

• Aby wyświetlić więcej szczegółów błędu, kliknij ikonę informacji info w kolumnie Typ błędu .
• Aby podjąć działania dotyczące poszczególnych rekordów, kliknij [#] rekordów w kolumnie Dotknięte rekordy, a następnie kliknij Akcje > Utwórz tymczasowy widok rekordów HubSpot , aby utworzyć filtrowany widok dotkniętych rekordów.
• Po rozwiązaniu błędów wróć do listy błędów. Zaznacz pole wyboru po lewej stronie wszystkich rozwiązanych błędów i kliknij przycisk Resynchronizuj.
• 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ą błędy

Rekordy nie synchronizują się, 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ązania rekordu HubSpot.

Jak rozwiązać błędy

Aby rozwiązać błąd osiągnięcia limitu powiązań , można usunąć niektóre powiązane rekordy lub powiązać je z innym rekordem Salesforce, a następnie kontynuować synchronizację.

Aby rozwiązać błąd oczekiwania na synchronizację konta , zaleca się wykonanie importu kont Salesforce.

Kod klienta

Przykłady błędów w kodzie niestandardowym

• Automatyzacja Salesforce
• Brakujący identyfikator kontaktu
• Reguła walidacji pola niestandardowego Salesforce
• Przepływ Salesforce

Co oznaczają błędy

Rekordy nie są synchronizowane z powodu automatyzacji, przepływów lub reguł walidacji na koncie Salesforce.

Jak rozwiązać błędy

Duplikaty

Przykłady błędów duplikatów

• Wiadomość e-mail jest już używana
• Reguła duplikatów Salesforce

Co oznaczają błędy

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

Jak rozwiązać błędy

Aby rozwiązać błąd Wiadomość e-mail already in use, usuń wiadomość e-mail z istniejącego kontaktu HubSpot.

Aby rozwiązać błąd zduplikowanej reguły Salesforce , zaleca się sprawdzenie pasujących reguł deduplikacji skonfigurowanych w Salesforce.

Uprawnienia

Przykłady błędów uprawnień

• Niewystarczający dostęp lub brakujący rekord Salesforce
• Uprawnienie do pola Salesforce
• Niewystarczający dostęp do Salesforce

Co oznaczają 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ć błędy

W większości przypadków błąd niewystarczającego dostępu lub braku rekordu Salesforce pojawia się, gdy integracja próbuje zaktualizować pole Salesforce z nieprawidłową wartością lub utworzyć nieprawidłowe powiązanie.

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

Błąd niewystarczającego dostępu Salesforce występuje, gdy użytkownik integracji Salesforce nie może wykonać akcji w Salesforce z powodu swoich uprawnień użytkownika w Salesforce. Zaleca się sprawdzenie uprawnień użytkownika integracji Salesforce w Salesforce.

Listy wyboru

Przykłady błędów listy wyboru

• Brakująca opcja listy wyboru Salesforce
• Niedopasowana wartość stanu lub kraju
• Niedopasowane opcje
• Nieaktywny właściciel Salesforce
• Ograniczona wartość listy wyboru
• Nieaktywny etap Szansy
• Właściciele Salesforce nie są zsynchronizowani
• Przekroczono limit opcji
• Domyślny proces Sales niedostępny
• Brakujący lub nieprawidłowy etap szansy

Co oznaczają błędy

Rekordy nie są synchronizowane z powodu rozbieżności między wartościami pól picklist w HubSpot i Salesforce. Może się to zdarzyć, gdy wartość listy wyboru w jednym systemie nie pasuje do żadnych 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ć błędy

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

• Wewnętrzna wartość opcji właściwości Country w HubSpot musi być zgodna z istniejącą opcją Country w ustawieniach listy wyboru State i Country/Territory 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 być zgodna z istniejącą opcją State w Salesforce.

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

Aby rozwiązać błąd nieaktywnego właściciela Salesforce, należy ponownie przypisać rekord HubSpot do użytkownika, który jest aktywnym użytkownikiem w Salesforce.

Błąd ograniczonej wartości listy wyboru występuje, gdy dla pola w Salesforce włączona jest opcja Ogranicz listę wyboru do wartości zdefiniowanych w ustawieniu zestawu wartości. 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 Salesforce. Zaleca się wyłączenie opcji Ogranicz listę wyboru do wartości zdefiniowanych w ustawieniu zestawu wartości w Salesforce, aby wszystkie wartości mogły być synchronizowane z HubSpot do Salesforce.

Błąd nieaktywnego etapu szansy pojawia się, gdy szansa Salesforce z nieaktywnym etapem szansy próbuje zsynchronizować się z HubSpot. Aby rozwiązać ten błąd, zmień etap szansy w Salesforce na aktywny lub przenieś szansę do aktywnego etapu.

Aby rozwiązać błąd niezsynchronizowanych właścicieli Salesforce, upewnij się, że użytkownicy Salesforce mają typ użytkownika ustawiony na Standard, Power Partner lub Guest w Salesforce.

Aby rozwiązać błąd przekroczenia limitu opcji, zaleca się usunięcie dodatkowych opcji właściwości w HubSpot i Salesforce, których zespół nie używa. Ponadto należy upewnić się, że wszystkie mapowane właściwości mają odpowiednie typy pól.

W większości przypadków błąd Default sales process unavailable pojawia się, gdy szanse Salesforce próbują zsynchronizować się z HubSpot z brakującym typem rekordu. Jeśli włączyłeś typy rekordów w Salesforce, ale ich nie używasz lub masz szanse Salesforce bez typu rekordu, zalecamy współpracę z Salesforce w celu dezaktywacji wszystkich typów rekordów lub utworzenia nowego typu rekordu.

Aby rozwiązać błąd brakującego lub nieprawidłowego etapu szans y, upewnij się, że wartość etapu szansy Salesforce istnieje w procesie HubSpot.

Mapowanie właściwości

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

• Niezgodność typu
• Brakujący identyfikator Salesforce
• Nieprawidłowy identyfikator Salesforce

Co oznaczają błędy

Rekordy nie synchronizują się z powodu rozbieżności w mapowaniu właściwości HubSpot i pola 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ć błędy

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

Błąd Missing Salesforce ID pojawia się, gdy HubSpot próbuje zsynchronizować wartość inną niż istniejący identyfikator Salesforce z polem referencyjnym/wyszukiwania w Salesforce.

Aby rozwiązać błąd Invalid Salesforce ID, zaleca się sprawdzenie niestandardowej reguły walidacji skonfigurowanej w Salesforce.

Właściwość wartości

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

• Zbyt długi ciąg znaków
• Nieprawidłowa wiadomość e-mail
• Brakujący wymagany kraj
• Nieprawidłowa wartość
• Przypisanie właściciela
• Ograniczona unikalna wartość
• Brak wymaganej wartości

Co oznaczają błędy

Rekordy nie są synchronizowane między HubSpot i 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 skorygowania błędu.

Jak rozwiązać błędy

Aby rozwiązać błąd zbyt długiego ciągu znaków, skróć wartość pola w Salesforce lub HubSpot lub zwiększ limit znaków pola w Salesforce.

Aby rozwiązać błąd Nieprawidłowa wiadomość e-mail , zaktualizuj formatowanie wiadomości e-mail w rekordzie Salesforce, który próbuje zsynchronizować się z HubSpot.

Aby rozwiązać błąd Missing required country, zaleca się sprawdzenie, czy spełnione są następujące wymagania:

• Wewnętrzna wartość opcji właściwości Country w HubSpot musi być zgodna z istniejącą opcją Country w ustawieniach listy wyboru State i Country/Territory 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 być zgodna z istniejącą opcją State w Salesforce.

Aby rozwiązać błąd Invalid value, zaleca się zaktualizowanie wartości właściwości w rekordzie Salesforce, aby spełnić wymagania HubSpot dotyczące wartości właściwości.

W większości przypadków błąd przypisania właściciela pojawia się, gdy aktywność HubSpot synchronizuje się z Salesforce jako zadanie Salesforce, a HubSpot próbuje przypisać zadanie do właściciela kolejki zadań Salesforce.

Aby rozwiązać błąd Restricted unique value, zaleca się sprawdzenie reguł dopasowania dla deduplikacji skonfigurowanych w Salesforce.

Aby rozwiązać błąd braku wymaganej wartości, dodaj wartość do rekordu Salesforce dla każdej właściwości, która jest oznaczona jako wymagana w HubSpot.

Inne

Rekordy nie są synchronizowane z powodu nieznanego błędu. Prosimy o kontakt z asystentem HubSpot w celu uzyskania dalszej pomocy dotyczącej tych błędów.

Uwaga: możliwe jest zbiorcze zsynchronizowanie 100 błędów Salesforce naraz. Aby zsynchronizować więcej niż 100 błędów, należy zaimportować rekordy z Salesforce lub zaktualizować mapowanie właściwości.

Konfigurowanie powiadomień o błędach synchronizacji

• Na koncie HubSpot kliknij settings ikonę ustawień w górnym pasku nawigacyjnym. W menu na lewym pasku bocznym przejdź do Integracje > Połączone aplikacje.
• Na liście połączonych aplikacji kliknij Salesforce.
• Kliknij kartę Kondycja synchronizacji.
• W obszarze Błędy synchronizacji kliknij opcję Zarządzaj powiadomieniami.
• W oknie dialogowym włącz przełącznik Włącz powiadomienia.
• Wybierz przycisk radiowy obok opcji Natychmiast, Codziennie lub Co tydzień, aby ustawić częstotliwość powiadomień.
• Kliknij przycisk Zapisz.