HTTP API

Публичный HTTP-метод для внешних систем — отправка текста в существующий диалог Amobit Chats. Чтение диалогов и истории для AI-клиентов идёт через MCP, настройка каналов и интеграции — через кабинет.

Аутентификация

Токен выпускает владелец или администратор компании: Профиль → Интеграции → API / Webhook → Создать токен. Токен показывается один раз, начинается с amc_ и передаётся в заголовке:

Authorization: Bearer amc_ВАШ_ТОКЕН

Эквивалентная форма, если ваш HTTP-клиент не умеет Authorization:

X-Amobit-Chats-Token: amc_ВАШ_ТОКЕН

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

{
  "id": "f09de45d-0000-4000-9000-000000000003",
  "thread_id": "9fd48a99-f5f3-4c3d-8ca1-1f0e047d5b25",
  "channel": "whatsapp",
  "direction": "outgoing",
  "message_type": "text",
  "text": "Ответ из CRM",
  "preview_text": "Ответ из CRM",
  "delivery_status": "pending",
  "sent_at": "2026-10-20T12:00:00+00:00",
  "provider_transport_id": "",
  "attachments": []
}

Коды ответов

Ограничения

• Только текст. Медиа, геолокация, контакты и реакции через этот API не отправляются.
• Только существующие диалоги. Начать переписку с новым контактом нельзя.
• Текст ≤ 4000 символов, ключ идемпотентности ≤ 255.
• Отдельной квоты на токен и лимита частоты на этом эндпоинте нет. Действуют ограничения канала и провайдера; при массовых рассылках используйте кампании в кабинете, а не этот API.
• Ответ через API не останавливает AI-агента. В отличие от ответа оператора в интерфейсе, сообщение из внешней системы не переводит диалог в режим «человек отвечает». Если на канале работает AI-агент, приостановите его на своей стороне, иначе клиент получит два ответа.
• Статусы доставки не приходят отдельным событием. Фиксируйте delivery_status из ответа и события message.created; отдельного вебхука статуса пока нет.

Примеры

curl

curl -X POST https://chats.amobit.io/api/v1/external-integrations/inbound/messages/ \
  -H "Authorization: Bearer amc_ВАШ_ТОКЕН" \
  -H "Content-Type: application/json" \
  -d '{
    "thread_id": "9fd48a99-f5f3-4c3d-8ca1-1f0e047d5b25",
    "text": "Здравствуйте! Отвечаем из CRM.",
    "idempotency_key": "crm-outbox-1001",
    "metadata": {"lead_id": "42"}
  }'

Node.js (fetch, Node 18+)

const res = await fetch(
  "https://chats.amobit.io/api/v1/external-integrations/inbound/messages/",
  {
    method: "POST",
    headers: {
      Authorization: `Bearer ${process.env.AMOBIT_CHATS_TOKEN}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      thread_id: threadId,
      text,
      idempotency_key: `crm-outbox-${outboxId}`,
    }),
  },
);
const data = await res.json();
if (res.status === 201 || res.status === 200) return data;
if ([202, 502, 500].includes(res.status)) {
  // Повторить с ТЕМ ЖЕ idempotency_key, не создавать новый.
  throw new RetryableError(data.detail || "retry");
}
throw new PermanentError(data);

PHP (curl)

$payload = json_encode([
    'thread_id' => $threadId,
    'text' => $text,
    'idempotency_key' => 'crm-outbox-' . $outboxId,
], JSON_UNESCAPED_UNICODE);

$ch = curl_init('https://chats.amobit.io/api/v1/external-integrations/inbound/messages/');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_POSTFIELDS => $payload,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('AMOBIT_CHATS_TOKEN'),
        'Content-Type: application/json',
    ],
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 20,
]);
$body = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
curl_close($ch);

Служебные эндпоинты кабинета

Настройки интеграции и выпуск токена использует сам кабинет. Журнал доставок доступен только этим API: в карточке интеграции он пока не отображается. Все методы требуют сессию Amobit ID и CSRF-токен, поэтому не предназначены для вызова из внешней системы. Список приведён для полноты контракта и для поддержки:

Сессионные запросы выполняются с credentials: include и CSRF-заголовком; к ним применяются роли компании (owner/admin для изменений).

Машиночитаемый контракт

OpenAPI 3.1 описывает этот метод, схемы запроса и ответа, коды ошибок и событие вебхука. Спецификация — источник для генерации клиентов и моков; при расхождении с этой страницей приоритет у поведения API, о расхождении сообщите в поддержку.