Что это
Intercom API нужен, чтобы связать поддержку с отчетами или собственной автоматизацией. Через разрешенные методы программа может читать диалоги, работать с контактами и передавать проверенные изменения в Intercom.
Это не подписка на Fin и не готовый анализатор переписки. Если поверх API работает модель, правила доступа, проверка вывода и разрешение на отправку сообщения остаются отдельными шагами.
Ключевые параметры
- Категория: Инструменты разработчика
- Сложность: Для разработчика
- Запуск: Около 30 минут
- Open-source: Нет
- Данные: Не известно
- Чувствительные данные: Только с настройками
Сильные стороны
- Позволяет интегрировать поддержку без копирования из интерфейса.
- Есть чтение отдельных диалогов и данные для связи с контактами.
- Webhooks помогают реагировать на события вместо постоянного опроса.
Ограничения
- Доступ определяется разрешениями приложения и возможностями плана.
- Выдача одного диалога ограничена: длинная история может быть неполной.
- Нужно учитывать версию API, лимиты запросов и регион размещения аккаунта.
Как использовать
1. Подготовка. Создайте короткий учебный диалог без личных данных и запишите его ID. Уточните API-регион рабочего пространства.
2. Настройка. Для своего workspace создайте private app с минимальными правами чтения и Access Token; для подключения чужих организаций нужен OAuth. Храните секрет на сервере и зафиксируйте поддерживаемый Intercom-Version.
3. Первый результат. Выполните GET /conversations/{conversation_id} на API-хосте своего региона с Authorization: Bearer TOKEN. Получите ID, состояние и части учебного диалога.
4. Проверка. Сверьте данные с Inbox. Учтите лимит 500 последних частей и не называйте такую выгрузку полной, если история длиннее. Проверьте 401/403 и обработку 429; права записи и отправку ответа включайте только после отдельного теста.
Доступ и оплата
- Модель оплаты: Не уточнено
- Работа в РФ: Нужно проверять
- VPN: Не известно
- Русский интерфейс: Не известно
- Русский язык: Не известно
Для отдельных методов план может быть ограничением даже при действующем токене. API-доступ не включает автоматически AI-агента; его доступность проверяется отдельно.
Когда не подходит
- Автоматически рассылать непроверенные ответы
- Считать токен универсальным доступом ко всем методам
- Выдавать урезанную историю за полный разговор
Альтернативы
Zendesk API и HubSpot CRM API работают с данными своих платформ. Для разовой проверки достаточно интерфейса Intercom; смена API не переносит автоматически историю клиента.
