# Pipedrive

Подключите Pipedrive, чтобы агент узнавал звонящих по телефону, создавал контакты и сделки и записывал каждый звонок заметкой

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

Pipedrive подключается с помощью личного API-токена. После подключения агент обращается к знакомым клиентам по имени, зная их последнюю сделку, создаёт контакт и сделку, когда клиент оставляет заявку, и записывает итог каждого звонка в карточку клиента.

## Что умеет агент [#what-the-assistant-can-do]

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

## Перед началом [#before-you-start]

* **Пользователь Pipedrive**, чьи права охватывают сделки, которые агент должен видеть и создавать, — токен действует от имени этого пользователя.
* **Воркспейс HAPP** хотя бы с одним агентом.
* **Pipedrive включён для вашего воркспейса** — интеграция включается для каждой компании отдельно. Попросите поддержку HAPP её включить.

## Получение API-токена [#get-the-api-token]

1. В Pipedrive нажмите на аватар и откройте **Personal preferences > API**.
2. Скопируйте **Ваш личный API-токен**.

## Подключение [#connect]

1. В HAPP откройте **Интеграции** и найдите Pipedrive в разделе **Добавить CRM**.
2. Нажмите **Подключить**, вставьте токен и подтвердите.
3. Pipedrive появится в **Моих интеграциях** с названием вашей компании.

## Настройки [#settings]

Нажмите на шестерёнку на карточке во вкладке **Интеграции** агента.

* **Поиск** — узнавать звонящего по телефону.
* **Создание** — создавать сделки. Выберите **воронку**, **этап** и **ответственного**; без них сделка попадёт в воронку по умолчанию. Без ответственного сделки принадлежат пользователю токена.
* **Заметки о звонках** — добавлять заметку после каждого звонка. **Полная расшифровка** добавляет текст разговора.

## Ограничения [#limits]

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

## Решение проблем [#troubleshooting]

| Проблема                                                                 | Причина                                                    | Что делать                                                  |
| ------------------------------------------------------------------------ | ---------------------------------------------------------- | ----------------------------------------------------------- |
| «Pipedrive rejected the API token»                                       | Токен перевыпустили или пользователя деактивировали        | Скопируйте актуальный токен и снова нажмите **Подключить**. |
| «The Pipedrive user behind this token has no permission for this action» | Пользователь не видит эти сделки или не может их создавать | Используйте токен пользователя с нужными правами видимости. |
| «Pipedrive rate limit reached»                                           | Слишком много запросов одновременно                        | Ничего делать не нужно — следующий запрос пройдёт.          |

## Отключение [#disconnect]

Отключите карточку в HAPP. Чтобы полностью отозвать доступ, перевыпустите API-токен в **Personal preferences > API**. Контакты, сделки и заметки, которые уже есть в Pipedrive, останутся.

## Дальше [#next]

* [CRM](/docs/integrations/crm) — все CRM-интеграции
* [Инструменты](/docs/agents/tools) — что агент вызывает во время разговора