AISARAISAR
REST API

Быстрые ответы

Сниппеты (быстрые ответы) — заготовленные компанией текстовые шаблоны с опциональными вложенными файлами, которые оператор вставляет в чат одним действием без ручного набора текста. В отличие от шаблонов сообщений (Templates), сниппеты не проходят модерацию у провайдера и используются только внутри уже открытого 24-часового окна переписки. Создание и обновление — `multipart/form-data`, так как поддерживают загрузку файлов.

Эндпоинты

МетодПуть
GET/v1/snippets

Список быстрых ответов компании.

POST/v1/snippets

Создать быстрый ответ (multipart/form-data, до 10 файлов на запрос).

POST/v1/snippets/{snippet}

Обновить быстрый ответ — текст, добавить/удалить файлы (multipart/form-data).

DELETE/v1/snippets/{snippet}

Удалить быстрый ответ.

GET/v1/snippets/{snippet}/files/{snippetFile}/download

Скачать файл, прикреплённый к быстрому ответу (по подписанной ссылке).

Примеры

Создание быстрого ответа

Запрос

bash
curl -X POST "https://api.aisar.app/v1/snippets" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -F "name=Приветствие" \
  -F "message=Здравствуйте! Чем можем помочь?" \
  -F "files[]=@/path/to/price-list.pdf"

Ответ

json
{
  "data": {
    "id": 9,
    "company_id": 1,
    "name": "Приветствие",
    "message": "Здравствуйте! Чем можем помочь?",
    "files": [
      {
        "id": 21,
        "name": "price-list.pdf",
        "size": 48213,
        "type": "application/pdf",
        "download_url": "https://api.aisar.app/v1/snippets/9/files/21/download?expires=...&signature=..."
      }
    ],
    "updated_at": "2026-02-09T18:00:00Z"
  }
}

Список быстрых ответов

Запрос

bash
curl -X GET "https://api.aisar.app/v1/snippets" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json"

Ответ

json
{
  "data": [
    {
      "id": 9,
      "company_id": 1,
      "name": "Приветствие",
      "message": "Здравствуйте! Чем можем помочь?",
      "files": [],
      "updated_at": "2026-02-09T18:00:00Z"
    }
  ]
}