Негізгі мазмұнға өту
DocumentationAPI ReferenceVideo Tutorials

Интеграциялар

Интеграциялар дауыстық агенттеріңізді сыртқы қызметтерге қосу арқылы кеңейтеді. Бұл бөлімде барлық қолжетімді интеграциялар және оларды қалай теңшеу қамтылған.

Қолжетімді интеграциялар​

ИнтеграцияМақсатыКүйіТарифтер
Phone NumbersТелефон нөмірлері мен қоңырауларҚолжетімдіБарлығы
SIP TrunkӨз операторыңызды алып келіңіз (sipgate, Placetel, TENIOS, easybell, Zadarma, Twilio BYO, Telnyx, Custom)ҚолжетімдіБарлығы — сәйкестік мақұлдауын қажет етеді
Google CalendarGoogle арқылы кездесулерді жоспарлауҚолжетімдіБарлығы
Outlook CalendarMicrosoft Outlook арқылы кездесулерді жоспарлауҚолжетімдіБарлығы
eTerminҚолжетімділікті тексеру және кездесулерді тікелей брондау/қайта жоспарлау/болдырмау — eTermin қараңызҚолжетімдіБарлығы
resmioРесторан үстелдерін брондау кітапшаңызға тікелей брондау — resmio қараңызҚолжетімдіБарлығы
HubSpot CRMДауыстық агентіңізден контактілер мен мәмілелерді оқу/жазуҚолжетімдіБарлығы
MCP serversӨз MCP-үйлесімді құрал серверіңізді алып келіп, оның құралдарын агенттерге ашыңыз — MCP серверлері қараңызҚолжетімдіБарлығы
API KeysСыртқы қолданбаға қол жеткізуҚолжетімдіБарлығы
WebhooksНақты уақыттағы оқиға хабарламаларыҚолжетімдіБарлығы
Барлық тарифтер

Күнтізбе интеграциялары, SIP, HubSpot, MCP серверлері, API-ге қол жеткізу және веб-хуктар барлық тарифтерде, соның ішінде Free-де қолжетімді. SIP trunking қосылым шебері ашылмас бұрын бір реттік сәйкестік мақұлдауын қажет етеді.

Телефон нөмірін орнату​

Телефон нөмірлері агенттеріңізге нақты телефон қоңырауларын қабылдауға және шалуға мүмкіндік береді.

Орнату қадамдары​

  1. Бүйір тақтадағы Phone Numbers бөліміне өтіңіз
  2. "Buy Number" түймесін басыңыз
  3. Елді және нөмір түрін таңдаңыз
  4. Сатып алуды аяқтаңыз
  5. Нөмірге агент тағайындаңыз

Нөмірлер сатып алғаннан кейін автоматты түрде теңшеледі және пайдалануға дайын болады.

SIP Trunk интеграциясы​

Өз SIP операторыңызды алып келіңіз — HANC SIP-ты табиғи түрде түсінеді және кіріс қоңырауларды дауыстық агентіңізге бағыттайды (және шығыс қоңырауларды сіздің trunk арқылы қайтарады). Бір реттік сәйкестік мақұлдауынан кейін Free-ді қоса алғанда барлық тарифтерде қолжетімді.

Қолдау көрсетілетін операторлар​

HANC-та төмендегі операторлар үшін бапталған адаптерлер, сондай-ақ басқа кез келгені үшін жалпы опция бар:

ОператорAPI арқылы нөмірлерді авто-импорттауЕскертпелер
sipgateИә (Personal Access Token)ЕО SIP trunking
PlacetelҚолменНеміс VoIP, Webportal тіркелгі деректері
TENIOSҚолменЕуропалық SIP
easybellҚолменНеміс операторы, Kundencenter тіркелгі деректері
ZadarmaИә (қосымша API кілт)Ғаламдық нөмірлер
Twilio (BYO)ИәAccount SID + Auth Token
TelnyxИәAPI-мен басқарылатын SIP және DID
Custom SIP trunkҚолменКез келген басқа провайдер — host, port, transport беріңіз

Сәйкестік мақұлдауы​

