Abaphuhlisi

I-API yoluntu Beta

Yakha imidibaniso yendawo yokusebenzela ngezitshixo ze-API ezikhuselekileyo, ezinemida nesivumelwano se-JSON esizinzileyo esineenguqulelo.

Vula isalathiso se-API esisebenzisanayo

Ukuqalisa ngokukhawuleza

01
Vula izitshixo ze-API
Vula Iisetingi, khetha Umphuhlisi, fumana Izitshixo ze-API, uze ukhethe Yenza isitshixo. Abanini nabalawuli bangenza izitshixo.
02
Yenza isitshixo se-API
Faka Igama, khetha Siphelelwa emva kweentsuku, khetha Ukufikelela kwizitishi njengo-Zonke izitishi okanye Izitishi ezikhethiweyo, uze ukhethe imida emincinci efunwa ngumdibaniso wakho phantsi kwe-Imida yemvume. Isicelo siphumelela kuphela xa isitshixo sinesenzo sesixhobo esichanekileyo esifunwa yi-endpoint. Khetha Yenza isitshixo.
03
Gcina isitshixo sakho se-API
Isitshixo esipheleleyo siboniswa kanye. Sikope usifake kumlawuli wakho weemfihlo, uze ukhethe Ndiligcinile.
04
Thumela isitshixo
Sebenzisa ithokheni ye-Bearer, okanye uthumele ixabiso elifanayo kwi-x-api-key. Ungaze ubeke izitshixo kwimibuzo ye-URL okanye kwikhowudi yebrawuza.

cURL

curl https://www.usesonny.com/api/v1/contacts?limit=25 \
  --header "Authorization: Bearer sonny_your_key"

Izitshixo zihlala zikhuselekile

Ukhuseleko lwesitshixo: Izitshixo zisebenzisa isimaphambili esithi sonny_, abalinganiswa abangacwangciswanga abayi-64, ukufihla ngendlela enye xa zigciniwe, ukuphelelwa okunokulungiselelwa, nomda wezicelo eziyi-600 ngomzuzu kwisitshixo ngasinye. Isitshixo sibotshelelwe kwindawo enye yokusebenzela.; Ukuze urhoxise esinye, khetha iqhosha lenkunkuma ecaleni kwaso. Qinisekisa Rhoxisa isitshixo se-API? ngokukhetha Cima. Oku kumisa isitshixo ngoko nangoko.
Ugunyaziso kuko konke ukubiza: ISonny iqinisekisa i-hash nomda, emva koko iphinde ijonge ubulungu obusebenzayo bomenzi kwindawo yokusebenzela, indima nemeko yentlawulo. Ukususa okanye ukuyekisa loo msebenzisi kuvala izitshixo zakhe ngoko nangoko.; Izitishi ezikhethiweyo zinyanzeliswa kuko konke ukubiza kwe-REST API ne-MCP. Ii-endpoint zabaqhagamshelwano, zeempawu, zeethegi nezolawulo lwee-webhook zifuna ufikelelo kuzo zonke izitishi. Ukwenza iifomu kungasebenzisa i-contacts:write ne-conversations:write kwizitishi ezikhethiweyo; ii-endpoint zabaqhagamshelwano ezizimeleyo zihlala zezendawo yokusebenzela yonke.

Imida yemvume

contacts:read
contacts:write
tags:read
tags:write
conversations:read
conversations:write
messages:read
messages:write
messages:send
webhooks:read
webhooks:write
kb:read
kb:write
csat:read
attachments:write
members:read
contact-memory:read
contact-memory:write
reporting:read

Izixhobo

