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

Используйте интеграцию Ukrposhta с SendPulse CRM, чтобы подключить бизнес-аккаунт Укрпочты к CRM и передавать данные об отправлениях в сделки и контакты.

С помощью интеграции вы можете:

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

Рассмотрим, как установить приложение Ukrposhta и настроить интеграцию.

Содержание

Проверьте требования к подключению

Прежде чем настраивать интеграцию, убедитесь, что у вас есть все необходимое:

Договор с Укрпочтой	Подписанный Единый договор с Укрпочтой. Интеграция подключается только по ключам API, которые Укрпочта выдает по договору.
Тариф CRM	Любой подключенный тариф CRM для создания отправлений из карточки сделки.

Подключите Укрпочту к SendPulse CRM

Чтобы начать пользоваться интеграцией, получите два ключа API бизнес-аккаунта Укрпочты, установите приложение из Каталога приложений SendPulse и подключите Ukrposhta к своему аккаунту.

Получите ключи API Укрпочты

Чтобы подключить Укрпочту к SendPulse, нужны два ключа API бизнес-аккаунта: User Token и Authorization Bearer.

Перейдите на страницу Укрпочта для бизнеса и подпишите «Единый договор» онлайн с помощью КЭП или другой электронной подписи.

Обратитесь к своему менеджеру Укрпочты или напишите на support-yo@ukrposhta.ua и запросите активацию доступа к API.

После подтверждения Укрпочта отправит ключи на вашу электронную почту. Скопируйте из письма User Token и Authorization Bearer.

Установите приложение Ukrposhta

Чтобы начать создавать отправления, установите приложение Ukrposhta в SendPulse и подключите бизнес-аккаунт Укрпочты.

Перейдите в Каталог приложений (App directory) > Приложения (Applications). Найдите Ukrposhta и нажмите Установить (Install). Предоставьте приложению доступ к CRM и нажмите Дать согласие (Grant consent).

Подключите Ukrposhta к аккаунту SendPulse

Перейдите в Мои приложения (My apps) > Установленные (Installed) и выберите Ukrposhta. В поля ввода User Token и Authorization Bearer добавьте ключи API из письма Укрпочты и нажмите Продолжить (Continue).

Настройте интеграцию между SendPulse CRM и Укрпочтой

После подключения настройте данные отправителя, параметры доставки и связь с воронкой CRM.

Данные отправителя

Укажите данные отправителя, которые используются при создании накладных.

Вы можете настроить следующие поля:

Имя контакта (Contact name)

Выберите контакт отправителя из списка.

Населенный пункт (Locality)

Введите название населенного пункта, из которого будет осуществляться отправка. Используйте только буквы кириллицы.

Поиск населенных пунктов выполняется через базу данных Укрпочты.

Место отправления (Place of dispatch)

Выберите адрес отправителя.

Доступны следующие варианты:

Отделение (Branch) — выберите отделение Укрпочты в соответствии с выбранным населенным пунктом.

Адрес (Physical address) — введите адрес улицы, номер дома и квартиры для отправки с адреса.

Данные отправления

Укажите параметры доставки, которые используются как значения по умолчанию при создании накладных.

Вы можете настроить следующие поля:

Плательщик (Payer)	Выберите, кто будет оплачивать доставку товара. Доступны следующие варианты: Получатель (Recipient) оплачивает стоимость доставки посылки. Отправитель (Sender) оплачивает стоимость доставки посылки.
Тип (Type)	Выберите тип доставки в соответствии с содержимым и параметрами посылки. Доступны следующие варианты: Посылки (Parcels) — стандартные отправления небольшого размера и веса. Экспресс (Express) — отправления с приоритетной доставкой. Груз (Cargo) — крупногабаритные и тяжелые отправления. Документы (Documents) — документы, сертификаты, письма и открытки.
Вес (Weight)	Введите фактический вес отправления в килограммах.
Размеры	Введите габариты отправления для расчета объемного веса: Длина (Length), Ширина (Width) и Высота (Height) в сантиметрах.
Описание (Description)	Введите краткое описание содержимого отправления, например, название товара.

Удаление отправления через интеграцию недоступно.

CRM

В поле Статус сделки после создания номера ТТН (Deal stage to assign when waybills are created) выберите воронку CRM и этап сделки, на котором будет создаваться накладная Укрпочты.

Убедитесь, что пользователи, которые будут работать со сделками, имеют доступ к выбранной воронке.

После завершения нажмите Сохранить (Save).

Теперь вы можете создать или добавить отправление Ukrposhta в карточке сделки в CRM.

Основные

При необходимости вы можете ввести другие ключи API. Например, когда подключаете SendPulse CRM к другому бизнес-кабинету Укрпочты.

Нажмите Изменить ключи API (Change API keys). Во всплывающем окне введите новые ключи в поля Bearer авторизация (Authorization Bearer) и Токен пользователя (User Token) и нажмите Сохранить (Save).

Обратите внимание, что после ввода новых ключей API предыдущие настройки интеграции будут сброшены. Перед сохранением настройте их повторно.

Управляйте приложением

Чтобы просмотреть или изменить настройки интеграции, перейдите в раздел Мои приложения (My apps) > Установленные (Installed) и выберите Ukrposhta.

Чтобы подключить другой бизнес-аккаунт Укрпочты, замените ключи API на вкладке Основные (General).

Чтобы удалить приложение, в списке установленных приложений нажмите три точки рядом с Ukrposhta и выберите Удалить (Delete).