Коннектор
Zadarma: ИИ-агент для звонков и обращений
Сервиса нет в каталоге. Подключение по описанию API.
Zadarma — облачная телефония: виртуальные номера, АТС, SMS и коллтрекинг с открытым API. Агент собирает обращения по звонкам и сообщениям, ведёт журнал и приносит сводку, а разговор с клиентом остаётся на линии.
Что такое агент
Агент — программа, которая делает дело целиком. Не подсказывает, куда звонить, а собирает историю звонков и сообщений в один журнал обращений и отмечает пропущенное.
Три признака. Работает в ваших сервисах: в телефонии и в учёте заявок. Доводит до результата: обращение зарегистрировано, сводка собрана. Работает без вас — по событию звонка.
Чат-бот объяснит, что такое переадресация. Агент покажет, сколько вызовов ушло в пропущенные за неделю.
Что такое коннектор
Коннектор описывает подключение: где взять ключи, что видно, как проверить связь. Ключи для авторизации выдаются в личном кабинете: из них собирается заголовок Authorization, где через двоеточие идут ключ пользователя и подпись.
Это не плагин в телефонии и не доработка АТС. Пароль от кабинета агент не хранит: он работает с ключом и секретом, которые выданы под задачу.
Что это за сервис
API закрывает все основные функции: телефонию и виртуальные номера, АТС и CRM, SMS и HLR-запросы, коллтрекинг и распознавание речи. Каждый запрос, которому нужна авторизация, сопровождается заголовком с ключом и подписью.
Подпись не передаётся в открытом виде: строка запроса хешируется вместе с секретным ключом пользователя, а результат кодируется. Методы сгруппированы по разделам: сведения о балансе, часовой пояс, тарифы, запрос обратного звонка, проверка номера, поиск информации о номере, справочники валют, языков и тарифов, SIP-настройки. Есть разделы с библиотеками и примерами, а также описание ограничений.
Что делает агент с Zadarma
### Входящая корреспонденция: регистрация и резолюция
Агент забирает события по звонкам и SMS и превращает их в обращения: кто звонил, на какой номер, чем закончился разговор. Обращение получает номер и тему, а в карточке появляется черновик резолюции для сотрудника.
### Заявки из почты, форм и мессенджеров
Кроме звонков заявки приходят письмом и через форму. Агент приводит их к одному набору полей, сверяет с открытыми обращениями по номеру телефона и только потом заводит новое. Дубли отсекаются, а не копятся.
### Сводки по обращениям: день и месяц
Агент считает звонки по часам и номерам, отмечает пропущенные и показывает, сколько обращений осталось без ответа. За день выходит короткая сводка, за месяц — сравнение нагрузки по времени и номерам.
Что остаётся человеку
Маршрутизацию звонков и тексты приветствия настраивает человек. Он же решает спорный случай, когда клиент требует живого оператора, и подтверждает запрос обратного звонка.
Как подключить
Войдите в личный кабинет Zadarma и откройте раздел для работы с API: там выдаются ключ пользователя и секретный ключ. Из них собирается подпись запроса, а сам запрос идёт на адрес API с версией. Проверка связи — запрос сведений о балансе: ответ с суммой означает, что доступ работает.
Чего агент не делает
Не звонит клиентам вместо оператора и не меняет настройки АТС. Не хранит секретный ключ в открытом виде. Не работает с номерами, которые не закреплены за аккаунтом.
Вопросы
Что такое агент, если коротко? Программа, которая доводит дело до результата: собирает звонки и сообщения в журнал обращений и приносит сводку по нагрузке.
Что такое коннектор? Описание подключения: ключ пользователя и секретный ключ из кабинета, из которых собирается подпись запроса. Пароль кабинета агент не хранит.
Почему подпись собирается, а не передаётся ключ? Так запрос нельзя повторить, зная только адрес: подпись зависит от строки запроса и секрета. Ключ остаётся на вашей стороне.
Подключение
- Шаг 1: войдите в личный кабинет Zadarma и откройте раздел для работы с API.
- Шаг 2: получите ключ пользователя и секретный ключ — из них собирается подпись запроса в заголовке Authorization.
- Шаг 3: передайте агенту ключи и проверьте связь запросом сведений о балансе: ответ с суммой означает, что доступ работает.