Соңғы жылдары жасанды интеллект (AI) технологияларын қолданатын чат-боттар бизнес процестерінің маңызды бөлігіне айналды. Олардың сыртқы жүйелермен, мысалы, CRM және API-мен интеграциялануы компанияларға жаңа мүмкіндіктерді ашады: автоматтандыруды, клиенттермен өзара әрекеттесуді жақсартуды және процестердің тиімділігін арттыруды қамтамасыз етеді.
Осы мақалада біз Bitrix24 жүйесіне интеграциялау процесін толық қарастырамыз, API арқылы чат-боттың қалай жұмыс істейтінін көрсетеміз. Біз код мысалдарын келтіріп, осындай интеграцияның артықшылықтарын түсіндіреміз.
1. Bitrix24 API негіздері
Bitrix24 сыртқы жүйелермен интеграциялануға және бизнес процестерін автоматтандыруға мүмкіндік беретін қуатты API ұсынады. Bitrix24 API көптеген CRM элементтерімен жұмыс істеуге мүмкіндік береді, соның ішінде мәмілелер, лида, байланыстар, компаниялар және тапсырмалар. API Bitrix24-пен жұмыс істеу үшін webhook немесе OAuth кілтін алуға болады.
Webhooks — бұл сыртқы қызметтерге Bitrix24 жүйесіне деректерді жіберуге мүмкіндік беретін URL мекенжайлары. OAuth аутентификациясы мен авторизациясын қажет ететін күрделі сценарийлер үшін қолданылады.
2. AI чат-ботын Bitrix24-ке интеграциялау қадамдары
2.1. Bitrix24 API үшін вебхук жасау
AI чат-ботын Bitrix24-пен интеграциялаудың алғашқы қадамы вебхук жасау болып табылады. Бұл үшін келесі әрекеттерді орындау қажет:
-
Bitrix24 есептік жазбаңызға кіріңіз.
-
Параметрлер → Интеграциялар → Webhooks бөліміне өтіңіз.
-
Вебхук қосу батырмасын басып, қажетті құқықтарды таңдаңыз. Мысалы, CRM элементтерімен жұмыс істеу үшін "Оқу және жазу" құқықтары қажет.
-
Алынған вебхук URL мекенжайын көшіріңіз — бұл чат-бот үшін қолжетімділік нүктесі болады.
2.2. Bitrix24 API-мен жұмыс істеу үшін кодты дайындау
Енді вебхук бар болған соң, біз HTTP сұраныстарын жіберу арқылы Bitrix24 API-пен жұмыс істей аламыз. Бұл жерде Python тілінде код мысалын келтіреміз, онда біз CRM жүйесінде "Лидтер" элементімен жұмыс істейміз. Бұл бастапқы клиентпен байланыс үшін жиі пайдаланылады.
Алдымен, requests кітапханасын орнатамыз, ол HTTP сұраныстарын жіберуге көмектеседі.
pip install requests
Енді Bitrix24-ке әрекет жасайтын қарапайым Python скриптін құрайық. Біз жаңа лид жасаймыз:
import requests
# Bitrix24 вебхук URL
webhook_url = "https://your_bitrix24_domain.bitrix24.ru/rest/1/your_webhook_key/crm.lead.add.json"
# Bitrix24-ке жіберілетін деректер
lead_data = {
"fields": {
"TITLE": "Жаңа лид сайттан",
"NAME": "Иван",
"LAST_NAME": "Иванов",
"PHONE": [{"VALUE": "+79991234567", "VALUE_TYPE": "WORK"}],
"EMAIL": [{"VALUE": "Бұл электронды пошта мекен-жайы спам-боттардан қорғалған, оны қарау үшін Сізде Javascript қосылған. ", "VALUE_TYPE": "WORK"}],
"STATUS_ID": "NEW"
}
}
# Лидті қосу үшін сұраныс жіберу
response = requests.post(webhook_url, json=lead_data)
# Жауапты тексеру
if response.status_code == 200:
print("Лид сәтті қосылды!")
else:
print(f"Лидті қосуда қате орын алды: {response.text}")
Бұл мысалда біз Bitrix24-ке жаңа лид қосамыз, оған клиенттің аты, телефоны, электрондық поштасы және статусы енгізіледі. Егер сұраныс сәтті болса, бот лидтің қосылғанын хабарлайды.
2.3. AI чат-ботымен интеграциялау
AI чат-ботын Bitrix24-пен интеграциялау үшін жүйе нақты уақытта клиент туралы деректерді CRM-ге жіберетін механизмді жасау қажет. Мысалы, біздің чат-бот пайдаланушыдан мәлімет жинап, кейін осы мәліметтерді Bitrix24 жүйесіне API арқылы жібереді.
Dialogflow платформасын пайдаланып интеграцияның мысалын қарастырайық. Бұл бот жүйесі қолданушының сұрақтарын өңдеуге және олардың деректерін Bitrix24 жүйесіне жіберуге көмектеседі.
-
Dialogflow орнату: Dialogflow агентін жасап, сұрау мәндерімен жұмыс істейтін Intent (ниеттер) конфигурациясын жасаңыз. Мысалы, "Мен CRM-ге тіркелгім келеді", "Менің мәліметтерімді жіберіңіз" сияқты сұраулар болуы мүмкін.
-
Dialogflow үшін вебхук: Dialogflow-дан деректерді алу үшін вебхук пайдалануға болады. Пайдаланушы мәліметтерін енгізгенде, Dialogflow оларды серверге жібереді, ал сервер оларды Bitrix24-ке бағыттайды.
Flask арқылы қарапайым Python серверін іске қосып, Dialogflow-тан алынған деректерді Bitrix24 жүйесіне жіберуге болады:
from flask import Flask, request, jsonify
import requests
app = Flask(__name__)
# Bitrix24 вебхук URL
webhook_url = "https://your_bitrix24_domain.bitrix24.ru/rest/1/your_webhook_key/crm.lead.add.json"
, methods=['POST'])
def dialogflow_webhook():
data = request.get_json()
# Пайдаланушыдан алынған мәліметтер
user_name = data['queryResult']['parameters']['name']
user_phone = data['queryResult']['parameters']['phone']
user_email = data['queryResult']['parameters']['email']
# Bitrix24-ке лид қосу үшін деректер
lead_data = {
"fields": {
"TITLE": f"Жаңа лид {user_name} атынан",
"NAME": user_name,
"PHONE": [{"VALUE": user_phone, "VALUE_TYPE": "WORK"}],
"EMAIL": [{"VALUE": user_email, "VALUE_TYPE": "WORK"}],
"STATUS_ID": "NEW"
}
}
# Лид қосу сұранысы
response = requests.post(webhook_url, json=lead_data)
if response.status_code == 200:
return jsonify({"fulfillmentText": "Сіздің деректеріңіз CRM жүйесіне сәтті жіберілді!"})
else:
return jsonify({"fulfillmentText": "Сіздің деректеріңізді жіберуде қате пайда болды."})
if __name__ == '__main__':
app.run(debug=True)
Бұл код Flask серверін іске қосып, Dialogflow-тан алынған деректерді өңдеп, оларды Bitrix24 жүйесіне жібереді.
2.4. Bot Framework пайдалану мысалы
Егер сіз Microsoft Bot Framework немесе ұқсас платформаны пайдалансаңыз, Bitrix24-ке API арқылы интеграциялауды жүзеге асыра аласыз. C# тілінде Bot Framework арқылы Bitrix24-ке лид қосу мысалы:
using System.Net.Http;
using System.Text;
using Newtonsoft.Json;
public async Task AddLeadToBitrix24(string name, string phone, string email)
{
var client = new HttpClient();
var webhookUrl = "https://your_bitrix24_domain.bitrix24.ru/rest/1/your_webhook_key/crm.lead.add.json";
var leadData = new
{
fields = new
{
TITLE = "Жаңа лид",
NAME = name,
PHONE = new[] { new { VALUE = phone, VALUE_TYPE = "WORK" } },
EMAIL = new[] { new { VALUE = email, VALUE_TYPE = "WORK" } },
STATUS_ID = "NEW"
}
};
var jsonContent = JsonConvert.SerializeObject(leadData);
var content = new StringContent(jsonContent, Encoding.UTF8, "application/json");
var response = await client.PostAsync(webhookUrl, content);
if (response.IsSuccessStatusCode)
{
Console.WriteLine("Лид сәтті қосылды.");
}
else
{
Console.WriteLine($"Қате: {response.StatusCode}");
}
}
3. Қорытынды
AI чат-боттарын CRM жүйелерімен, мысалы, Bitrix24-пен интеграциялау бизнес процестерін автоматтандыруға үлкен мүмкіндіктер ашады. API және webhook арқылы біз лидтерді жасау, клиенттер туралы ақпаратты жаңарту және жеке қызмет көрсету сценарийлерін жүзеге асыра аламыз.
Код мысалдары Python, Flask және Bot Framework сияқты танымал платформаларды пайдаланып, интеграция процесін көрсетеді. Әрбір интеграцияны орнату кезінде қауіпсіздік параметрлерін, қателерді өңдеуді және жүйенің тұрақтылығын бақылау маңызды.