Abaqhagamshelwano: Lawula abaqhagamshelwano, iimpawu ezinohlobo, izihluzi zexabiso elichanekileyo neenkumbulo zabathengi. Gcina oqhagamshelwano kuvimba, okanye umcime ngokusisigxina kunye nazo zonke iincoko zakhe kwizicelo zokhuseleko lwedatha.
Imithombo: Fumana imithombo elungiselelweyo nokuba ngamnye uxhasa ichat, i-imeyile okanye zombini.
Iincoko: Yenza imibuzo ukusuka kwiifomu, hluza ezifuna ingqwalasela, abela iiarhente okanye amaqela, lalisa, faka iithegi, uze uhlaziye ngamaqela.
Ukuvumelanisa: Dlala kwakhona utshintsho oluthembekileyo lwendawo yokusebenzela neerekhodi zokucima ngesikhombisi esigciniweyo.
Amalungu namaqela: Fumana amalungu eqela anokwabelwa, ukufumaneka kwawo nofikelelo lwawo lwezitishi olusebenzayo.
Iingxelo: Funda iingxelo zenkxaso, zeqela, ze-AI, zolwazi, zabathengi abanokubakho nezokufumaneka.
Imiyalezo: Funda imbali yemiyalezo nokukhutshwa kombhalo kwizinto eziqhotyoshelweyo, layisha iifayile zabucala, yongeza iinowuthi zangaphakathi, uze uthumele okanye uhlele iimpendulo zabathengi.
Ii-webhook: Lawula ii-endpoint, ubhaliso, uvavanyo, ukuhanjiswa nokuzama kwakhona.
Isiseko solwazi: Yenza, funda, hlaziya uze ucime amanqaku neendidi zeziko loncedo kumthombo ngamnye.
Ukwaneliseka kwabathengi: Funda amanqaku e-CSAT endawo yokusebenzela, esitishi ngasinye nencoko nganye, uze udwelise imilinganiselo nganye ihluzwe ngexabiso lomlinganiselo, uluvo, owabelweyo okanye isithuba sexesha.

Ukusebenzisa iSonny ukusuka kwisixhobo se-AI

I-MCP yeSonny iveza wonke umsebenzi we-API yoluntu njengesixhobo. Abaxhasi baqhagamshela ngokungena nge-OAuth 2.1 — okanye ngesitshixo se-API esinemida — kwaye konke ukubiza kugcina imida efanayo, imida yendawo yokusebenzela nemithetho yeshishini.

Funda isikhokelo se-MCP yeSonny

Iimpendulo neempazamo

Iimpendulo zengqokelela zisebenzisa i-data kwaye ziquka amaphepha apho kufanelekileyo. Yonke impendulo iquka i-x-request-id; ungabonelela nge-ID yesicelo ekhuselekileyo kwaye iSonny iya kuyiphindaphinda. Iimpazamo zibuyisa umyalezo okhuselekileyo ngaphandle kokuveza iinkcukacha zokuphunyezwa ezibuthathaka.

{
  "error": {
    "type": "validation_error",
    "message": "Invalid email address",
    "requestId": "req_01J..."
  }
}

400: Igalelo, i-JSON, umbuzo okanye isikhombisi esingasebenziyo.
401: Isitshixo se-API esingekhoyo, esingasebenziyo, esiphelelweyo okanye esingenamda.
402: Imeko yentlawulo yendawo yokusebenzela ivala esi sicelo.
403: Indima yomenzi wesitshixo kwindawo yokusebenzela ayivumelekanga.
404: Isixhobo asikho kwindawo yokusebenzela yesitshixo.
409: Isicelo singquzulana nesixhobo esele sikhona.
410: Isikhombisi sokuvumelanisa siphelelwe. Qalisa imeko yangoku uze udlale kwakhona ukusuka kwisikhombisi esitsha.
413: Into elayishwayo idlula ubungakanani obuvunyelweyo.
422: Umthombo awunasitishi se-imeyile okanye ixabiso lebala elingenisiweyo alisebenzi.
429: Umda wezicelo wesitshixo ngasinye udluliwe.
500: Kwenzeke impazamo engalindelekanga. Phinda uzame nge-ID yesicelo.
503: Ukusalela emva kokuhanjiswa kwee-webhook kugcwele. Phinda uzame kamva.

Imida yezicelo

Isitshixo se-API ngasinye singenza ukuya kuthi ga kwizicelo ezingama-600 ngomzuzu. Yonke impendulo ixela ifestile yangoku ngee-header eziqhelekileyo RateLimit-Limit, RateLimit-Remaining ne-RateLimit-Reset, ngoko abaxhasi bangazilawula endaweni yokuqikelela. Xa umda udlulwe, i-API ibuyisa i-429 ene-header ye-Retry-After — linda imizuzwana emingaka phambi kokuzama kwakhona.

