Интеграция Zoho CRM

Обзор

Интеграция Zoho CRM позволяет агенту создавать и управлять лидами, сделками и контактами прямо в вашем аккаунте Zoho CRM. Это даёт AI-ассистенту возможность выполнять CRM-операции без участия человека, оптимизируя продажи и работу с клиентами.

Создание приложения в Zoho

1. Войдите как администратор и перейдите в Zoho Developer Console на api-console.zoho.eu
2. Нажмите Add Client
3. Выберите Server-based Applications

4. Заполните: Client Name = MyChatBot Integration; Homepage URL = https://app.mychatbot.app; Authorized Redirect URIs = https://app.mychatbot.app/integration; Description = AI assistant integration for Zoho CRM

5. Нажмите Create, чтобы сгенерировать учётные данные
6. Скопируйте Client ID и Client Secret
7. Отметьте чекбокс для разрешения Multi-DC

Создание интеграции в MyChatBot

1. Перейдите на вкладку Integrations в кабинете
2. Выберите агента для подключения к Zoho CRM

3. Прокрутите до Zoho CRM в списке интеграций
4. Нажмите Connect
5. Укажите Client ID, Client Secret, Access Token и Refresh Token

6. Нажмите Submit, чтобы сохранить интеграцию

Настройка сущностей и полей данных

После подключения настройте, к каким сущностям и полям будет иметь доступ агент:

Включите Use Leads и Use Deals. Для каждой сущности выберите стандартные поля Zoho и кастомные поля, затем нажмите Apply fields.

Типы сущностей: Leads, Deals, Contacts. Типы полей: Standard и Custom. Специальные поля: Lead_Status/Status (значения «New», «Contacted», «Qualified»; должен совпадать с Zoho), Lead_Source/Source (автоматически «AI-» + имя ассистента), Description/Chat Link (автоматическая ссылка на разговор), Closing_Date (обязательно для сделок; корректный формат даты). Кастомные поля: если кастомное поле не существует, система попробует его создать (лимит 10 на модуль); поддерживаемые типы, текст (до 150 символов), дата, число, choice/dropdown.

Доступные инструменты

После подключения агент получает четыре инструмента:

1. create_crm_lead, создаёт лидов (full_name обязательно, phone, Status/Lead_Status, кастомные поля). Source идентифицирует AI, добавляется chat link, контакт привязывается, если найдено совпадение по телефону.

2. edit_crm_lead, обновляет существующих лидов (full_name, phone, Status/Lead_Status, кастомные поля).

3. create_crm_deal, создаёт сделки с контактами (full_name обязательно, phone обязательно, Closing_Date обязательно, Amount, кастомные поля). Контакт и аккаунт автоматически создаются/находятся, source устанавливается, добавляется chat link, существующий лид обновляется при необходимости.

4. add_crm_client_contact, добавляет контактные данные (full_name обязательно, phone обязательно), полезно для сбора данных до создания лида/сделки.

Настройка в инструкциях агента

Создание лидов:

When a new customer contacts us, use create_crm_lead in Zoho with:
- Their full name
- Phone number
- Set status to "New"
- Add any additional information they provide to custom fields

Создание сделок:

When a customer is ready to make a purchase:
1. Use create_crm_deal with their contact information
2. Include their full name and phone number
3. Set the продажу date to 7 days from today
4. Add the deal amount based on their product selection

Лучшие практики и устранение проблем

Лучшие практики: проводите лидов по воронке логично (New → Contacted → Qualified); собирайте полные контактные данные, потребности и тайминг; создавайте сделки, когда намерение купить очевидно и обсуждена цена; используйте кастомные поля для отраслевой информации, предпочтений, спецтребований и источника реферала.

Устранение проблем: Аутентификация, держите access/refresh токены актуальными, перегенерируйте в Zoho при сбое. Лимит полей, при достижении 10 полей приоритизируйте важнейшие. Маппинг данных, названия полей должны точно совпадать (с учётом регистра). Формат даты, используйте YYYY-MM-DD для Closing_Date.