Intercom

Omówienie

Połącz agentów AI ElevenLabs z Intercom, aby zarządzać kontaktami, rozmowami, zgłoszeniami i notatkami. Integracja obsługuje dwa przepływy:

Narzędzia: pozwalają agentowi wyszukiwać i aktualizować kontakty, wyszukiwać rozmowy i na nie odpowiadać, zarządzać cyklem rozmowy (zamykanie, ponowne otwieranie, przypisywanie), tagować rozmowy, tworzyć zgłoszenia i na nie odpowiadać oraz dodawać notatki wewnętrzne — wszystko w trakcie rozmowy ElevenLabs.
Wyzwalacze: pozwalają agentowi automatycznie odpowiadać na nowe rozmowy Intercom i odpowiedzi kontaktów, publikując odpowiedzi jako administrator Intercom.

Możliwości

Funkcja	Obsługa
Tryb zerowego przechowywania (ZRM)	Nieobsługiwany
Załączniki w wyzwalaczach	Nieobsługiwane — załączniki i obrazy z przychodzących rozmów nie są przekazywane agentowi
Załączniki w narzędziach	Nieobsługiwane — narzędzia działają tylko na tekście

Jak działa wyzwalacz

Gdy włączysz wyzwalacz Intercom Conversation, ElevenLabs subskrybuje dwa tematy webhooków Intercom — jeden dla nowych rozmów utworzonych przez kontakt, a drugi dla kolejnych odpowiedzi kontaktu. Za każdym razem, gdy Intercom dostarcza powiadomienie:

ElevenLabs weryfikuje podpis webhooka na podstawie client secret aplikacji.
Pobiera pełną rozmowę z Intercom i mapuje historię wiadomości na skonfigurowanego agenta.
Agent generuje odpowiedź, którą ElevenLabs publikuje w rozmowie jako skonfigurowany administrator.

Ponieważ Intercom wysyła powiadomienia tylko o aktywności użytkowników końcowych (a nie odpowiedziach administratorów), agent nigdy nie odpowiada na własne wiadomości.

Konfiguracja

Utwórz aplikację Intercom i token dostępu

W Intercom otwórz Settings → Integrations → Developer Hub i utwórz nową aplikację dla ElevenLabs (lub otwórz istniejącą).

W sekcji Authentication skopiuj Access token — to token oznaczony jako dostęp do danych własnego workspace. Potrzebny będzie też Client secret ze strony Basic information; ElevenLabs używa go do weryfikacji autentyczności każdego dostarczonego webhooka.

Znajdź ID administratora Intercom

Agent publikuje odpowiedzi jako administrator Intercom (zwykle na dedykowanym miejscu dla członka zespołu). W Intercom otwórz Settings → Teammates i wybierz członka zespołu, jako którego ma publikować agent. ID administratora to wartość liczbowa (np. 1234567) — możesz je też pobrać programowo przez API Intercom List all admins.

Połącz w ElevenLabs

Na stronie integracji Intercom w ElevenLabs kliknij Connect i wklej Access token z Developer Hub.

Włącz wyzwalacz Intercom Conversation

Otwórz kartę Triggers integracji Intercom i włącz Intercom Conversation. Uzupełnij:

Agent — agent ElevenLabs, który ma obsługiwać przychodzące rozmowy Intercom.
Client secret — wartość z Developer Hub → Basic information. Służy do weryfikacji podpisów webhooków.
Admin ID — numeryczne ID administratora, jako którego agent ma publikować odpowiedzi.
Team inbox ID (opcjonalnie) — ogranicza agenta do jednej skrzynki zespołu Intercom. Po ustawieniu agent odpowiada tylko na rozmowy przypisane obecnie do tego zespołu; pozostaw puste, aby odpowiadać na wszystkie rozmowy. W następnym kroku dowiesz się, jak ograniczyć agenta do dedykowanej skrzynki.

(Opcjonalnie) Ogranicz agenta do dedykowanej skrzynki zespołu

Jeśli agent ma obsługiwać tylko konkretny podzbiór rozmów, kieruj je do dedykowanej skrzynki zespołu i wskaż ją w wyzwalaczu:

W Intercom utwórz Team dla agenta (Settings → Teammates & Teams → Teams), np. „AI Agent”.
Utwórz Workflow (Fin AI Agent → Workflows), który przypisuje rozmowy do tego zespołu za pomocą działania Assign → Team (Workflows wymagają planu Advanced/Expert). Aby eskalować sprawę, przenieś rozmowę z tego zespołu do zespołu ludzi.
Pobierz numeryczne ID zespołu przez API Intercom List all teams i wklej je w pole Team inbox ID wyzwalacza.

Gdy skrzynka zespołu jest skonfigurowana, agent ignoruje każdą rozmowę, która nie jest przypisana do tego zespołu.

Intercom przypisuje zespół przez Workflow na początku rozmowy. Jeśli webhook conversation.user.created zostanie dostarczony przed przypisaniem, pierwsza wiadomość może zostać pominięta; agent podejmie rozmowę przy następnej odpowiedzi kontaktu. Uwzględnij to podczas testów.

Subskrybuj tematy webhooków w Intercom

W Intercom Developer Hub otwórz sekcję Webhooks aplikacji i dodaj nową subskrypcję wskazującą ten URL:

https://api.elevenlabs.io/v1/convai/api-integrations/intercom/triggers/conversation

Subskrybuj oba poniższe tematy:

conversation.user.created — uruchamia się, gdy użytkownik końcowy rozpoczyna nową rozmowę.
conversation.user.replied — uruchamia się, gdy użytkownik końcowy odpowiada w istniejącej rozmowie.

Intercom podpisuje każdy webhook przy użyciu client secret; ElevenLabs weryfikuje nagłówek X-Hub-Signature przy każdym dostarczeniu. Dostarczenia z nieprawidłowym lub brakującym podpisem są po cichu odrzucane.

Sprawdź konfigurację

Otwórz Intercom Messenger jako kontakt testowy (lub użyj podglądu Intercom), wyślij wiadomość do workspace i potwierdź, że skonfigurowany agent odpowiada jako wybrany administrator. Powstały transkrypt rozmowy możesz sprawdzić w widoku Conversations ElevenLabs.

Jeśli odpowiedź nie przyjdzie, ponownie sprawdź URL webhooka i subskrypcję tematów w Developer Hub oraz upewnij się, że Access token i Client secret dotyczą tej samej aplikacji Intercom.