SIP оператор қосылымдары шығыс науқандармен бірдей сәйкестік ағынын пайдаланады. Аккаунтыңыз мақұлданғанша, Connect SIP түймесі барлық қолдау көрсетілетін операторларды mailto:support@hanc.ai CTA-мен тізетін көрсетілім модальды терезесін ашады. Мақұлдау әдетте сол жұмыс күні ішінде жасалады.

Орнату қадамдары (мақұлдаудан кейін)​

  1. Phone Numbers → Connect SIP бөліміне өтіңіз.
  2. Операторыңызды таңдаңыз.
  3. SIP тіркелгі деректерін енгізіңіз (және операторыңыз авто-импорттауды қолдаса, қосымша API кілт/құпия).
  4. Custom SIP үшін host, port (әдепкі 5060) және transport (UDP / TCP / TLS) де беріңіз.
  5. Connect түймесін басыңыз — HANC сіздің SIP пайдаланушыңызды тіркейді және қолдау көрсетілген жерде телефон нөмірлеріңізді тізеді.
  6. Импорттайтын нөмірлерді таңдаңыз (немесе E.164 арқылы қолмен қосыңыз).
  7. Әр нөмірге кіріс және/немесе шығыс агентін тағайындаңыз.

SIP пайдалану мен нөмір сатып алудың арасында қашан таңдау керек​

СценарийҰсыныс
Телефон қызметінде жаңаHANC арқылы нөмірлер сатып алыңыз (қарапайымырақ — сәйкестік қадамы жоқ)
Бар PBX немесе оператор келісімшартыSIP арқылы қосылыңыз — нөміріңізді сақтаңыз
Қатаң оператор талаптары бар кәсіпорын телефониясыТолық бақылау үшін SIP
Бірнеше аймақ / нөмір пулдарыИкемділік үшін SIP

Google Calendar интеграциясы​

Дауыстық агенттеріңізге қоңыраулар кезінде қолжетімділікті тексеруге және кездесулерді брондауға мүмкіндік беру үшін Google Calendar-ды қосыңыз.

Орнату қадамдары​

  1. Integration → Calendars бөліміне өтіңіз
  2. "Connect Google Calendar" түймесін басыңыз
  3. Google арқылы кіріңіз
  4. Hanc.AI қол жеткізуін авторизациялаңыз

Сұралатын рұқсаттар:

  • Күнтізбе оқиғаларын көру (қолжетімділікті тексеру үшін)
  • Күнтізбе оқиғаларын жасау (кездесулерді брондау үшін)

Күнтізбені теңшеу​

Қосылғаннан кейін агентіңізде күнтізбе құралын теңшеңіз:

ПараметрСипаттама
calendar_idЖоспарлау үшін қай Google Calendar пайдаланылатыны
timezoneКездесулерді жоспарлауға арналған уақыт белдеуі (мысалы, Europe/Vienna)
work_hoursБрондауға қолжетімді сағаттар (мысалы, дүйсенбі-жұма 9:00-18:00)
slot_durationКездесудің әдепкі ұзақтығы (мысалы, 30 минут)
bufferКездесулер арасындағы буфер уақыты (мысалы, 15 минут)

Агенттердегі күнтізбені пайдалану​

Қосылып, теңшелгеннен кейін агенттер мыналарды істей алады:

  • Нақты күндер мен уақыттар үшін қолжетімділікті тексеру
  • Кездесулерді автоматты түрде брондау
  • Жұмыс уақыттары мен буфер уақыттарын сақтау
  • Қайта жоспарлау сұрауларын өңдеу

Сұхбат мысалы:

Клиент: "Сейсенбіде сағат 3-ке кездесуге брондай аламын ба?"

Агент: [Күнтізбені тексереді]
       "Иә, сейсенбіде сағат 3 қолжетімді.
        Брондауды аяқтау үшін атыңызды айтасыз ба?"

Outlook Calendar интеграциясы​

Дауыстық агенттеріңіз арқылы кездесулерді жоспарлауды қосу үшін Microsoft Outlook Calendar-ды қосыңыз.

