Tofauti kati ya kujua na kuangalia
Kuna aina mbili za maswali ya wateja. Aina ya kwanza ni ya jumla: Sera yenu ya kurudisha bidhaa ni ipi? Usafirishaji huchukua muda gani? Mnasafirisha hadi Ujerumani? Hifadhi ya maarifa iliyojaa vizuri inashughulikia haya.
Aina ya pili ni mahususi: Agizo langu #4521 liko wapi? Toleo la bluu bado liko stoo? Imebakia kiasi gani katika mpango wangu mwezi huu? Haya hayaishi katika hifadhi ya maarifa. Yanaishi katika mifumo yako — usimamizi wa maagizo, hifadhi, malipo — na hubadilika kila sekunde.
Roboti ya gumzo inayoweza kushughulikia aina ya kwanza tu ni FAQ iliyopambwa. Roboti ya gumzo inayoweza pia kushughulikia ya pili ni msaidizi. Tofauti kati ya hizo mbili ni ufikiaji wa API.
Kwa nini pengo hili linakugharimu wateja
"Gumzo la AI" la leo limejengwa juu ya hifadhi ya maarifa pekee. Linaweza kueleza upya sera yako ya usafirishaji katika lugha kumi na saba, lakini haliwezi kumweleza mteja mahali ambapo kifurushi chake kipo sasa hivi. Hivyo mteja anauliza, roboti inakwepa, na mteja anakata tamaa au anasubiri opereta atafute data ile ile ambayo roboti ingeweza kuipata kwa milisekunde.
Hicho ni dari ya roboti ya gumzo. Kila "niangalie kwa ajili yako" ni fursa iliyopotea ya kujibu kwa sekunde, kwenye ujumbe wa kwanza, wakati nia ya mteja bado iko moto.
Miunganisho ya API hufanya nini hasa
Katika enuchat, muunganisho wa API ni kiungo kilichoundwa kati ya gumzo na mojawapo ya huduma zako za nyuma. Unauelezea mara moja: URL ya msingi, njia ya uthibitishaji, na mafusi machache ya endpoints na vigezo vyao na jinsi ya kupanga jibu.
Kuanzia hapo, AI inaweza kupiga simu kwa endpoints hizo wakati wa mazungumzo. Mgeni anapouliza kuhusu agizo, AI inatoa nambari ya agizo, inapiga simu kwenye endpoint yako ya maagizo, inasoma hali ya moja kwa moja na inaifuma katika jibu. Mgeni anaona sentensi moja: "Agizo lako #4521 lilisafirishwa jana na linatarajiwa kuwasili Alhamisi." Nyuma ya sentensi hiyo wito halisi wa API ulitokea.
Mteja haoni mabomba. Anaona tu kwamba gumzo linajua kweli.
Njia tano za uthibitishaji, hakuna msimbo maalumu
API nyingi ungetaka kuunganisha tayari hutumia uthibitishaji wa kawaida. enuchat inasaidia tano moja kwa moja:
- Hakuna — kwa API za umma zisizohitaji uthibitishaji
- API Key — inatumwa kama kichwa au kigezo cha hoja
- Bearer Token — uthibitishaji rahisi unaotegemea ishara
- Basic Auth — kwa mifumo ya zamani
- OAuth 2.0 client credentials — kwa watoa huduma wa kisasa kama Salesforce, HubSpot au seva yako mwenyewe ya OAuth
Kwa OAuth 2.0, enuchat inashughulikia mzunguko wa maisha wa ishara kiotomatiki — inachukua kwenye wito wa kwanza, inahifadhi hadi muda wake umalizike, inaonyesha upya pale inapohitajika. Unasanidi vitambulisho mara moja na unasahau. Vitambulisho vyote vinasimbwa kwa libsodium wakati wa kupumzika na havitokei kamwe katika majibu ya API.
Vipengele, violezo na upangaji wa jibu
Endpoints zinatambuliwa kama violezo. Njia kama /orders/{orderId} au mwili wa JSON unaorejea {customerId} inaingiza thamani kutoka vipengele vya kikao — vipengele ambavyo AI au sheria tuli inaweza kuviweka wakati wa mazungumzo.
Wakati API ikijibu, unapanga vipengele kutoka jibu la JSON kurudi kwa vipengele vya kikao kwa kutumia notation ya nukta. data.status inakuwa order_status. data.shipping.eta inakuwa delivery_eta. AI kisha inafuma thamani hizo katika jibu la lugha ya asili — katika lugha ya mgeni mwenyewe.
Mifumo mitatu inayofunika visa vingi vya matumizi
Kwa vitendo, michanganyiko mingi ya API inaangukia katika moja ya maumbo matatu.
Tafuta na ujibu
Mgeni anauliza swali ambalo linaweza kujibiwa kwa wito mmoja wa API. Sheria inafyatua CALL_API ikifuatiwa na REPLY_AI. AI inatumia data iliyochukuliwa kuandika jibu lenye muktadha na lenye msingi. Hali ya agizo, salio la akaunti, upatikanaji wa chumba, bei za sasa, ufuatiliaji wa kifurushi — yote yanafaa hapa.
Tafuta na uelekeze
Wito wa API unarudisha taarifa za kutosha kuamua hatua inayofuata. Akaunti ya kiwango cha juu inapelekwa kwa wakala mwandamizi. Usajili uliokwisha unaelekezwa kwa malipo. AI inatumia CALL_API ikifuatiwa na ASSIGN_TO_OPERATOR kufanya maamuzi ya uelekezaji kulingana na data halisi ya mteja, sio kubahatisha.
Mtiririko wa hatua nyingi
Ujumbe wa kwanza unaweka lebo kwenye mazungumzo kwa kutumia SET_VARIABLE, wa pili unachochea wito wa API mara muktadha unapotosha, na wa tatu unaunda jibu. Muhimu unapohitaji kuthibitisha nia kabla ya kupiga ping kwenye nyuma yako, au wakati utafutaji wa data unategemea kitu ambacho mgeni alisema ujumbe miwili nyuma.
Usalama uliojengewa ndani
Kuunganisha mifumo ya nyuma na widget ya gumzo huwafanya wengine kuwa na wasiwasi — na inafaa. enuchat hutoa tabaka kadhaa za ulinzi kwa chaguo-msingi:
- Kuzuia SSRF kunazuia simu kwa localhost, IP za faragha, na majina ya wenyeji ya ndani
- Muda wa sekunde 5 unazuia API polepole isimamishe mazungumzo
- Utenganishaji wa wapangaji ina maana hakuna uvujaji wa data kati ya wapangaji — endpoints zako zinaonekana tu kwa widget zako mwenyewe
- Vifungo vya majaribio vinathibitisha muunganisho na kila endpoint kwa uhuru kabla ya kuvifunga kwenye sheria
- Vitambulisho vilivyosimbwa hairudi kamwe kwenye dashibodi katika muundo unaosomeka
Kinachobadilika kwa wateja wako
Gumzo linapita kutoka "niruhusu nimtafute mtu anayeweza kuangalia hilo" hadi "nimeangalia, hapa ndiyo jibu" — katika mojawapo ya lugha 60+, Jumapili saa 9 alfajiri, wakati timu yako ya msaada imelala. Wateja ambao wangeacha kikapu, agizo au mpango wanasalia, kwa sababu jibu linafika wakati bado wanauliza.
Hiyo ndiyo tofauti kati ya roboti ya gumzo na msaidizi. Na ndiyo tofauti ambayo wateja wako wanaihisi kweli.
Jinsi ya kuanza
Kama una enuchat tayari, miunganisho ya API ipo chini ya Mipangilio → Miunganisho ya API. Chagua endpoint moja inayojibu swali ambalo timu yako huandika mara mia kwa wiki — hali ya agizo huwa mahali pa kuanzia penye ufanisi mkubwa zaidi. Sanidi muunganisho, ongeza endpoint, iunganishe na sheria, na ijaribu mara moja kabla ya kwenda live. Tazama mwongozo wa Miunganisho ya API kwa muelekeo kamili.
Kama wewe ni mpya kwa enuchat, jisajili katika enuchat.com. Kifurushi cha bure kinajumuisha miunganisho ya API kuanzia siku ya kwanza — hakuna kadi inayohitajika, hakuna ada kwa kila mazungumzo, hakuna kuisha kwa jaribio.
Dakika tano kuziba endpoint yako ya kwanza. Jibu la kwanza la manufaa kwa kawaida hufika siku hiyo hiyo.