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

Как сообщение WhatsApp превращается в запись Zoho CRM?

Meta отправляет каждое сообщение номера на заданный вами адрес вебхука, здесь это узел Webhook в n8n. Рабочий процесс берёт номер отправителя из тела запроса и вызывает эндпоинт поиска Zoho с phone, равным этому номеру: сначала по Leads, затем по Contacts. Zoho проверяет все поля телефона в модуле, поэтому совпадение и по Mobile, и по Phone засчитывается, и вам не нужно гадать, каким полем пользовался менеджер.

Если ничего не найдено, узел Zoho CRM в n8n создаёт лид с именем профиля WhatsApp и номером. В любом случае у рабочего процесса теперь есть id записи, и он записывает сообщение заметкой к этой записи через POST /Notes. Заметке нужны только Note_Content и Parent_Id с указанием модуля и записи.

{
  "data": [
    {
      "Note_Title": "WhatsApp, inbound",
      "Note_Content": "do you have anything friday?",
      "Parent_Id": {
        "module": { "api_name": "Leads" },
        "id": "4876876000000624001"
      }
    }
  ]
}

Какие разрешения Zoho нужны учётным данным n8n?

Чтение и создание в модулях, по которым вы ищете и в которые пишете, плюс создание в Notes. Zoho называет область доступа для заметок ZohoCRM.modules.notes.CREATE и требует рядом с ней область создания родительского модуля, поэтому учётные данные, которые могут создавать лиды, но не получили область для заметок, на последнем шаге падают с ошибкой авторизации.

Узел Zoho CRM в n8n охватывает Leads, Contacts, Accounts, Deals и несколько торговых документов, с операциями create, upsert, get, get all, update и delete. Заметок среди его ресурсов нет, поэтому заметка идёт через узел HTTP Request. n8n позволяет этому узлу использовать уже подключённые учётные данные Zoho, так что управлять нужно одним доступом OAuth, а не двумя.

Укажите домен API вашего центра данных Zoho. Учётные данные, созданные в регионе EU, обращаются к zohoapis.eu, а не к zohoapis.com.

Сколько сообщений выдержит Zoho CRM?

Zoho считает вызовы API в кредитах за скользящие 24 часа, и бюджет зависит от редакции и числа пользователей. Free получает 5 000. Standard: 50 000 плюс 250 на пользователя, Professional: 50 000 плюс 500 на пользователя, Enterprise: 50 000 плюс 1 000 на пользователя, у каждой редакции есть свой потолок.

Каждое входящее сообщение стоит одного поиска и одной записи заметки, плюс создание лида для тех, кто пишет впервые. Для номера небольшого бизнеса это с запасом укладывается в бюджет платной редакции. Первым обычно упирается не он, а параллелизм: Free допускает 5 одновременных вызовов, Standard 10, поэтому всплеск ответов на рассылку может встать в очередь. Если Zoho возвращает ошибки ограничения, настройте рабочий процесс n8n на последовательную обработку запусков.

Попадают ли ответы, отправленные с телефона, в Zoho CRM?

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

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

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

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

• Выдать учётным данным области для лидов, но не ZohoCRM.modules.notes.CREATE. Поиск и лид работают, а затем каждая заметка завершается ошибкой.
• Обращаться к zohoapis.com из аккаунта в другом центре данных Zoho. Используйте домен API того региона, где находится аккаунт.
• Искать только среди Leads. Клиенты после конверсии хранятся как Contacts, и каждый из них при обращении превращается в новый дубль лида.

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

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