Планируем созвон в zoom из PlanFix
Пару месяцев назад, чтобы как-то систематизировать частые созвоны с клиентами, я сделал в своем ПФ специальный шаблон для созвонов:
Работать стало удобнее: ссылки на созвоны всегда под рукой, а с помощью сценариев клиентам автоматически отправляются приглашение, в котором также содержится ссылка на подключение.
Но каждый раз при планировании нового созвона, приходилось открывать zoom планировать созвон, после чего открывать PlanFix создавать там тот же созвон, указывать такую же тему и время начала, и копировать полученную ссылку из zoom.
Вчера я решил, что нужно с этим покончить, и полез смотреть какие возможность предлагает zoom для интеграции по API. Оказалось все не так сложно и уже через 40 минут у меня была готова интеграция.
Для настройки нам нужно сделать всего два шага:
1. Получить токен для авторизации в Zoom.
Открываем платформу для разработчиков по адресу - https://developers.zoom.us/ и заходим под своей учеткой от zoom
Поле входа создаем приложение с помощью кнопки BUILD APP
Указываем любое имя для приложения
Заполняем обязательную информацию
На следующей странице мы уже видим токен, за которым сюда и пришли. В параметре Expire in лучше сразу указать время жизни токен на год вперед, тогда в следующий раз за обновлением токена нужно будет прийти сюда только через год.
2. Добавить сценарий
Создаем сценарий, который будет отправлять POST запрос в zoom, при создании созвона. У меня он выглядит следующим образом:
Отправлять POST запрос будем на адрес: https://api.zoom.us/v2/users/me/meetings
В качестве переменных в тело запроса подставляем:
Дату и время начала(в формате yyyy-MM-ddTHH:mm:ss)
{
"topic" : "{{Задача.Тема созвона}}",
"type" : "2",
"start_time" : "{{Задача.Начало созвона::форматироватьДату=yyyy-MM-dd}}T{{Задача.Начало созвона::форматироватьДату=HH:mm:ss}}",
"duration" : "{{Задача.Продолжительность созвона, мин}}"
}Токен для авторизации полученный нами на первом шаге подставляем в заголовок Authorization. В значение заголовка непосредственно перед токеном нужно добавить слово - Bearer
Bearer eyJhbGciOiJI11111111111111111111111111111111111111111111111111111111111111111111111111111
Также настроим разбор ответа, чтобы полученную ссылку на встречу положить в нужное поле:
(Ссылка находится в параметре join_url)
Собственно вот и всё, теперь создать созвон и пригласить туда коллег и клиентов стало намного проще)