Iinguqulelo nokuyekiswa

I-API ineenguqulelo kwindlela ye-URL (/api/v1). Ngaphakathi kwenguqulelo senza utshintsho olongezayo kuphela — ii-endpoint ezintsha, amabala amatsha angenyanzelekanga, amaxabiso amatsha e-enum. Utshintsho olwaphula izinto lukhutshwa njengenguqulelo entsha, kwaye phambi kokuba nayiphi na i-endpoint ye-v1 iyekiswe sinika isaziso seenyanga ezintandathu ubuncinane: kweli phepha, nge-imeyile kubanini bendawo yokusebenzela abanezitshixo ze-API ezisebenzayo, nangee-header ze-Deprecation ne-Sunset kwii-endpoint ezichaphazelekayo.

Hlela impendulo ethunyelweyo

Nika isitshixo sakho se-API okanye uqhagamshelo lwe-MCP imida ye-messages:read ne-messages:send nofikelelo kwisitishi sempendulo.
Funda imiyalezo yencoko uze ukope i-ID yempendulo yomntu oyithumeleyo. Isitshixo se-API sisebenza njengomenzi waso; i-OAuth isebenza njengelungu leqela eliqhagamshelweyo.
Thumela umbhalo omtsha usebenzisa isicelo esingezantsi, okanye ubize i-edit_message kwi-MCP ene-conversationId, messageId ne-body.
Jonga umyalezo obuyisiweyo. I-ID yawo, izinto eziqhotyoshelweyo, irisithi yokufunda nexesha lokuthunyelwa kwasekuqaleni zihlala zinjalo.

curl --request PATCH \
  https://www.usesonny.com/api/v1/conversations/conversation_1/messages/message_1 \
  --header "Authorization: Bearer sonny_your_key" \
  --header "Content-Type: application/json" \
  --data '{"body":"The corrected reply"}'

Ukuhlela kulungisa umbhalo wencoko nabaxhasi bechat abaqhagamshelweyo. Akuthumeli enye i-imeyile okanye isaziso, kwaye ii-imeyile esele zihanjisiwe zihlala zingatshintshi. Ziimpendulo zakho zabantu kubathengi kuphela ezinokuhlelwa; imiyalezo engenayo, iimpendulo zebhoti, iinowuthi zangaphakathi neempendulo zamanye amalungu eqela azinakuhlelwa. Linda ukuhanjiswa kwe-imeyile okulindileyo kugqitywe phambi kokuhlela. Umbhalo omtsha kufuneka ube nabalinganiswa abali-1–50,000; i-HTML yangaphambili nemiboniso yamakhonkco iyacocwa. Imidibaniso ifumana i-webhook ye-message.updated nesiganeko sokuvumelanisa. Ukujonga kuphela ii-ID zemiyalezo emitsha akuyi kufumana uhlelo; sebenzisa umsinga ozinzileyo wokuvumelanisa.

Yenza incoko ukusuka kwifomu

Thumela ifomu engenisiweyo ku-POST /api/v1/conversations. ISonny ifumana okanye yenze oqhagamshelwano nge-imeyile, igcina iimpendulo, kwaye ivule incoko engenayo kwisitishi se-imeyile somthombo owukhethileyo. Iqela lesitishi, imithetho yokwabela nezaziso ziyasebenza. Iiarhente ziphendula nge-imeyile.

Yenza isitshixo esine-conversations:write ne-contacts:write. Ungasinciphisa kwizitishi ezikhethiweyo zomxhasi. Fumana i-ID yomthombo nge-GET /api/v1/sources, ekwafuna i-conversations:read.
Kwi-n8n, yongeza i-node ethi HTTP Request: indlela POST, i-URL https://www.usesonny.com/api/v1/conversations. Gcina isitshixo kwiinkcukacha zokungena ze-Header Auth: Authorization enexabiso elithi Bearer sonny_your_key.
Vula Send Body, khetha JSON no-Using JSON, uze utshintshe ibala lonke le-JSON libe yi-Expression uze uncamathisele lo mzekelo. Tshintsha i-ID yomthombo uze uhambelanise amabala egalelo nefomu yakho. Sebenzisa i-ID yokungenisa yefomu ezinzileyo nekhethekileyo ukuze ukuzama kwakhona kusebenzise ixabiso elifanayo.

