Перейти к содержимому
Каналы и интеграции

Канал API

Подключите Entagl к своему приложению или к Make: отправляйте сообщения, получайте ответы и управляйте своим workspace.

1 Включите ответы ИИ для API канала. Скриншот сделан 10 ноября 2026 года.

Обзор

Канал API позволяет использовать того же AI agent, который отвечает в ваших DM, на сайте, в мобильном приложении или на backend. Вы отправляете сообщение, agent обрабатывает его (с той же буферизацией и многосообщными ответами в человеческом стиле, как в реальных DM), а ответ приходит чуть позже — через webhook callback или polling. Настройте это в Каналы → API: сгенерируйте API key, включите канал, затем выберите callback или polling. Этот же API позволяет вашему разработчику или Make работать с contacts, conversations, bookings, orders и многим другим. Смотрите вкладку Workspace API.

Для разработчиков: справочник API
Каждый endpoint, поле и событие webhook, с примерами кода.

Вкладки на этой странице

API нужен не только для чата. Ваш разработчик или инструмент вроде Make может использовать его, чтобы читать и обновлять большую часть вашего workspace.

Что с ним можно делать

Помимо отправки сообщений, API поддерживает:

  • Contacts: создавать, обновлять, искать, объединять, добавлять заметки, помечать как do-not-contact
  • Tags и lifecycle stages: добавлять и удалять теги, переводить contact на другой stage
  • Conversations: назначать teammate, закрывать с closing note, ставить AI на паузу или возобновлять, добавлять team comments, отправлять сообщение от имени вашего business
  • Bookings и reminders: проверять свободное время, бронировать, переносить, отменять, создавать и закрывать reminders
  • Orders и products: создавать и обновлять orders и их items, управлять каталогом
  • Calls: запускать AI phone call или ставить его в очередь, читать результат
  • Campaigns: просматривать campaigns и отправлять их

Когда что-то меняется, Entagl может сразу сообщить вашим инструментам через webhooks.

Два способа входа

Make. Когда вы подключаете Make, вы входите в систему под своим аккаунтом Entagl. Затем Make действует от вашего имени с ровно теми же правами: owner или admin могут всё, а team member — только то, что разрешают его права. Если в вашем логине несколько workspace, вы выбираете, какой использовать.

API key. Для своего сервера создайте key в Каналы → API или Настройки → API keys и передавайте его как Authorization: Bearer <your key>. Key принадлежит одному workspace и даёт ему полный доступ owner, поэтому относитесь к нему как к паролю.

Безопасно повторять: заголовок Idempotency-Key

Иногда запрос проходит, но ответ теряется по пути обратно. Если система не уверена, что запрос сработал, она может отправить его снова с тем же заголовком Idempotency-Key. В течение 24 часов Entagl распознаёт key, пропускает выполнение и возвращает первый ответ, так что у вас не появятся два заказа или два contacts. Использование того же key для другого запроса будет отклонено с ошибкой.

Сколько запросов можно отправлять

До 120 запросов в минуту на каждый workspace. Если превысить лимит, Entagl ответит ошибкой 429 (rate_limited). Подождите немного и попробуйте снова. Большинство автоматизаций до этого даже не доходят.

Полная API reference

Каждая конечная точка, поле и код ошибки перечислены в справочном руководстве API Entagl. Откройте его с помощью ссылки Для разработчиков: справочное руководство API в верхней части этой страницы и поделитесь им с вашим разработчиком.

API key даёт полный доступ owner к своему workspace. Храните его на сервере, никогда не размещайте в веб-сайте или приложении, которое могут открыть клиенты, и отзовите его сразу, как только заподозрите утечку.
Изменения, внесённые через API, в событиях webhook помечаются как сделанные через API, поэтому сценарий Make может игнорировать свои собственные изменения вместо того, чтобы зациклиться.

Функции

Настройка и аутентификация

Откройте Настройки → Интеграции, выберите API и нажмите Сгенерировать API-ключ. Включите переключатель в карточке API Channel, затем вызовите API по адресу https://api.entagl.com с заголовком Authorization: Bearer <ваш ключ>. Каждый ключ работает только для одного рабочего пространства.

Отправка сообщения

POST /api/v1/messages с { message, externalUserId }. Сразу получите 202 и conversationId. Используйте этот conversationId повторно, чтобы продолжить conversation. Ответ agent придёт позже, не в этом ответе.

Webhook (callback) (рекомендуется)

Вставьте URL обратного вызова в карточку API Channel и нажмите Сохранить. Затем Entagl отправляет каждый ответ агента на него, подписанный заголовком X-Entagl-Signature (HMAC-SHA256). Используйте публичный HTTPS-адрес и нажмите Отправить тестовую доставку, чтобы проверить, работает ли это. Ваш сервер должен проверить подпись и ответить кодом 2xx примерно за 5 секунд. Неудачные обратные вызовы не повторяются.

Опрос (Polling)

Если вы не можете разместить адрес callback, вызывайте GET /api/v1/conversations/:id/messages?since=<cursor>, чтобы получать новые ответы. Передавайте cursor из каждого ответа как ?since=, чтобы получать только новые сообщения.

Безопасность и изоляция

API keys хранятся в виде хэша, а signing secret зашифрован (оба показываются только один раз). Каждый поиск привязан к workspace: conversation ID из другого workspace вернёт 404, и передать user ID нельзя (он выводится из вашего key).

Распространённые задачи

Настройка канала API

Около 3 мин
  1. Откройте Настройки → Интеграции, выберите API и нажмите Сгенерировать API-ключ. Дайте ему имя, если хотите, затем скопируйте ключ сейчас, потому что он отображается только один раз.
  2. Включите переключатель в заголовке карточки API Channel. Пока он выключен, сообщения, отправленные в API, отклоняются.
  3. Рекомендуется: откройте настройки карточки, вставьте ваш URL обратного вызова и нажмите Сохранить. Скопируйте секрет подписи, который появится, затем нажмите Отправить тестовую доставку.
  4. Из своего приложения отправляйте сообщения методом POST на https://api.entagl.com/api/v1/messages и получайте ответы через callback или опрос.

Советы

Ответы приходят асинхронно. POST возвращает 202, а ответ agent приходит через callback или polling, а не в самом ответе.
Одно сообщение может дать несколько ответов после небольшой задержки буферизации (около 8 секунд, настраивается до ~5 минут). Показывайте их все по порядку.
202 не гарантирует ответ. Agent может промолчать, если automation приостановлена, guardrail блокирует сообщение или в workspace закончились credits.
У callback нет автоповтора. Держите опрос как резерв и всегда проверяйте заголовок X-Entagl-Signature, прежде чем доверять доставке.
Повторно используйте conversationId, чтобы продолжить разговор; externalUserId — это просто ваша собственная метка для конечного пользователя.
Пока только текст. Храните API key и signing secret в безопасности: оба показываются только один раз.

Часто задаваемые вопросы

Эта страница была полезной?