Подключение WhatsApp к Pipedrive на номере с Coexistence

Как сообщение WhatsApp попадает к контакту в Pipedrive?

Meta отправляет каждое сообщение номера на адрес вебхука, который вы для него указали, в нашем случае это узел Webhook в n8n. Рабочий процесс ищет контакт в Pipedrive по номеру отправителя: поиск по контактам охватывает поле телефона и поддерживает флаг точного совпадения. Если контакт найден, процесс берёт его id. Если нет, он создаёт контакт с именем профиля WhatsApp и номером, а затем лид, связанный с ним. Так первое сообщение от незнакомого человека появляется в Leads Inbox, и кто-то из команды может его квалифицировать.

Само сообщение становится заметкой. Для заметки в Pipedrive нужно только содержимое (оно допускает HTML) и хотя бы один id: контакта, сделки, организации или лида. Если есть открытая сделка, прикрепите заметку к ней, в остальных случаях к контакту.

Почему в лимиты сначала упирается шаг поиска?

Потому что у поиска в Pipedrive отдельная и гораздо меньшая квота. Обычные вызовы API ограничены на каждого пользователя в скользящем окне из двух секунд: от 20 запросов на Lite с токеном API до 120 на Ultimate. Search API на любом тарифе ограничен 10 запросами за две секунды.

На спокойном номере это незаметно. Но если номер рассылает шаблон нескольким сотням клиентов и за минуту получает пятьдесят ответов, лимит будет превышен, потому что каждый ответ начинается с поиска. Тогда рабочий процесс получает ответы 429 и без повторной попытки теряет заметку.

Проблему решают две вещи. Включите повторные попытки с паузой на узле поиска Pipedrive и кэшируйте соответствие «телефон и id контакта» в статических данных рабочего процесса n8n или в небольшой таблице. Тогда клиент, написавший шесть сообщений подряд, обойдётся в один поиск, а не в шесть.

Можно ли записывать и ответы, набранные на телефоне?

Да. Coexistence сохраняет работу приложения WhatsApp Business на том же номере, и когда сотрудник отвечает из него, Meta отправляет эхо исходящего сообщения на тот же адрес вебхука в поле smb_message_echoes.

Добавьте ветку для этих эхо-сообщений и записывайте их как заметки с пометкой «исходящее» или как выполненные активности, если ваша команда отчитывается по числу активностей. Менеджер, открывший сделку, увидит по порядку, о чём спросил клиент и что ответил магазин.

Если сообщение отправляет сам рабочий процесс, например шаблон при переходе сделки на другой этап, записывайте заметку в момент отправки. Текст и id сделки у процесса уже есть, так что ждать вебхук незачем.

Как нормализовать номер телефона?

Приведите его к цифрам с кодом страны и ничего больше, потому что именно в таком виде номер присылает Meta. Отправитель приходит как 14155550188, а контакт, введённый в Pipedrive вручную, может выглядеть как +1 (415) 555-0188.

Когда рабочий процесс создаёт контакт, сохраняйте номер именно в таком виде, только цифры, чтобы его собственные записи всегда совпадали. Для контактов, созданных вручную, разовая чистка в n8n, которая переписывает существующие телефоны в тот же формат, окупается уже в первую неделю. Без неё поиск по точному совпадению пропускает людей, внесённых командой, и процесс создаёт дубликат для каждого из них.

Если команде удобнее читать номер в исходном формате, сохраните его вторым телефоном. У контакта в Pipedrive может быть несколько телефонов.

Распространённые ошибки

• Один поиск на каждое сообщение без кэша. Всплески ответов упираются в лимит Search API в 10 запросов за две секунды, и заметки теряются.
• Создание лида на каждое сообщение, а не на каждого нового контакта. Leads Inbox заполняется копиями одного и того же клиента.
• Прикрепление заметок только к контакту, когда открыта сделка. Менеджер, который ведёт сделку, не видит переписку.

Часто задаваемые вопросы

Читайте дальше