{{ {
  sourceId: "YOUR_CLIENT_SOURCE_ID",
  contact: { email: $json.email, name: $json.name },
  subject: "Website enquiry",
  message: $json.message,
  fields: {
    Company: String($json.company ?? ""),
    Budget: String($json.budget ?? ""),
    Service: String($json.service ?? "")
  },
  externalId: "website-form-" + $json.submissionId
} }}

Ngokhetho olungakumbi lwe-node, jonga isikhokelo se-n8n HTTP Request. Isixhobo se-MCP esilinganayo yi-create_conversation, enomthwalo neemvume ezifanayo.

Amagama amabala amatsha aba ziimpawu zombhalo. Amabala esele ekhona enani, e-URL, omhla nawokhetho kufuneka afumane amaxabiso e-string asebenzayo; ixabiso elibi libuyisa i-422 elichaza ibala kwaye akukho nto igcinwayo. Imihla yamkela imihla ye-ISO okanye ii-timestamp; amaxabiso okhetho kufuneka ahambelane nokhetho. Kwamkelwa ukuya kuthi ga kumabala angama-50, anamagama ukuya kuthi ga kwabalinganiswa abali-100 namaxabiso ukuya kuthi ga kwi-5,000. Iimpawu zivela kuqhagamshelwano nakwibha esecaleni yencoko. Yomibini imizimba yemiyalezo igcina ikopi yeempendulo, kuquka xa unikeza i-htmlMessage engenyanzelekanga.

I-tags engenyanzelekanga yamkela ukuya kuthi ga kwii-ID zeethegi zendawo yokusebenzela ezingama-20 esele zikhona. Impendulo iqulethe i-conversation, isishwankathelo se-contact, i-message ne-deduplicated. Ukungenisa okutsha kubuyisa i-201. Ukuphinda usebenzise i-externalId kumthombo ofanayo kubuyisa i-200 nee-ID zokuqala ne-deduplicated: true; umxholo otshintshileyo awukhathalelwa. Ngaphandle kwe-ID yangaphandle, konke ukubiza kwenza incoko entsha. Izinto eziqhotyoshelweyo xa kusenziwa neempendulo ezizenzekelayo ze-AI azixhaswanga.

Iinkqubo zeearhente

Hlela, yenza, uze uhlale uvumelana

I-REST ne-MCP zabelana ngeemvume neenkqubo ezifanayo. Iinkcukacha zokungena zinokunciphisa kuphela ufikelelo lwakho lwangoku lwezitishi; ukususa isitishi kubulungu bakho kukwasisusa kwimidibaniso yakho.

Fumana iincoko ezifuna ingqwalasela

Hluza nge-awaitingReply, unread, unassigned, assigneeId, agentGroupId, snoozed, priority okanye tagIds. Ukulinda impendulo akukhathali ngeenowuthi zangaphakathi; i-unread ithe ngqo kwilungu leqela eliqinisekisiweyo. I-unassigned ithetha ukuba akukho mntu mnye wabelweyo, nokuba iqela labelwe. Iithegi zihambelana nayiphi na i-ID enikiweyo.

GET /api/v1/conversations?status=open&awaitingReply=true&compact=true&sort=waitingSince&direction=asc

Lungelelanisa nge-waitingSince, lastMessageAt, createdAt okanye ukubaluleka kweshishini nge-direction asc okanye desc. Ii-ID zahlula xa zilingana. Izihluzi ezingafakwanga zigcina i-compact=false ne-snoozed=any. I-tagIds ye-REST yamkela ii-ID ezahlulwe ngeekoma; i-MCP yamkela ne-array. I-waitingSince iqala kumyalezo wokuqala ongenayo emva kwempendulo yokugqibela; ukulandelela neenowuthi zangaphakathi azibuyiseli kwakhona. Qhuba olu hlolo lomgca wokulinda ngeshedyuli nokuba akukho webhook ifikayo, ukuze imisonto emidala iphinde ivele.

Fumana konke ngaphandle kokuphinda ufunde ibhokisi engenayo

