Руководство / Практика голосового ИИ
Как связать звонок ИИ-агента с CRM через API
Событие в CRM, запуск звонка, получение результата и защита от повторов. Пошаговая схема интеграции.
Интеграция состоит минимум из двух направлений: CRM передаёт задачу, MAIA возвращает результат. Проверьте весь цикл на тестовой записи. Успешный HTTP-ответ о создании звонка не означает, что клиент ответил или сделка обновилась.
Начните с чтения
Создайте API-ключ с минимальными правами и проверьте список проектов. Публичные методы используют префикс /v1/public. Идентификатор проекта — UUID из ответа, а не условное имя из иллюстрации.
curl https://api.maia-ai.com/v1/public/projects \
-H "X-API-Key: $MAIA_KEY"Прокрутите код вправо →
Задача из CRM
- Определить событие запуска и проверить, не обрабатывалось ли оно ранее.
- Выбрать проект и передать только необходимые сведения о задаче.
- Проверить разрешённые часы, право на контакт и ограничение расходов.
- Сохранить идентификатор звонка рядом с исходной задачей CRM.
Результат и повторная доставка
Результат разговора может появиться позже исходного запроса. Обработчик должен связывать события с конкретным звонком и повторно принимать ту же доставку без дублирования записи.
Проверяйте подпись вебхука по текущей документации MAIA. Отдельно обработайте недозвон, ошибку, завершённый разговор и последующую готовность данных. Не каждое событие означает новую продажу.
Проверка готовности
Сначала используйте тестовый проект и разрешённый контакт. Убедитесь, что в CRM появилось нужное состояние, корректная ссылка и только необходимые поля. После этого проверьте повтор, временную недоступность CRM и отказ от звонка.
Для нативных интеграций часть маршрута уже реализована платформой. Для собственного API-процесса ответственность за сопоставление событий и обработку ошибок остаётся в вашей интеграции.
Источники и проверка
Используйте актуальные документы поставщика и настройки своего проекта. Поддержка режима, условия тарифа и параметры могут измениться.
Публичный API MAIA
Проверьте подходящий сценарий и возможности своего проекта.
Подробнее