n8n-nodes-lirax: Интеграция LiraX с n8n и AI

LiraX — это профессиональная облачная IP-телефония и CRM. Пакет n8n-nodes-lirax предоставляет полный набор инструментов ("нод") для автоматизации звонков, управления клиентами и создания Голосовых AI Агентов внутри n8n.

🚀 Версия 2.2.2 — Полная поддержка n8n AI Agents, работа с аудио (Whisper) и стандартизированные инструменты.

📦 Что включено?

В пакет входят 6 специализированных нод, покрывающих 100% возможностей API LiraX:

🤖 Для AI и LLM

• LiraX Tool (NEW): Специальная нода-инструмент для подключения к AI Agent в n8n. Позволяет GPT/Claude управлять звонками, "видеть" контекст клиента и переводить звонки на операторов.

📞 Телефония

• LiraX Telephony: "Тяжелая артиллерия" для звонков.
  • Make Call: Обычный звонок.
  • Smart Call: Звонок с TTS приветствием ("Здравствуйте, это доставка...").
  • IVR / Ask Question: Задать вопрос и распознать ответ (DTMF/Голос).
  • Get Recording: Получить запись звонка (авто-определение MP3/WAV).

🤝 CRM и Клиенты

• LiraX CRM: Управление базой.
  • Создание/Поиск контактов.
  • Сделки (Deals) и Задачи (Tasks).
  • Заметки (Notes).
  • Поддержка Resource Locator для выбора сотрудников и стадий.

⚡ Триггеры (Real-time)

• LiraX Trigger: Запускает workflow при событиях.
  • Входящий звонок (Incoming Call).
  • Завершение звонка (Hangup).
  • Получение SMS.
  • Результат IVR опроса.

💬 Сообщения

• LiraX Messaging: Отправка SMS и сообщений во внутренний чат.

⚙️ Администрирование

• LiraX Admin: Управление SIP-маршрутизацией, сотрудниками и черными списками.

🚀 Установка

1. Откройте ваш n8n.
2. Перейдите в Settings > Community Nodes.
3. Нажмите Install и введите: n8n-nodes-lirax.
4. Согласитесь с рисками (это стандартное сообщение для custom нод).

🔑 Настройка (Credentials)

Вам понадобится IP (адрес сервера) и Token (ключ API) от LiraX.

1. Добавьте ноду (например, LiraX Telephony) на холст.
2. В параметре Credential выберите Create New.
3. Введите данные:
   • Server IP: IP адрес вашей АТС LiraX (например, 185.x.x.x).
   • Token: Ваш API токен (получите у техподдержки LiraX).
4. Настройка готова! Она применится ко всем нодам пакета.

🧠 Руководство: Создание Голосового AI Агента

Версия 2.2+ превращает n8n в мощную платформу для голосовых ботов.

Шаг 1: Подключение Инструмента (Tools)

1. Создайте ноду AI Agent.
2. Рядом создайте ноду LiraX Tool.
3. Соедините выход ai_tool (LiraX Tool) со входом Tools (AI Agent).
4. В настройках LiraX Tool выберите операции, которые разрешено делать боту (например, Get Call History, Voice Handoff).

Шаг 2: Контекст (Context Hydration)

Чтобы AI не звучал как робот, он должен знать, с кем говорит.
Используйте операцию getAiContext в начале диалога:

• Она вернет JSON с именем клиента, последними сделками и историей звонков за 30 дней.
• Промпт для AI: "Ты говоришь с {contact.name}. Последний раз он звонил {history.lastCall.date}. Учитывай это."

Шаг 3: Работа с Голосом и Аудио

LiraX хранит записи в разных форматах (MP3/WAV/OGG). Нода автоматически определяет формат для n8n.

Сценарий: Транскрибация звонка (Whisper)

1. AI Agent вызывает инструмент getRecording.
2. Инструмент возвращает url и contentType.
3. Используйте ноду HTTP Request (GET url) -> OpenAI Whisper для перевода аудио в текст.

Шаг 4: Перевод на оператора (Voice Handoff)

Если AI не справляется, он должен перевести звонок.

• Операция: voice_handoff.
• Параметры:
  • to: Номер сотрудника (например, 101).
  • speech: "Шепот" оператору (AI скажет оператору, в чем проблема клиента, ПЕРЕД тем как соединить).

❓ Частые вопросы (FAQ)

В: Нода LiraX Tool не подключается к AI Agent (серый коннектор).
О: Обновитесь до версии 2.2.2. Мы исправили тип подключения на нативный ai_tool.

В: Какой формат даты использовать?
О: Ноды автоматически конвертируют стандартный ISO (из n8n) в формат LiraX SQL (YYYY-MM-DD HH:mm:ss). Просто используйте {{ $now }}.

В: Ошибка 401 Unauthorized.
О: Проверьте ваш IP в белом списке LiraX API. API доступно только с разрешенных IP адресов.

В: Где взять документацию по API?
О: Официальная документация LiraX API (требуется доступ).

📞 Поддержка

Разработано командой PRAGMA Solutions для сообщества n8n.
По вопросам интеграции: info@pragma.by