Sebenzisa i-GET /api/v1/sync ene-conversations:read. Umsinga ozinzileyo uquka utshintsho lweencoko, iithegi, imiyalezo, iimpawu zabaqhagamshelwano, iinkumbulo neerekhodi zokucima. Umthwalo ngamnye ukwafuna umda wawo wokufunda: imizimba yemiyalezo ifuna i-messages:read kwaye iinkumbulo zifuna i-contact-memory:read. Iinkcukacha zokungena ezithintelweyo zifumana kuphela izitishi ezivunyelweyo.

Qala ngaphandle kwesikhombisi, landela i-nextCursor de i-hasMore ibe yi-false, uze ugcine eso sikhombisi.
Funda uluhlu lwangoku lweencoko/lwabaqhagamshelwano nayo nayiphi na imbali oyidingayo kwimeko yakho yokuqala.
Dlala kwakhona ukusuka kwisikhombisi esigciniweyo ukuze ubambe utshintsho ngexesha lokufunda. Qhuba iphepha ngalinye, uze ugcine i-nextCursor.

Susa eziphindiweyo nge-id yesiganeko: ukudlala kwakhona kwenzeka ubuncinane kanye, ngoko izenzo ezilandelayo zifuna ukhuseleko lwazo kwiziphindiweyo. Isicelo esingenasikhombisi sigubungela iyure yokugqibela, hayi umfanekiso opheleleyo. Iziganeko zigcinwa iintsuku ezingama-30; i-HTTP 410 resync_required ithetha qalisa kwakhona. Qalisa kwakhona nasemva kokwandisa imida okanye ufikelelo lwezitishi. Sebenzisa i-limit ukuya kuthi ga ku-100 ne-maxBodyChars ukuya kuthi ga ku-10,000 (okwesiqhelo yi-500). Seta i-compact=true kumabala e-textPreview/textTruncated emiyalezo anomda wabalinganiswa abangama-200 endaweni ye-body/bodyTruncated. Ii-webhook zingavusa iarhente; umsinga uhlala ufumaneka ngaphandle kobhaliso lwee-webhook okanye xa ukuhanjiswa kwee-webhook kusalela emva.

Bhala uhlolo kanye uze wabelane ngesiphumo

Phambi kokuphinda uphando, funda i-list_conversation_checks (GET /api/v1/conversations/{conversationId}/checks). Gcina isiphumo nge-record_conversation_check (PUT kwindlela efanayo), unikeze i-key, result, checkedBy ne-reference engenyanzelekanga ye-ID yekhadi okanye i-URL. Umzekelo: key=product-version, result=Shopstar Go verified, checkedBy=Engineer, reference=card-X. ISonny ibhala i-actorId eqinisekisiweyo ne-timestamp ye-checkedAt. Ukuphinda usebenzise i-key kutshintsha olo hlolo kuphela; le yimeko yangoku, ayiyolog yembali. Ukufunda kufuna i-conversations:read kwaye ukubhala kufuna i-conversations:write, zombini zinqunyelwe kwisitishi sencoko. Oku kubiza akuthumeli mpendulo okanye kuphawule umthengisi njengophendulweyo.

Abela uze uhlaziye umsebenzi ngamaqela

Fumana amalungu eqela namaqela asebenzayo anokwabelwa nge-GET /api/v1/members and /teams (members:read). Iimpendulo ziquka ukufumaneka nofikelelo lwezitishi olusebenzayo, ngaphandle kweedilesi ze-imeyile. Sebenzisa i-conversations:write ukutshintsha i-status, priority, assigneeId, agentGroupId, snoozedUntil, snoozedUntilReply, addTagIds okanye removeTagIds.

POST /api/v1/conversations/batch
{
  "conversationIds": ["conversation_1", "conversation_2"],
  "updates": { "agentGroupId": "team_1", "assignment": "round_robin" }
}