Орнату қадамдары​

  1. Integration → Calendars бөліміне өтіңіз
  2. "Connect Outlook Calendar" түймесін басыңыз
  3. Microsoft аккаунтыңызбен кіріңіз
  4. Hanc.AI қол жеткізуін авторизациялаңыз

Сұралатын рұқсаттар:

  • Күнтізбе оқиғаларын көру (қолжетімділікті тексеру үшін)
  • Күнтізбе оқиғаларын жасау (кездесулерді брондау үшін)

Күнтізбені теңшеу​

Қосылғаннан кейін агентіңізде күнтізбе құралын теңшеңіз:

ПараметрСипаттама
CalendarЖоспарлау үшін қай Outlook күнтізбесі пайдаланылатыны
TimezoneКездесулерді жоспарлауға арналған уақыт белдеуі (мысалы, Europe/Vienna)
Work HoursБрондауға қолжетімді сағаттар (мысалы, дүйсенбі-жұма 9:00-18:00)
Slot DurationКездесудің әдепкі ұзақтығы (мысалы, 30 минут)
BufferКездесулер арасындағы буфер уақыты (мысалы, 15 минут)

Google Calendar-дан айырмашылықтары​

Екі күнтізбе интеграциясы да агент тұрғысынан бірдей жұмыс істейді. Жалғыз айырмашылық — кіру процесі. Өзіңіз бұрыннан пайдаланатын күнтізбе қызметін таңдаңыз.

кеңес

Google және Outlook күнтізбелерін бір уақытта қоса аласыз, бірақ әр агент тек бір күнтізбе құралын пайдалана алады.

Кездесулерді болдырмау​

Кездесу брондаған қоңырау шалушылар болдырмау сілтемесін алады. Олар қайта қоңырау шалудың қажеті жоқ — кездесуін тікелей болдыра алады.

eTermin арқылы кездесу брондау​

Агенттеріңіз қолжетімділікті тексеріп, қоңырау кезінде тікелей кездесулерді брондай, қайта жоспарлай немесе болдыра алуы үшін eTermin-ді қосыңыз — тікелей eTermin күнтізбелеріңіз бен қызметтеріңізге, қосарлы брондаудан кірістірілген қорғанышпен. Кездесулеріңіз бұрыннан eTermin-де болса және сіз өз ұзақтығы мен ережелері бар айрықша қызметтерді ұсынсаңыз, кәдімгі күнтізбенің орнына eTermin пайдаланыңыз.

Қосылу қадамдары, агент бойынша теңшеу және қосарлы брондаудан қорғану үшін толық eTermin бетін қараңыз.

resmio арқылы үстел брондау​

Агенттеріңіз қоңырау кезінде брондау кітапшаңызға тікелей ресторан үстелдерін брондай алуы үшін resmio-ны қосыңыз — уақыт пен адам саны бойынша нақты қолжетімділікті тексеріп, қайта жоспарлау мен болдырмауды өңдей отырып. Егер ресторанңыз резервацияларды бұрыннан ол арқылы қабылдаса, resmio пайдаланыңыз.

Қосылу қадамдары мен мәліметтер үшін толық resmio бетін қараңыз.

Жұмыс ағындарында қосылған аккаунттар арқылы әрекет ету​

Агент тікелей қоңырау кезінде пайдаланатын әрдайым қосулы құралдардан бөлек, жұмыс ағындарында арнайы Integration қадамы бар (v2.8-де қосылды). Жұмыс ағынына Integration қадамын қосып, оны бір қадамда қосылған Google Calendar, Outlook немесе HubSpot аккаунты арқылы әрекет еттіріңіз — мысалы, үлкенірек автоматтандырылған ағынның бөлігі ретінде күнтізбе оқиғасын жасаңыз немесе HubSpot мәмілесін жаңартыңыз. Қадам осы бетте орнатқан сол аккаунт деңгейіндегі қосылымдарды пайдаланады, сондықтан қосымша авторизациялаудың қажеті жоқ.

HubSpot CRM интеграциясы​

