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

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

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

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

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

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

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

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

Баптау қадамдары​

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

Нөмірлер сатып алғаннан кейін автоматты түрде конфигурацияланады және қолдануға дайын.

SIP-магистральы интеграциясы​

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

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

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

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

Талаптарға сәйкестікті мақұлдау​

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

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

  1. Phone Numbers → Connect SIP бөліміне өтіңіз.
  2. Операторыңызды таңдаңыз.
  3. SIP тіркелгі деректерін енгізіңіз (және операторыңыз авто-импортты қолдаса, опциялы API кілті/құпиясы).
  4. Custom SIP үшін хостты, портты (әдепкі 5060) және транспортты (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 күнтізбелерін бір уақытта қосуға болады, бірақ әр агент тек бір күнтізбе құралын қолдана алады.

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

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

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

HubSpot жұмыс кеңістігіңізді қосыңыз — дауыстық агенттеріңіз қоңырау барысында контактілер мен мәмілелерді оқып-жаза алады, ал HANC-тың кірістірілген CRM-і HubSpot құбырларыңызды айналдыра алады.

Не қосылады​

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

Баптау қадамдары​

  1. Integrations бетін ашып, Connect HubSpot батырмасын басыңыз.
  2. HubSpot тіркелгіңізде HANC-қа рұқсат беріңіз.
  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 Servers бетін қараңыз.

API кілттері​

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

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

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

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

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

Маңызды
  • Кілттерді қауіпсіз сақтаңыз (environment variables, secrets manager)
  • Кілттерді ешқашан нұсқаны бақылауға тіркемеңіз
  • Кілттерді мерзімді ауыстырыңыз
  • Қолданылмайтын кілттерді жойыңыз

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 сілтемесі

Веб-құжаттар​

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

Баптау​

  1. Integration → Webhooks бөліміне өтіңіз
  2. Веб-құжат нүктесінің URL-ін енгізіңіз
  3. Жазылатын оқиғаларды таңдаңыз
  4. Конфигурацияны сақтаңыз

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

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

Қоңыраудан кейінгі әрекеттер дауыстық агент сөйлесуі аяқталғаннан кейін автоматты түрде іске қосылады. Оларды жеке агенттерде конфигурациялаңыз.

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

ӘрекетСипаттама
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 минутқа дейін)

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