Ukwabela ngokujikelezayo kukhetha ilungu leqela elikhoyo elinokufikelela kwisitishi sencoko. Xa kungekho lungu lifanelekileyo, uhlaziyo olunye lubuyisa i-409 kwaye into enye kwiqela ayiphumeleli. Iqela ngalinye lamkela ukuya kuthi ga kwii-ID ezahlukileyo eziyi-100 kwaye lisebenzisa i-patch enye ngokupheleleyo kwincoko nganye. Hlola sonke isiphumo se-{ id, ok, error? }; ezinye izinto zingaphumeleli. Amaqela asebenzisa umda wezicelo wangoku osekelwe kwizicelo, ngaphandle kokuhlawulisa ngobunzima ngokwenani lezinto.

Yabelana ngeenkcukacha zomthengi neSonny AI

Dwelisa, gcina uze ususe iinkumbulo zabaqhagamshelwano nge-contact-memory:read/write. Nika zombini i-contactId ne-sourceId efikelelekayo; oqhagamshelwano kufuneka abe nencoko kuloo mthombo. Iinyani ezigciniweyo zisebenzisa ukuqinisekisa okufanayo, ukuphatha eziphindiweyo nemida njenge-app kwaye zibhalwa njengeenkumbulo zesandla.

Funda iinkcazo zeempawu kwi-/api/v1/properties uze ufunde okanye usete amaxabiso kwi-/api/v1/contacts/{contactId}/properties. I-MCP iveza i-list_properties, get_contact_properties ne-set_contact_property. Ezi zifuna i-contacts:read/write nofikelelo kuzo zonke izitishi. Seta kanye i-propertyId enye okanye i-propertyName, ngexabiso le-string okanye i-null ukuze ulicoce. Amaxabiso ombhalo, enani, e-URL, omhla nawokhetho aqinisekiswa ngokwenkcazo yebala.

PUT /api/v1/contacts/contact_1/properties
{ "propertyName": "Plan", "value": "Pro" }

GET /api/v1/contacts?property[Plan]=Pro

Izihluzi zeempawu zihambelana nee-string ezigciniweyo ngokuchanekileyo; iimpawu ezininzi kufuneka zonke zihambelane. Amaxabiso abhalwe yi-API aphawulwa njengedatha ye-API kwi-Co-Pilot nakumphenduli ozenzekelayo. Imithetho esele ikhona yabathengi abaqinisekisiweyo neyemithombo isasebenza. Amaxabiso amabala angaphakathi aqhelekileyo afakwe ngesandla ahlala engabandakanywa kwezi nkcukacha ze-AI.

Funda iingxelo ezifanayo neqela lakho

Nge-reporting:read, biza i-GET /api/v1/reporting/{kind}. Iintlobo zezi: overview, volume, response-times, agents, sources, tags, csat, ai, knowledge, leads ne-online-hours. I-overview idibanisa amanani, amaxesha okuphendula ne-CSAT. Izihluzi zezi: period (iintsuku ezi-1–365, okwesiqhelo zingama-30), imihla edibeneyo ye-from/to (i-to ayibandakanywa), granularity (day/month), source, assigneeId ne-tagId. I-source yamkela i-all, all-chat, all-email, website:{id} okanye email:{id}.

Iingxelo zisebenzisa imibuzo yedashbhodi nokujonga ufikelelo kwangoku. I-knowledge isebenzisa imihla nezitishi ezivunyelweyo, ngaphandle komthombo okhethiweyo, owabelweyo okanye ithegi. Iiyure zokuba kwi-intanethi zilinganisa ubukho bamalungu eqela afikelelekayo kwindawo yokusebenzela; amanani alo eencoko ahlala enqunyelwe kwizitishi. Ii-endpoint ze-/csat esele zikhona zigcina umda wazo owahlukileyo we-csat:read kwaye zinokuchaza iqela elahlukileyo.

Thumela iifayile neempendulo okanye iinowuthi zangaphakathi

Nika i-attachments:write uze ulayishe ifayile ukuya kuthi ga kwi-25 MB yencoko. I-POST /api/v1/attachments ithatha amabala e-multipart file ne-conversationId. Impendulo iqulethe i-id ne-expiresAt. Dlulisela ukuya kuthi ga kwii-attachmentIds ezili-10 kwimpendulo okanye kwinowuthi kwisithuba seyure enye. Into nganye elayishiweyo ibotshelelwe kumsebenzisi wakho nakwincoko kwaye ingasetyenziswa kanye kuphela. Izinto ezilayishiweyo ezingasetyenziswanga ziyacocwa emva kokuphelelwa.