Дауыстық агенттеріңіз қоңырау кезінде контактілер мен мәмілелерді оқи және жаза алуы үшін, әрі HANC-тың кірістірілген CRM-і сіздің HubSpot воронкаларыңызды айнадай көрсете алуы үшін HubSpot жұмыс кеңістігіңізді қосыңыз.

Ол нені қосады​

  • Тікелей құрал — HubSpot CRM агенттің Actions қойындысында. Агент қоңырау шалушыны телефон бойынша HubSpot контактісіне сәйкестендіріп, мәміле кезеңін алып, тікелей сұхбаттан қасиеттерді жаңарта алады. Actions & Tools қараңыз.
  • Воронканы айнада көрсету HANC CRM-інде. HubSpot мәмілелеріңіздің кезеңдері Deals канбанында көрінеді, сондықтан қоңыраулар мен HubSpot контекстін қатар көре аласыз.
  • Воронка бойынша AI ауыстырғышы — AI қай HubSpot воронкаларында әрекет ете алатынын шешіңіз; қалғандарының бәрі тек оқу режимінде қалады.

Орнату қадамдары​

  1. Integrations бетін ашып, Connect HubSpot түймесін басыңыз.
  2. HANC-ты HubSpot аккаунтыңызда авторизациялаңыз.
  3. Қай воронкалар айнада көрсетілетінін (CRM → Pipeline параметрлерінде көрінеді) және қайсысы агенттің кезең жаңартуларына рұқсат беретінін таңдаңыз.
  4. Қоңырау кезінде HubSpot-қа тиетін кез келген агентке HubSpot CRM құралын қосыңыз.
кеңес

HANC CRM-ін пайдалану үшін HubSpot қолданудың қажеті жоқ. Кірістірілген CRM өз бетінше жұмыс істейді — HubSpot интеграциясы тек HubSpot-та бұрыннан жұмыс істейтін және екі әлемді синхрондағысы келетін ұйымдарға арналған.

MCP серверлері​

Model Context Protocol (MCP) — AI көмекшілерін сыртқы құралдарға қосуға арналған ашық стандарт. Егер сіз MCP-үйлесімді сервер іске қоссаңыз, оны Integration бетінде бір рет тіркеп, агенттеріңізге оның құралдарын сұхбат ортасында шақыртуға болады.

Орнату қадамдары (шолу)​

  1. Integration → MCP servers бөліміне өтіңіз.
  2. Connect MCP server түймесін басып, белгі мен серверіңіздің HTTPS URL мекенжайын енгізіңіз, аутентификацияны таңдаңыз (None немесе Bearer token) және сақтаңыз.
  3. Құралдарды пайдаланғыңыз келетін агентті ашып, Actions → Add Action → MCP servers бөліміне өтіп, осы агент пайдалануы тиіс қосылымдарды қосыңыз.

Агент әр қоңыраудың басында сервердің құралдарын анықтап, пайдаланады.

Егжей-тегжейлі орнату, ақауларды жою және MCP-нің кірістірілген құралдармен қатар қалай орналасатыны туралы толық MCP серверлері бетін қараңыз.

API Keys​

Hanc.AI-ді өз қолданбаларыңызбен біріктіру үшін API кілттерін жасаңыз.

API кілтін жасау​

Әр пайдаланушыға 3 API кілтіне дейін жасай аласыз.

  1. Integration → API Keys бөліміне өтіңіз
  2. "Create API Key" түймесін басыңыз
  3. Атау енгізіңіз (мысалы, "CRM Integration")
  4. Рұқсаттарды орнатыңыз (read, write, admin)
  5. Кілтті бірден көшіріп алыңыз (тек бір рет көрсетіледі)

API кілтінің қауіпсіздігі​

Маңызды
  • Кілттерді қауіпсіз сақтаңыз (орта айнымалылары, құпиялар менеджері)
  • Кілттерді ешқашан нұсқа бақылауына жүктемеңіз
  • Кілттерді мезгіл-мезгіл ауыстырып отырыңыз
  • Пайдаланылмайтын кілттерді жойыңыз

API кілттерін пайдалану​

API сұрауларына қосыңыз:

curl -X GET "https://api.hanc.ai/v1/agent/list" \
  -H "x-api-key: YOUR_API_KEY"

