# Pipedrive

Підключіть Pipedrive, щоб асистент упізнавав клієнтів за телефоном, створював контакти й угоди та записував кожен дзвінок нотаткою

> Full REST + WebSocket API reference: https://api.happ.tools/reference

Pipedrive підключається за вашим особистим API-токеном. Після підключення асистент звертається до знайомих клієнтів на ім'я і знає їхню останню угоду, створює контакт і угоду, коли клієнт залишає заявку, і записує підсумок кожного дзвінка в картку клієнта.

## Що вміє асистент [#що-вміє-асистент]

* **Упізнає клієнта** — на початку дзвінка шукає номер у Pipedrive і отримує ім'я, email, організацію та останню угоду контакту (назва, етап, сума).
* **Створює угоду** — знаходить контакт за телефоном або створює новий і створює угоду у вибраній воронці та на вибраному етапі. Запит, адреса доставки, товари та реклама, з якої прийшов клієнт, додаються до угоди нотаткою.
* **Записує дзвінки** — після кожного дзвінка додає нотатку до контакту та його угоди: напрямок, тривалість, результат, резюме, посилання на запис і, за бажанням, повну розшифровку.

## Перед початком [#перед-початком]

* **Користувач Pipedrive**, чиї права охоплюють угоди, які асистент має бачити й створювати, — токен діє від імені цього користувача.
* **Робочий простір HAPP** щонайменше з одним асистентом.
* **Pipedrive увімкнено для вашого простору** — інтеграція вмикається для кожної компанії окремо. Зверніться до підтримки HAPP.

## Отримайте API-токен [#отримайте-api-токен]

1. У Pipedrive натисніть на аватар і відкрийте **Personal preferences > API**.
2. Скопіюйте **Your personal API token**.

## Підключення [#підключення]

1. У HAPP відкрийте **Інтеграції** і знайдіть Pipedrive у розділі **Додати CRM**.
2. Натисніть **Підключити**, вставте токен і підтвердьте.
3. Pipedrive з'явиться в **Моїх інтеграціях** з назвою вашої компанії.

## Налаштування [#налаштування]

Відкрийте шестерню на картці у вкладці **Інтеграції** асистента.

* **Пошук** — упізнавати клієнта за телефоном.
* **Створення** — угоди. Виберіть **воронку**, **етап** і **відповідального**; без них угода потрапить у воронку за замовчуванням. Без відповідального угоди належать власнику токена.
* **Нотатки про дзвінки** — нотатка після кожного дзвінка. **Повна розшифровка** додає текст розмови.

## Обмеження [#обмеження]

* Pipedrive зберігає телефон так, як його ввели; асистент порівнює останні 9 цифр, тож `050 111 22 33` і `+380501112233` — той самий клієнт.
* Для номера, якого немає в Pipedrive, нотатка про дзвінок не створюється — її нема до чого прив'язати.
* Токен особистий: якщо цього користувача деактивують, інтеграція перестане працювати.

## Вирішення проблем [#вирішення-проблем]

| Проблема                                                                 | Причина                                              | Що робити                                                      |
| ------------------------------------------------------------------------ | ---------------------------------------------------- | -------------------------------------------------------------- |
| «Pipedrive rejected the API token»                                       | Токен перевипустили або користувача деактивували     | Скопіюйте актуальний токен і натисніть **Підключити** ще раз.  |
| «The Pipedrive user behind this token has no permission for this action» | Користувач не бачить або не може створювати ці угоди | Використайте токен користувача з потрібними правами видимості. |
| «Pipedrive rate limit reached»                                           | Забагато запитів одночасно                           | Нічого робити не треба — наступний запит пройде.               |

## Відключення [#відключення]

Відключіть картку в HAPP. Щоб повністю відкликати доступ, перевипустіть API-токен у **Personal preferences > API**. Контакти, угоди й нотатки, що вже є в Pipedrive, залишаться.

## Далі [#далі]

* [CRM](/docs/integrations/crm) — усі CRM-інтеграції
* [Інструменти](/docs/agents/tools) — що асистент викликає під час розмови