POST /api/v1/conversations/conversation_1/reply
{ "attachmentIds": ["upload_1"] }

Iimpendulo zifuna i-messages:send; iinowuthi zangaphakathi zifuna i-messages:write kwaye azize zifike kubathengi. Imiyalezo eneefayile kuphela iyaxhaswa. Iimpendulo ze-imeyile ziquka iifayile ngaphakathi kobungakanani be-imeyile namakhonkco okukhuphela azo zonke ezinye; ii-imeyile zechat engekho kwi-intanethi ziquka amakhonkco eefayile. Amakhonkco athunyelwe nge-imeyile ahlala esebenza ngelixa into eqhotyoshelweyo ikhona, ngoko abamkeli bangawavula kamva. Ukudlulisela i-imeyile kwabelana ngofikelelo kwezo fayile. Jonga i-emailDeliveryStatus ukuze ubone ukungaphumeleli kokuhanjiswa.

Ukufunda imiyalezo okugunyazisiweyo kuquka i-downloadUrl, downloadExpiresAt, aiStatus, aiDescription ne-aiExtractedText, kunye ne-videoTranscripts yeevidiyo ezinekhonkco (Loom, Vimeo nezinye). Amakhonkco okukhuphela ahlala imizuzu eli-15; phinda ufunde umyalezo ukuze ufumane amakhonkco amatsha. Izinto ezintsha ezilayishwe nge-API/MCP zinogcino lwabucala. Izinto ezindala eziqhotyoshelweyo zihlala zezoluntu kwaye ziphawulwe njenge-access=legacy_public: i-URL yazo yokuqala ayiphelelwa. Ukufunda umyalezo kuqalisa ukufunda imifanekiso yawo xa indawo yokusebenzela ineSonny AI. Ukufundwa kwemifanekiso nemibhalo yeevidiyo kugqitywa kungekudala emva kokuba umyalezo ufikile: ngelixa kukho ezisaqhubekayo, impendulo iqala nge-readsInProgress, ene-nextStep enika kanye ukubiza ekufuneka ukwenzile. Dlulisela i-waitSeconds (ukuya kuthi ga ku-30) ukuze uzilinde kwisicelo esinye. Iwijethi ebonwa ngabathengi nemiyalezo yexesha lokwenyani azize ziquke ukukhutshwa kombhalo okanye imibhalo yeevidiyo.

Phonononga izivumelwano ezipheleleyo zezicelo neempendulo

Isiseko solwazi

Vumelanisa ukusuka kumthombo wangaphandle

Vumelanisa amanqaku neendidi usebenzisa ii-ID zangaphandle ezizinzileyo, ngenisa i-Markdown okanye i-HTML, layisha imifanekiso, seta ulandelelwano, uze ulawule abaphulaphuli abangabafundi. Ukuphinda i-upsert kuhlaziya umxholo osele ukhona.

Khetha i-sourceId yesitishi sakho uze unike i-kb:read ne-kb:write. Gcina isitshixo se-API kwiseva yakho uze unciphise Ukufikelela kwizitishi kwaso.
Yenza udidi, uze uvumelanise inqaku njengedrafti. Phonononga ufomatho nofikelelo lwalo phambi kokupapasha.
Lungiselela ufikelelo lweziko loncedo, papasha, uze uvavanye umboniso womfundi. Sebenzisa amaphepha nee-ID zangaphandle ezizinzileyo kuhlaziyo lwamva.

Landela isikhokelo esipheleleyo sokuvumelanisa nge-REST

Lawula abaphulaphuli abangabathengi

Yenza amaqela ukusuka kwiimpawu zabathengi eziqinisekisiweyo uze uwasebenzise kwiziko loncedo, udidi okanye inqaku. Zonke izithintelo ezifunyenwe njengelifa kufuneka zihambelane. Iinkcukacha zokungena ze-API ne-MCP zisebenza njengabasebenzi ngaphakathi kwemida yazo; jonga kuqala uze uvavanye iseshoni yomthengi wokwenyani ukuze ujonge ufikelelo lomfundi.

Lungiselela uze uvavanye abaphulaphuli beziko loncedo