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. Błędy synchronizacji można zidentyfikować i rozwiązać w ustawieniach integracji Salesforce.

Dostosuj limit wywołań API

1. Na koncie HubSpot kliknij settings 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 kliknij Salesforce.
3. Przejdź do karty Sync Health (Stan synchronizacji).
4. W sekcji Wykorzystanie wywołań API sprawdź, ile wywołań API wykorzystałeś w ciągu ostatnich 24 godzin. Liczba ograniczona przez Salesforce to liczba wywołań API, które możesz wykonać w oparciu o ustawienia Salesforce. Aby dostosować liczbę wywołań, które mogą być przypisane do HubSpot, edytuj pole Przypisane do HubSpot.

Wyświetl błędy synchronizacji Salesforce

1. Na koncie HubSpot kliknij settings 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 kliknij Salesforce.
3. Przejdź do zakładki Sync Health (Stan synchronizacji).
4. W sekcji Sync errors(Błędy synchronizacji) wyświetl karty dla każdego typu błędu wraz z liczbą bieżących błędów i rekordów, na które mają one wpływ. 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 zalecanych rozwiązaniach.

5. Aby wyświetlić więcej szczegółów dotyczących błędu, kliknij ikonę informacji „ info ” w kolumnie „Error Type” (Typ błędu).
6. Aby podjąć działania dotyczące poszczególnych rekordów, kliknij [#] rekordów w kolumnie „Affected Records” ( Rekordy, na które ma to wpływ), a następnie kliknij „Actions” (Działania) > „Create a temporary view of HubSpot records” (Utwórz tymczasowy widok rekordów HubSpot) , aby utworzyć filtrowany widok rekordów, na które ma to wpływ.
7. Po usunięciu błędów wróć do listy błędów. Zaznacz pole wyboru po lewej stronie każdego usuniętego błędu i kliknij opcję Resync(Ponowna synchronizacja).
8. Aby wyeksportować błędy, kliknij op cję 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

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 HubSpot.

Jak rozwiązać te błędy

Aby rozwiązać problem błędu „Osiągnięto limit powiązań” , możesz usunąć niektóre powiązane rekordy 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
• Brakujący identyfikator kontaktu
• Reguła walidacji niestandardowego pola Salesforce
• Przepływ 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ć błędy

Duplikaty

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

• Adres e-mail już używany
• Reguła duplikowania Salesforce

Co oznaczają te błędy

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

Jak rozwiązać problemy

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

Aby rozwiązać błąd dotyczący reguły duplikatów w Salesforce , zaleca się sprawdzenie reguł dopasowywania dla deduplikacji skonfigurowanych w Salesforce.

Uprawnienia

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

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

Co oznaczają te błędy

Zmiany wprowadzone w HubSpot nie mogą zostać zsynchronizowane z Salesforce, ponieważ podłą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 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 do Salesforce ” występuje, gdy użytkownik integracji Salesforce nie może wykonać działania 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

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

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ść listy wyboru w jednym systemie nie pasuje do żadnej aktualnej wartości w drugim systemie, 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ć problem niezgodnoś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 być zgodna z istniejącą opcją 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 być zgodna z istniejącą opcją „State” w Salesforce.

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

Aby rozwiązać błąd „Nieaktywny właściciel 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łączona jest opcja „Ogranicz listę wyboru do wartości zdefiniowanych w zestawie wartości” dla danego pola. 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 Salesforce. Zaleca się wyłączenie opcji „Ogranicz listę wyboru do wartości zdefiniowanych w zestawie wartości ” w Salesforce, aby umożliwić synchronizację wszystkich wartości z HubSpot do Salesforce.

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

Aby rozwiązać błąd „Właściciele Salesforce nie są zsynchronizowani”, upewnij się, że użytkownicy Salesforce mają typ użytkownika ustawiony 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 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 możliwości 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 możliwości 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ć problem z błędem „Brakujący lub nieprawidłowy etap możliwości”, upewnij się, że wartość etapu możliwości Salesforce istnieje w potoku HubSpot.

Mapowanie właściwości

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

• Niezgodność typów
• Brakujący identyfikator 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ć 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 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/wyszukiwania 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 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ść
• Brakuje 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, aby je skorygować.

Jak rozwiązać błędy

Aby rozwiązać błąd „Zbyt długi ciąg znaków ”, skróć wartość pola w Salesforce lub HubSpot lub zwiększ limit znaków w polu 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 „Brakuje wymaganego kraju”, zaleca się sprawdzenie, czy spełnione są następujące wymagania:

• Wartość wewnętrzna opcji właściwości Kraj w HubSpot musi być zgodna z istniejącą opcją 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 być zgodna z istniejącą opcją „State” w Salesforce.

Aby rozwiązać błąd „Nieprawidłowa wartość”, zaleca się aktualizację wartości właściwości w rekordzie Salesforce, aby spełniała ona 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 synchronizuje się z Salesforce jako zadanie Salesforce, a HubSpot próbuje przypisać zadanie do właściciela kolejki Salesforce.

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

Aby rozwiązać błąd „Brakująca wymagana wartość”, 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. Aby uzyskać dalszą pomoc w związku z tymi błędami, skontaktuj się z pomocą techniczną HubSpot.

Uwaga: możliwe jest zbiorcze ponowne zsynchronizowanie 100 błędów Salesforce jednocześnie. 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 settings 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 kliknij Salesforce.
3. Przejdź do karty Sync Health (Stan synchronizacji).
4. W sekcji Błędy synchronizacji kliknij opcję Zarządzaj powiadomieniami.
5. W oknie dialogowym włącz przełącznik Włącz powiadomienia.
6. Wybierz przycisk opcji obok opcji Natychmiast, Codziennie lub Co tydzień, aby ustawić częstotliwość powiadomień.
7. Kliknij przycis k Zapisz.