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

Обзор

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

Создание Connected App в Salesforce

1. Войдите как администратор
2. Перейдите в Setup > App Manager

3. Нажмите New Connected App
4. Заполните: Connected App Name = MyChatBot Integration; API Name = MyChatBot_Integration_API; Contact Email; отметьте Enable OAuth Settings; Callback URL = https://app.mychatbot.app и https://app.mychatbot.app/integration

Выберите OAuth scopes: Access and manage your data (api) и Perform requests at any time (refresh_token, offline_access).

5. Нажмите Save и дождитесь создания приложения
6. Нажмите Manage Consumer Details
7. Запишите Consumer Key (Client ID) и Consumer Secret (Client Secret)

8. Для безопасности установите IP relaxation на "Relax IP restrictions" и отметьте Enable Token Exchange Flow

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

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

3. Прокрутите до Salesforce CRM в списке интеграций
4. Нажмите Connect
5. Укажите Domain (напр. your-company.my.salesforce.com), Client ID (Consumer Key) и Client Secret (Consumer Secret)

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

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

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

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

Типы сущностей: Leads, Deals (в Salesforce, Orders), Contacts, Accounts. Типы полей: Standard и Custom. Специальные поля: Status (значения «New», «Working», «Qualified», «Converted»; должен совпадать с Salesforce), LeadSource (автоматически «AI-» + имя ассистента), Order Start Date (обязательно при создании сделки/заказа), Products (для создания сделки; каждый требует name, quantity, опционально price). Товары: добавляются через параметр products в create_crm_deal, каждый требует name (обязательно), quantity (обязательно), price (опционально, иначе стандартная цена). Товары должны уже существовать в Pricebook Salesforce.

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

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

1. create_crm_lead, создаёт лидов (full_name, phone, Status, кастомные поля). Контакт и аккаунт автоматически создаются/находятся по имени и телефону, лид привязывается, source идентифицирует AI.

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

3. create_crm_deal, создаёт сделки/заказы (full_name обязательно, phone обязательно, Order Start Date обязательно, Status по умолчанию «Draft», products [name, quantity, price], кастомные поля). Контакт и аккаунт автоматически создаются/находятся, товары добавляются, если есть в Pricebook.

4. add_crm_client_contact, создаёт/обновляет контакты (full_name обязательно, phone обязательно). Обновляет существующего лида и создаёт новую запись контакта.

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

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

When a customer confirms a purchase intention, use create_crm_deal in Salesforce:
- Use their full name
- Include their phone number
- Set Order Start Date to today's date in format YYYY-MM-DD
- Add products they're interested in:
  [ { "name": "Product Name", "quantity": 1, "price": 99.99 } ]
- Set Status to "Draft"

Обновление статуса лида:

When a customer requests a call back:
1. Use edit_crm_lead to update the lead status to "Working"

When a customer confirms interest:
1. Use edit_crm_lead to update the lead status to "Qualified"