Коннектор

Zadarma: ИИ-агент для звонков и обращений

Сервиса нет в каталоге. Подключение по описанию API.

Zadarma — облачная телефония: виртуальные номера, АТС, SMS и коллтрекинг с открытым API. Агент собирает обращения по звонкам и сообщениям, ведёт журнал и приносит сводку, а разговор с клиентом остаётся на линии.

Что такое агент

Агент — программа, которая делает дело целиком. Не подсказывает, куда звонить, а собирает историю звонков и сообщений в один журнал обращений и отмечает пропущенное.

Три признака. Работает в ваших сервисах: в телефонии и в учёте заявок. Доводит до результата: обращение зарегистрировано, сводка собрана. Работает без вас — по событию звонка.

Чат-бот объяснит, что такое переадресация. Агент покажет, сколько вызовов ушло в пропущенные за неделю.

Что такое коннектор

Коннектор описывает подключение: где взять ключи, что видно, как проверить связь. Ключи для авторизации выдаются в личном кабинете: из них собирается заголовок Authorization, где через двоеточие идут ключ пользователя и подпись.

Это не плагин в телефонии и не доработка АТС. Пароль от кабинета агент не хранит: он работает с ключом и секретом, которые выданы под задачу.

Что это за сервис

API закрывает все основные функции: телефонию и виртуальные номера, АТС и CRM, SMS и HLR-запросы, коллтрекинг и распознавание речи. Каждый запрос, которому нужна авторизация, сопровождается заголовком с ключом и подписью.

Подпись не передаётся в открытом виде: строка запроса хешируется вместе с секретным ключом пользователя, а результат кодируется. Методы сгруппированы по разделам: сведения о балансе, часовой пояс, тарифы, запрос обратного звонка, проверка номера, поиск информации о номере, справочники валют, языков и тарифов, SIP-настройки. Есть разделы с библиотеками и примерами, а также описание ограничений.

Что делает агент с Zadarma

### Входящая корреспонденция: регистрация и резолюция

Агент забирает события по звонкам и SMS и превращает их в обращения: кто звонил, на какой номер, чем закончился разговор. Обращение получает номер и тему, а в карточке появляется черновик резолюции для сотрудника.

### Заявки из почты, форм и мессенджеров

Кроме звонков заявки приходят письмом и через форму. Агент приводит их к одному набору полей, сверяет с открытыми обращениями по номеру телефона и только потом заводит новое. Дубли отсекаются, а не копятся.

### Сводки по обращениям: день и месяц

Агент считает звонки по часам и номерам, отмечает пропущенные и показывает, сколько обращений осталось без ответа. За день выходит короткая сводка, за месяц — сравнение нагрузки по времени и номерам.

Что остаётся человеку

Маршрутизацию звонков и тексты приветствия настраивает человек. Он же решает спорный случай, когда клиент требует живого оператора, и подтверждает запрос обратного звонка.

Как подключить

Войдите в личный кабинет Zadarma и откройте раздел для работы с API: там выдаются ключ пользователя и секретный ключ. Из них собирается подпись запроса, а сам запрос идёт на адрес API с версией. Проверка связи — запрос сведений о балансе: ответ с суммой означает, что доступ работает.

Чего агент не делает

Не звонит клиентам вместо оператора и не меняет настройки АТС. Не хранит секретный ключ в открытом виде. Не работает с номерами, которые не закреплены за аккаунтом.

Вопросы

Что такое агент, если коротко? Программа, которая доводит дело до результата: собирает звонки и сообщения в журнал обращений и приносит сводку по нагрузке.

Что такое коннектор? Описание подключения: ключ пользователя и секретный ключ из кабинета, из которых собирается подпись запроса. Пароль кабинета агент не хранит.

Почему подпись собирается, а не передаётся ключ? Так запрос нельзя повторить, зная только адрес: подпись зависит от строки запроса и секрета. Ключ остаётся на вашей стороне.

Подключение

  1. Шаг 1: войдите в личный кабинет Zadarma и откройте раздел для работы с API.
  2. Шаг 2: получите ключ пользователя и секретный ключ — из них собирается подпись запроса в заголовке Authorization.
  3. Шаг 3: передайте агенту ключи и проверьте связь запросом сведений о балансе: ответ с суммой означает, что доступ работает.

Роли

Сценарии