Przejdź do głównej zawartości

AI Voice Agent→ HubSpot: instrukcja mapowania właściwości kontaktu

Ten artykuł wyjaśnia, jak zmapować odpowiedzi zbierane przez AI Voice Agent do właściwości kontaktu w HubSpot, tak aby każda odpowiedź udzielona podczas rozmowy trafiała bezpośrednio do właściwego pola w Twoim CRM-ie.

Napisane przez Adriana Świerczek

Uwaga: Ta funkcja wymaga aktywnej i poprawnie skonfigurowanej integracji z HubSpotem.

Jak to działa?

Dla każdego pytania skonfigurowanego w AI Voice możesz wskazać, do którego pola kontaktu w HubSpot ma zostać zapisana odpowiedź rozmówcy.

W AI Voice uzupełniasz pole:

HubSpot property (internal name)

Po jego uzupełnieniu każda odpowiedź zebrana podczas rozmowy jest automatycznie synchronizowana z tą właściwością na odpowiadającym jej kontakcie w HubSpot.

Zanim zaczniesz: property musi już istnieć w HubSpot

CallPage nie tworzy automatycznie właściwości po stronie HubSpot. Zanim zmapujesz pytanie, Ty (lub administrator HubSpota) musisz utworzyć property ręcznie w ustawieniach HubSpot jako contact property.

Wskazówka: Najpierw skonfiguruj w HubSpot wszystkie właściwości, których planujesz użyć, a dopiero potem wróć do mapowania w AI Voice - dzięki temu unikniesz sytuacji, w której property okaże się brakujące dopiero w trakcie konfiguracji.


Najważniejsze zasady:

  1. Property musi wcześniej istnieć w HubSpot. Nasz system nie tworzy automatycznie właściwości po stronie HubSpot. Klient musi utworzyć ją ręcznie w ustawieniach HubSpot jako contact property.


  2. Należy wpisać internal name, nie display label. HubSpot może pokazywać użytkownikowi czytelną nazwę pola, np. What doing, ale API oczekuje internal name, np. what_doing. W AI Voice zawsze używaj internal name.

  3. Nazwa musi zgadzać się 1:1. Wartość wpisana w AI Voice musi być dokładnie taka sama jak internal name w HubSpot.

    ✅ Przykład poprawny:

    • HubSpot internal name: what_doing

    • AI Voice field: what_doing

    ❌ Przykład niepoprawny:

    • HubSpot internal name: what_doing

    • AI Voice field: What doing

  4. Zalecana konwencja nazw:

    • małe litery

    • bez polskich znaków

    • bez spacji

    • bez znaków specjalnych

    • najlepiej snake_case

    Przykłady: tool_interested, customer_need, what_doing

  5. Błędna nazwa property może zatrzymać synchronizację. Jeśli wpisana nazwa property nie istnieje w HubSpot albo nie zgadza się 1:1 z internal name, odpowiedź nie zostanie zapisana w HubSpot. W części przypadków HubSpot może odrzucić cały update kontaktu, przez co inne dane z tego synca również nie zostaną wysłane.

Przykład konfiguracji:

Pytanie w AI Voice:

  • Label: What u doing

  • HubSpot property (internal name): what_doing

Właściwość kontaktu w HubSpot:

  • Internal name: what_doing

Efekt: Odpowiedź użytkownika na pytanie "What u doing" zostanie wysłana do HubSpot pod property what_doing.


Dobre praktyki

  • Najpierw utwórz property w HubSpot, a dopiero potem mapuj je w AI Voice - nigdy odwrotnie.

  • Kopiuj internal name bezpośrednio z HubSpot, zamiast przepisywać je ręcznie, aby uniknąć literówek.

  • Trzymaj się konwencji snake_case dla nowotworzonych właściwości, żeby zachować spójność nazewnictwa i uniknąć niezgodności.

  • Sprawdzaj mapowanie po edycji pytań - zmiana etykiety pytania nie zmienia mapowania property, ale to dobry moment, żeby upewnić się, że wszystko nadal się zgadza.

Czy to odpowiedziało na twoje pytanie?