> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt.

# 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:

1. ElevenLabs weryfikuje podpis webhooka na podstawie client secret aplikacji.
2. Pobiera pełną rozmowę z Intercom i mapuje historię wiadomości na skonfigurowanego agenta.
3. 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](https://developers.intercom.com/intercom-api-reference/reference/listadmins).

#### 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:

1. W Intercom utwórz **Team** dla agenta (**Settings → Teammates & Teams → Teams**), np. „AI Agent”.
2. 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.
3. Pobierz numeryczne ID zespołu przez API Intercom [List all teams](https://developers.intercom.com/intercom-api-reference/reference/listteams) 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.

> **Note**
>
> 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.

### CLI

> **Note**
>
> Dokumentacja CLI dla tej integracji będzie wkrótce dostępna.

### SDK

> **Note**
>
> Dokumentacja SDK dla tej integracji będzie wkrótce dostępna.

## Przydatne linki

* [Dokumentacja REST API Intercom](https://developers.intercom.com/docs/references/rest-api/api.intercom.io)
* [Omówienie webhooków Intercom](https://developers.intercom.com/docs/webhooks)
* [Tematy webhooków Intercom](https://developers.intercom.com/docs/references/webhooks/webhook-models)
* [Intercom Developer Hub](https://app.intercom.com/a/apps/_/developer-hub)