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

!LiraX Header

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

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

---

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

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

$3

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

$3

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

$3

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

$3

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

$3

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

$3

* 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 в мощную платформу для голосовых ботов.

$3

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

$3

Чтобы 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 для перевода аудио в текст.

$3

Если 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