Где взять доступ к Планадо
Путь по меню, нужные поля и что делать, если Планадо отвечает ошибкой
Где взять доступ в Планадо
- Кабинет Планадо → Настройки → Интеграции → API
- Если поле с ключом пустое, нажмите кнопку обновления рядом с ним — ключ создастся
- Шаблон наряда указывается его uuid. Нажмите «Проверить ключ» на вкладке «Настройка»: мы покажем до пяти шаблонов с uuid
- Участок пишется названием, как он называется в Планадо
- API включено начиная с тарифа «Про»; на младших тарифах ключ не выдаётся
Телефон обязателен: без него наряд не на кого оформить. Дата и время из формы становятся плановым началом работ, длительность берётся из настройки. Почту Планадо в контактах не хранит, поэтому она уходит в описание наряда вместе с остальными полями формы.
Что заполнить в кабинете
Всё это заполняется на вкладке «Настройка» интеграции в разделе «Connect». Там же в блоке «Поля формы» впишите, как поля называются в вашей форме.
Доступ
- Ключ API — Настройки → Интеграции → API в кабинете Планадо
Наряд
- Шаблон наряда — uuid шаблона; пусто — наряд без шаблона. Кнопка «Проверить ключ» покажет ваши шаблоны
- Начало описания — —
- Длительность работ, минуты — —
- Участок — название участка в Планадо; пусто — без участка
Что появится в Планадо
В Планадо создаётся наряд: клиент с именем и фамилией (имя делим по первому пробелу), адрес работ одной строкой. Телефон попадает в контакты наряда и в карточку клиента. Дата и время из формы становятся плановым началом, длительность берётся из настройки. Если указан шаблон, наряд создаётся по нему и подтягивает свои поля и чек-лист. Участок проставляется названием. В описание наряда попадает всё, что прислала форма, включая почту: в контактах Планадо хранит только телефоны.
Как проверить
Нажмите «Тестовая заявка» внизу вкладки «Настройка» или отправьте пробную заявку со своего сайта. Откройте её в «Connect»: интеграция → вкладка «Заявки» → строка заявки. Пока включён черновой режим, у разобранной заявки статус «Черновик»: видно, что прислала форма и что уйдёт в Планадо. Когда вы выключите черновой режим на вкладке «Настройка», у новых заявок там же появится ответ сервиса.
Про эту интеграцию · Как подключить с нуля
Если не работает
Планадо отвечает 401
Ключ неверен или отозван. Возьмите его заново в разделе «Настройки → Интеграции → API»: там же есть кнопка перевыпуска.
Наряд создаётся без шаблона
В поле «Шаблон наряда» нужен uuid, название не подойдёт. Нажмите «Проверить ключ»: в ответе будут до пяти шаблонов с uuid.
Планадо отвечает 429
Планадо разрешает 120 запросов в минуту. Заявка сверх лимита получит статус «Повтор» и уйдёт через пять минут сама. Чтобы не ждать, откройте её на вкладке «Заявки» и нажмите «Отправить сейчас».
Время наряда сдвинуто на несколько часов
Проверьте часовой пояс в настройке: форма присылает время без пояса, и мы собираем момент по нему.