API кілттерінің рұқсаттары​

РұқсатҚол жеткізу
ReadАгенттерді, қоңырауларды, аналитиканы көру
WriteАгенттерді жасау/өзгерту, KB жүктеу
AdminБарлық операциялар, жою, параметрлер

Қолжетімді эндпоинттер​

Ресурстар бойынша топталған API эндпоинттерінің толық тізімі (Calls, Agents, Knowledge Base, Phone Numbers, Voices, Subscription, Customers, Workspaces) өз бетінде орналасқан:

→ Толық API анықтамасы

Webhooks​

Hanc.AI аккаунтыңыздағы оқиғалар туралы нақты уақыттағы хабарламаларды алу үшін веб-хуктарды теңшеңіз.

Орнату​

  1. Integration → Webhooks бөліміне өтіңіз
  2. Веб-хук эндпоинтіңіздің URL мекенжайын енгізіңіз
  3. Жазылатын оқиғаларды таңдаңыз
  4. Теңшелімді сақтаңыз

Веб-хуктар эндпоинтіңізге оқиға деректерін JSON форматында HTTP POST сұрауларымен жібереді.

Қоңыраудан кейінгі әрекеттер​

Қоңыраудан кейінгі әрекеттер дауыстық агент сұхбаты аяқталғаннан кейін автоматты түрде іске қосылады. Оларды жеке агенттерде теңшеңіз.

Қолжетімді әрекет түрлері​

ӘрекетСипаттама
EmailҚоңыраудың email қорытындысын жіберу (бизнес иесіне, клиентке немесе екеуіне)
SMSҚоңыраудан кейін SMS хабарлама жіберу
WhatsAppҚоңыраудан кейін WhatsApp хабарламасын жіберу
API CallҚоңырау деректерімен сыртқы эндпоинтке HTTP сұрауын жасау

Орнату​

  1. Voice Agents → агентіңізді таңдаңыз
  2. Actions қойындысын ашыңыз
  3. "Add Action" түймесін басыңыз
  4. Әрекет түрін таңдап, теңшеңіз:
    • Trigger: Әрекет қашан іске қосылатыны (мысалы, әр қоңыраудан кейін, тек белгілі бір нәтижелерде)
    • Recipients: Хабарламаны кім алатыны
    • Content: Қоңырау деректерінің айнымалылары бар хабарлама үлгісі

Теңшелетін интеграциялар​

API пайдалану​

Hanc.AI API арқылы теңшелетін интеграцияларды құрыңыз:

Base URL: https://api.hanc.ai/v1
Authentication: Bearer token (API key)
Format: JSON

API құжаттамасы​

Қолжетімді эндпоинттердің толық тізімі үшін API анықтамасын қараңыз.

Интеграцияның үздік тәжірибелері​

Қауіпсіздік​

  • Тіркелгі деректерін қауіпсіз сақтаңыз
  • API кілттерін жүйелі түрде ауыстырып отырыңыз
  • Рұқсаттарды қажетті ең азына шектеңіз

Сенімділік​

  • Барлық интеграция оқиғаларын журналдаңыз
  • Интеграцияның денсаулығын бақылаңыз

Сынау​

  • Интеграцияларды алдымен staging ортасында сынаңыз
  • Деректер ағынын екі бағытта да тексеріңіз
  • Қате сценарийлерін сынаңыз
  • Интеграцияны орнатуды құжаттаңыз

Ақауларды жою​

Интеграция қосылмайды​

  1. Тіркелгі деректерінің дұрыстығын тексеріңіз
  2. Қате теру бар-жоғын тексеріңіз
  3. Үшінші тарап аккаунтының белсенді екеніне көз жеткізіңіз
  4. Ажыратып, қайта қосып көріңіз

Күнтізбе синхрондалмайды​

  1. Күнтізбеге қол жеткізуді қайта авторизациялаңыз
  2. Күнтізбе рұқсаттарын тексеріңіз
  3. Таңдалған күнтізбенің дұрыстығын тексеріңіз
  4. Синхрондау кідірістерін тексеріңіз (5 минутқа дейін)

Қатысты тақырыптар​