Інтеграція 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"