Aisha API: Платформа для разработчиков

Aisha AI — компания, ориентированная на разработчиков. Мы предоставляем мощную платформу API для облегчения интеграции продуктов Aisha. С помощью Aisha API разработчики могут добавить чат-боты, голосовые агенты, аналитику звонков и другие AI-сервисы в свои приложения.

Aisha API — это не простой интерфейс с одной или двумя конечными точками. Это полнофункциональная, масштабируемая и готовая к эволюции платформа. Как молодые стартапы, создающие свои MVP, так и крупные корпорации, реализующие сложные интеграции, используют Aisha API.

Архитектура API и основные компоненты

Aisha API состоит из следующих основных компонентов:

  • Authentication API — аутентификация на основе OAuth 2.0
  • Chat API — конечные точки для услуг чат-ботов
  • Voice API — для голосовых агентов и обработки речи
  • Analytics API — для аналитики звонков и данных анализа
  • Webhooks — для событий реального времени
  • File Upload API — для загрузки аудиофайлов и медиа

Каждый компонент предоставляет конкретные возможности определённого сервиса. Например, Chat API позволяет использовать чат-бот в любом чате (веб, мобильный, месседжер).

Аутентификация и безопасность

Aisha API придерживается современных практик безопасности. Аутентификация API основана на стандарте OAuth 2.0, что обеспечивает безопасность на уровне предприятия. Все вызовы API производятся через HTTPS в зашифрованном виде.

Можно применять следующие уровни безопасности:

  • API Keys — для простых интеграций
  • OAuth 2.0 — для сторонних приложений
  • JWT Tokens — для stateless аутентификации
  • IP Whitelisting — для дополнительной защиты

Ключи API и токены управляются в соответствии с GDPR и местными законами. В документации Aisha API приведены best practices для безопасного хранения ключей API.

Chat API: интеграция чат-бота

Chat API — основной интерфейс Aisha Chatbot. Через этот API разработчики создают сессии чата, отправляют сообщения и получают ответы.

Основные конечные точки Chat API:

  • POST /api/v1/chat/messages — отправка сообщения пользователя
  • GET /api/v1/chat/history — получение истории чата
  • POST /api/v1/chat/sessions — создание новой сессии чата
  • PUT /api/v1/chat/config — изменение конфигурации чат-бота

Chat API возвращает сообщения в формате JSON, что позволяет легко обрабатывать их на любом языке программирования.

Voice API: голосовые агенты и обработка речи

Voice API предоставляет конечные точки для Voice Agent и услуг TTS, STT. С помощью этого API разработчики могут создавать голосовые приложения.

Основные функции Voice API:

  • Speech Recognition — преобразование речи в текст
  • Text-to-Speech — преобразование текста в речь
  • Voice Call Automation — автоматические звонки
  • Voice Analytics — анализ голосовых звонков

Voice API обеспечивает многоязычную поддержку, так что общение возможно на узбекском, русском и английском языках.

Analytics API: данные и отчёты

Analytics API предоставляет данные для Call Metrics и других аналитических услуг. Через этот API разработчики могут создавать панели управления аналитикой в реальном времени.

Конечные точки Analytics API:

  • GET /api/v1/analytics/calls — статистика звонков
  • GET /api/v1/analytics/agents — метрики производительности операторов
  • GET /api/v1/analytics/sentiment — результаты анализа чувств
  • GET /api/v1/analytics/reports — создание пользовательского отчёта

Analytics API обеспечивает возможности фильтрации, группировки и агрегации, позволяя создавать мобильные аналитические приложения.

Webhooks: события в реальном времени

Webhooks — важная часть Aisha API. Они держат системы разработчиков в курсе событий на платформе Aisha в реальном времени. Например, webhook срабатывает, когда приходит сообщение чата, заканчивается звонок или меняется настроение.

Webhooks срабатывают для следующих событий:

  • Пришло сообщение чата
  • Начался/закончился голосовой звонок
  • Готова транскрипция совещания
  • Обнаружено настроение
  • Выявлен элемент действия

Webhooks позволяют разработчикам держать свои системы в синхронизации с платформой Aisha.

SDK и поддержка

Aisha API предоставляет SDK для всех популярных языков программирования:

  • Python — для data science и backend
  • JavaScript/TypeScript — для веб и Node.js приложений
  • Java — для enterprise приложений
  • Go — для высокопроизводительных систем
  • PHP — для legacy систем

Загрузите SDK Aisha API и начните разработку с документацией. Все SDK содержат comprehensive примеры и best practices.

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

Сколько стоит использование Aisha API?

Ценообразование Aisha API гибкое и масштабируемо. Есть бесплатный уровень для малых проектов, модели оплаты по мере использования для средних проектов и пользовательские тарифы для предприятий. Загрузите прайс-лист.

Какие ограничения на скорость API?

Ограничения скорости API зависят от вашего тарифного плана. Бесплатный уровень имеет лимит 100 запросов/минуту, про-уровень 1000 запросов/минуту, а enterprise имеет неограниченный доступ. Лимиты скорости автоматически обновляются по мере роста использования.

Какова доступность и время безотказной работы API?

Aisha API гарантирует 99,9% время безотказной работы. Мы обеспечиваем высокую доступность через балансировщик нагрузки и избыточность. Вы можете мониторить в реальном времени через страницу статуса.

Какова поддержка Aisha API?

Документация Aisha API полная, но для вопросов специалисты технической команды Aisha помогут вам. Поддержка доступна 24/7 по электронной почте, Slack и телефону.

Начните интеграцию с Aisha API! Свяжитесь с нами и загрузите документацию для получения API-ключа.