HubSpot Baza wiedzy

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

Autor: HubSpot Support | Oct 19, 2021 8:01:40 AM

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.

Dostosuj limit wywołań API

  • Na liście połączonych aplikacji kliknij Salesforce.
  • Na karcie Kondycja synchronizacji w sekcji Wykorzystanie wywołań API wyświetl liczbę wywołań API wykorzystanych w ciągu ostatnich 24 godzin. Liczba Limited by Salesforce to ilość wywołań API, które można wykonać w oparciu o ustawienia Salesforce. Aby dostosować liczbę połączeń, które można przypisać do HubSpot, edytuj pole Allocated to HubSpot.

Wyświetl błędy synchronizacji Salesforce

  • Aby wyświetlić więcej szczegółów dotyczących 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 usunięciu 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

Asocjacje

Przykłady błędów skojarzeń

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

Co oznaczają błędy

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

Jak rozwiązać błędy

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

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

Kod niestandardowy

Przykłady błędów kodu niestandardowego

  • 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 problemu spowodowanego przez automatyzację, przepływy lub reguły walidacji na koncie Salesforce.

Jak rozwiązać błędy

Ponieważ błędy te pochodzą z Salesforce, zaleca się współpracę z administratorem Salesforce w celu rozwiązania problemu w niestandardowym kodzie w Salesforce.

Duplikaty

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

  • Adres e-mail jest już używany
  • Zduplikowana reguła Salesforce

Co oznaczają błędy

Lead lub kontakt Salesforce nie może zostać zsynchronizowany z HubSpot, ponieważ adres 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 Email already in use, usuń adres 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 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ący dostęp lub brakujący rekord Salesforce występuje, 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ący dostęp 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 możliwości
  • Właściciele Salesforce nie są zsynchronizowani
  • Przekroczony limit opcji
  • Domyślny proces sprzedaży 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 listy wyboru w HubSpot i Salesforce. Może się to zdarzyć, gdy wartość listy wyboru w jednym systemie nie pasuje do żadnych bieżących 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 Mismatched state or country value, 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 Ograniczona wartość 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, należy zmienić 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ą ustawiony Typ użytkownika na Standardowy, Power Partner lub Gość 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 zmapowane 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, 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ącego lub nieprawidłowego etapu szansy, upewnij się, że wartość etapu szansy Salesforce istnieje w potoku HubSpot.

Mapowania właściwości

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

  • Niedopasowanie typu
  • Brakujący identyfikator Salesforce
  • Nieprawidłowy identyfikator Salesforce

Co oznaczają 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ć 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 występuje, gdy HubSpot próbował 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.

Wartości właściwości

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

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

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, należy skrócić wartość pola w Salesforce lub HubSpot lub zwiększyć limit znaków 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 braku wymaganego 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 Nieprawidłowa wartość, 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 występuje, gdy aktywność HubSpot synchronizuje się z Salesforce jako zadanie Salesforce, a HubSpot próbuje przypisać zadanie do właściciela kolejki Salesforce.

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

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

Inne

Rekordy nie są synchronizowane z powodu nieznanego błędu. Skontaktuj się z pomocą techniczną HubSpot, aby uzyskać dalszą pomoc dotyczącą 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, zaimportuj rekordy z Salesforce lub zaktualizuj zmapowaną właściwość.

Konfigurowanie powiadomień o błędach synchronizacji

  • 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 opcji obok opcji Natychmiast, Codziennie lub Co tydzień, aby ustawić częstotliwość powiadomień.
  • Kliknij przycisk Zapisz.