Onjiniyela

I-API yomphakathi Beta

Yakha ukuhlanganiswa kwendawo yokusebenza ngokhiye be-API abavikelekile abanemikhawulo kanye nesivumelwano se-JSON esizinzile esinezinguqulo.

Vula ireferensi ye-API esebenzisanayo

Isiqalo esisheshayo

01
Vula okhiye be-API
Vula i-Izilungiselelo, khetha i-Unjiniyela, thola i-Okhiye be-API, bese ukhetha i-Dala ukhiye. Abanikazi nabalawuli bangadala okhiye.
02
Dala ukhiye we-API
Faka i-Igama, khetha i-Iphelelwa ezinsukwini, ku-Ukufinyelela iziteshi khetha i-Zonke iziteshi noma i-Iziteshi ezikhethiwe, bese ukhetha imikhawulo embalwa kakhulu edingwa ukuhlanganiswa kwakho ngaphansi kwe-Imikhawulo. Isicelo siphumelela kuphela uma ukhiye unesenzo sensiza esiqondile esidingwa yi-endpoint. Khetha i-Dala ukhiye.
03
Londoloza ukhiye wakho we-API
Ukhiye ophelele uboniswa kanye kuphela. Wukopishele kumphathi wakho wezimfihlo, bese ukhetha i-Ngililondolozile.
04
Thumela ukhiye
Sebenzisa i-Bearer token, noma uthumele inani elifanayo ku-x-api-key. Ungalokothi ufake okhiye kuma-query string noma kukhodi yesiphequluli.

cURL

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

Okhiye bahlala bevikelekile

Ukuphepha kokhiye: Okhiye basebenzisa isiqalo esithi sonny_, izinhlamvu ezingahleliwe ezingu-64, i-hashing yendlela eyodwa uma kugciniwe, ukuphelelwa yisikhathi okungalungiswa, kanye nomkhawulo wezicelo ezingu-600 ngomzuzu ngokhiye ngamunye. Ukhiye uboshelwe endaweni yokusebenza eyodwa.; Ukuze uhoxise ukhiye, khetha inkinobho kadoti eduze kwawo. Qinisekisa i-Hoxisa ukhiye we-API? ngokukhetha i-Susa. Lokhu kumisa ukhiye ngokushesha.
Ukugunyazwa kuyo yonke ikholi: I-Sonny iqinisekisa i-hash nemikhawulo, bese iphinda ihlole ubulungu bendawo yokusebenza obusebenzayo bomdali, indima yakhe, nesimo sokukhokha. Ukususa noma ukuvala lowo msebenzisi kuvala okhiye bakhe ngokushesha.; Iziteshi ezikhethiwe ziyaphoqelelwa kuyo yonke ikholi ye-REST API ne-MCP. Ama-endpoint okuphatha oxhumana nabo, izimfanelo, amathegi nama-webhook adinga ukufinyelela kuzo zonke iziteshi. Ukudala kusuka kufomu kungasebenzisa i-contacts:write ne-conversations:write eziteshini ezikhethiwe; ama-endpoint oxhumana nabo azimele ahlala esebenza kuyo yonke indawo yokusebenza.

Imikhawulo

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

Izinsiza

Oxhumana nabo: Phatha oxhumana nabo, izimfanelo ezinezinhlobo, izihlungi zamanani aqondile, nezinkumbulo zamakhasimende. Gcina oxhumana naye kungobo yomlando, noma umsule unomphela kanye nazo zonke izingxoxo zakhe uma kunezicelo zokuvikelwa kwemininingwane.
Imithombo: Thola imithombo esethiwe nokuthi ngamunye usekela ingxoxo, i-imeyili, noma kokubili.
Izingxoxo: Dala imibuzo kusuka kumafomu, hlunga okudinga ukunakwa, abela ama-ejenti noma amathimba, hlehlisa, faka amathegi, futhi ubuyekeze ngamaqoqo.
Ukuvumelanisa: Phinda udlale izinguquko eziqinile zendawo yokusebenza namarekhodi okususa nge-cursor egciniwe.
Amalungu namathimba: Thola ozakwenu abangabelwa umsebenzi, ukutholakala kwabo, nokufinyelela kwabo okusebenzayo eziteshini.
Imibiko: Funda imibiko yosizo, yamathimba, ye-AI, yolwazi, yamaliidi, neyokutholakala.
Imilayezo: Funda umlando wemilayezo nokukhishwa kokuqukethwe kokunamathiselwe, layisha amafayela angasese, engeza amanothi angaphakathi, futhi uthumele noma uhlele izimpendulo zamakhasimende.
Ama-webhook: Phatha ama-endpoint, okubhaliselwe, ukuhlola, ukulethwa, nokuzama futhi.
Isisekelo solwazi: Dala, funda, buyekeza, futhi ususe ama-athikili nezigaba zesikhungo sosizo emthonjeni ngamunye.
Ukwaneliseka kwamakhasimende: Funda amaphuzu e-CSAT endawo yokusebenza, esiteshi ngasinye, nengxoxo ngayinye, futhi ubhale izilinganiso ngazinye ezihlungwe ngenani lesilinganiso, amazwana, owabelwe, noma isikhathi.

Ukusebenzisa i-Sonny kusuka ethuluzini le-AI

I-Sonny MCP iveza yonke imisebenzi ye-API yomphakathi njengethuluzi. Amaklayenti axhuma ngokungena nge-OAuth 2.1 — noma ngokhiye we-API onemikhawulo — futhi yonke ikholi igcina imikhawulo efanayo, imingcele yendawo yokusebenza, nemithetho yebhizinisi.

Funda umhlahlandlela we-Sonny MCP

Izimpendulo namaphutha

Izimpendulo zamaqoqo zisebenzisa i-data futhi zifaka ukuhlukaniswa kwamakhasi lapho kufanele khona. Yonke impendulo ifaka i-x-request-id; ungahlinzeka nge-ID yesicelo ephephile futhi i-Sonny izoyiphindisela. Amaphutha abuyisa umlayezo ophephile ngaphandle kokudalula imininingwane ebucayi yokusebenza kohlelo.

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

400: Okufakiwe, i-JSON, i-query, noma i-cursor akuvumelekile.
401: Ukhiye we-API awukho, awuvumelekile, uphelelwe yisikhathi, noma awunawo umkhawulo odingekayo.
402: Isimo sokukhokha sendawo yokusebenza sivimba lesi sicelo.
403: Indima yendawo yokusebenza yomdali wokhiye ayivunyelwe.
404: Insiza ayikho endaweni yokusebenza yokhiye.
409: Isicelo siyangqubuzana nensiza esikhona.
410: I-cursor yokuvumelanisa iphelelwe yisikhathi. Layisha isimo samanje kabusha bese uphinda udlala kusuka ku-cursor entsha.
413: Okulayishwayo kudlula usayizi ovunyelwe.
422: Umthombo awunaso isiteshi se-imeyili noma inani lenkambu elithunyelwe alivumelekile.
429: Umkhawulo wezicelo wokhiye ngamunye udluliwe.
500: Kwenzeke iphutha elingalindelekile. Zama futhi nge-ID yesicelo.
503: Ulayini wokulethwa kwama-webhook ugcwele. Zama futhi kamuva.

Imikhawulo yezicelo

Ukhiye ngamunye we-API ungenza izicelo ezifika ku-600 ngomzuzu. Yonke impendulo ibika isikhathi samanje ngama-header ajwayelekile i-RateLimit-Limit, i-RateLimit-Remaining, ne-RateLimit-Reset, ukuze amaklayenti azilawule wona ngokwawo esikhundleni sokuqagela. Uma umkhawulo udluliwe, i-API ibuyisa i-429 ne-header ye-Retry-After — linda leyo nombolo yemizuzwana ngaphambi kokuzama futhi.

Izinguqulo nokuyekiswa

I-API inezinguqulo endleleni ye-URL (/api/v1). Ngaphakathi kwenguqulo senza kuphela izinguquko ezengezayo — ama-endpoint amasha, izinkambu ezintsha ezingaphoqelekile, amanani amasha e-enum. Izinguquko eziphula ukusebenza zifika njengenguqulo entsha, futhi ngaphambi kokuthi noma iyiphi i-endpoint ye-v1 iyekiswe sinikeza isaziso sezinyanga eziyisithupha okungenani: kuleli khasi, nge-imeyili kubanikazi bezindawo zokusebenza abanokhiye be-API abasebenzayo, nangama-header e-Deprecation ne-Sunset kuma-endpoint athintekayo.

Hlela impendulo ethunyelwe

Nika ukhiye wakho we-API noma ukuxhuma kwe-MCP imikhawulo ethi messages:read ne-messages:send kanye nokufinyelela esiteshini sempendulo.
Funda imilayezo yengxoxo bese ukopisha i-ID yempendulo yomuntu oyithumelile. Ukhiye we-API usebenza njengomdali wawo; i-OAuth isebenza njengozakwenu oxhumile.
Thumela umbhalo omusha usebenzisa isicelo esingezansi, noma ubize i-edit_message ku-MCP nge-conversationId, i-messageId, ne-body.
Hlola umlayezo obuyisiwe. I-ID yawo, okunamathiselwe, irisidi yokufundwa, nesikhathi sokuqala sokuthunyelwa kuhlala kunjalo.

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 wengxoxo namaklayenti engxoxo axhunyiwe. Akuthumeli enye i-imeyili noma isaziso, futhi ama-imeyili asevele elethiwe ahlala engashintshile. Kungahlelwa kuphela izimpendulo zakho zomuntu ezithunyelwe kumakhasimende; imilayezo engenayo, izimpendulo ze-bot, amanothi angaphakathi, nezimpendulo zabanye ozakwenu azinakuhlelwa. Linda ukuthi ukulethwa kwe-imeyili okulindile kuqedwe ngaphambi kokuhlela. Umbhalo omusha kufanele ube nezinhlamvu ezingu-1–50,000; i-HTML yangaphambilini nokubukwa kuqala kwezixhumanisi kuyasulwa. Ukuhlanganiswa kuthola i-webhook ye-message.updated nomcimbi wokuvumelanisa. Ukubheka kuphela ama-ID emilayezo emisha ngeke kuthole okuhleliwe; sebenzisa i-feed yokuvumelanisa eqinile.

Dala ingxoxo kusuka kufomu

Thumela okuthunyelwe kwefomu ku-POST /api/v1/conversations. I-Sonny ithola noma idale oxhumana naye nge-imeyili, igcine izimpendulo, bese ivula ingxoxo engenayo esiteshini se-imeyili somthombo owukhethile. Ithimba lesiteshi, imithetho yokwabela, nezaziso kuyasebenza. Ama-ejenti aphendula nge-imeyili.

Dala ukhiye one-conversations:write ne-contacts:write. Ungawukhawulela eziteshini ezikhethiwe zeklayenti. Thola i-ID yomthombo nge-GET /api/v1/sources, nayo edinga i-conversations:read.
Ku-n8n, engeza i-node ye-HTTP Request: indlela POST, i-URL https://www.usesonny.com/api/v1/conversations. Gcina ukhiye ku-credential ye-Header Auth: Authorization enenani elithi Bearer sonny_your_key.
Vula i-Send Body, khetha i-JSON ne-Using JSON, bese ushintshela yonke inkambu ye-JSON ku-Expression bese unamathisela lesi sibonelo. Shintsha i-ID yomthombo bese uxhumanisa izinkambu zokufaka nefomu lakho. Sebenzisa i-ID yokuthunyelwe yefomu ezinzile neyingqayizivele ukuze ukuzama futhi kusebenzise inani 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
} }}

Ukuze uthole ezinye izinketho ze-node, bona i-n8n HTTP Request guide. Ithuluzi le-MCP elilinganayo yi-create_conversation, eline-payload nezimvume ezifanayo.

Amagama ezinkambu amasha aba izimfanelo zombhalo. Izinkambu ezikhona zenombolo, ze-URL, zosuku nezokukhetha kufanele zithole amanani ombhalo avumelekile; inani elingalungile libuyisa i-422 elisho inkambu futhi akukho okulondolozwayo. Izinsuku zamukela izinsuku noma izitembu zesikhathi ze-ISO; amanani okukhetha kufanele afane nenketho. Kwamukelwa izinkambu ezifika ku-50, ezinamagama afika ezinhlamvwini ezingu-100 namanani afika ku-5,000. Izimfanelo zivela kulowo oxhumana naye nasebhokisini eliseceleni lengxoxo. Yomibili imizimba yemilayezo igcina ikhophi yezimpendulo, nalapho uhlinzeka nge-htmlMessage engaphoqelekile.

I-tags engaphoqelekile yamukela ama-ID amathegi endawo yokusebenza akhona afika ku-20. Impendulo iqukethe i-conversation, isifinyezo se-contact, i-message, ne-deduplicated. Okuthunyelwe okusha kubuyisa i-201. Ukusebenzisa futhi i-externalId emthonjeni ofanayo kubuyisa i-200 enama-ID okuqala ne-deduplicated: true; okuqukethwe okushintshile akunakwa. Ngaphandle kwe-ID yangaphandle, yonke ikholi idala ingxoxo entsha. Okunamathiselwe lapho kudalwa nezimpendulo ezizenzakalelayo ze-AI akusekelwa.

Ukugeleza komsebenzi kwama-ejenti

Hlunga, wenze, futhi uhlale uvumelana

I-REST ne-MCP zabelana ngezimvume nokugeleza komsebenzi okufanayo. Imininingwane yokungena ingakwazi kuphela ukunciphisa ukufinyelela kwakho kwamanje eziteshini; ukususa isiteshi kubulungu bakho kuyasisusa nasekuhlanganisweni kwakho.

Thola izingxoxo ezidinga ukunakwa

Hlunga nge-awaitingReply, unread, unassigned, assigneeId, agentGroupId, snoozed, priority, noma tagIds. I-awaitingReply ayinaki amanothi angaphakathi; i-unread ingeyozakwenu oqinisekisiwe kuphela. I-unassigned isho ukuthi akekho owabelwe ngamunye, ngisho noma ithimba labelwe. Amathegi afana nanoma iyiphi i-ID ehlinzekiwe.

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

Hlela nge-waitingSince, lastMessageAt, createdAt, noma ukubaluleka kwebhizinisi ngendlela asc noma desc. Ama-ID ahlukanisa lapho kulingana. Izihlungi ezishiyiwe zigcina i-compact=false ne-snoozed=any. I-tagIds ye-REST yamukela ama-ID ahlukaniswe ngokhefana; i-MCP yamukela ne-array. I-waitingSince iqala emlayezweni wokuqala ongenayo ngemuva kwempendulo yokugcina; ukulandelela namanothi angaphakathi akuyiqali kabusha. Yenza lokhu kuskena kolayini olindile ngesheduli ngisho noma ingekho i-webhook efikayo, ukuze izingxoxo ezindala ziphinde zivele.

Landela ngaphandle kokuphinda ufunde i-inbox

Sebenzisa i-GET /api/v1/sync ne-conversations:read. I-feed eqinile ifaka izinguquko zezingxoxo, amathegi, imilayezo, izimfanelo zoxhumana nabo, izinkumbulo, namarekhodi okususa. I-payload ngayinye idinga nomkhawulo wayo wokufunda: imizimba yemilayezo idinga i-messages:read futhi izinkumbulo zidinga i-contact-memory:read. Imininingwane yokungena ekhawulelwe ithola iziteshi ezivunyelwe kuphela.

Qala ngaphandle kwe-cursor, landela i-nextCursor kuze kube yilapho i-hasMore iba false, bese ulondoloza leyo cursor.
Funda uhlu lwamanje lwezingxoxo/oxhumana nabo nanoma imuphi umlando owudingayo ukuze uthole isimo sakho sokuqala.
Phinda udlale kusuka ku-cursor egciniwe ukuze ubambe izinguquko ezenzeke ngesikhathi ufunda. Cubungula ikhasi ngalinye, bese ulondoloza i-nextCursor.

Susa okuphindwe kabili nge-id yomcimbi: ukuphinda kudlalwe okungenani kanye, ngakho izenzo ezilandelayo zidinga isivikelo sazo sokuphindwa. Isicelo esingenayo i-cursor sihlanganisa ihora lokugcina, hhayi isithombe esiphelele. Imicimbi igcinwa izinsuku ezingu-30; i-HTTP 410 resync_required isho ukuthi qala kabusha. Qala kabusha futhi ngemuva kokwandisa imikhawulo noma ukufinyelela eziteshini. Sebenzisa i-limit efika ku-100 ne-maxBodyChars efika ku-10,000 (okuzenzakalelayo ngu-500). Setha i-compact=true ukuze uthole izinkambu zemilayezo i-textPreview/textTruncated ezikhawulelwe ezinhlamvwini ezingu-200 esikhundleni se-body/bodyTruncated. Ama-webhook angavusa i-ejenti; i-feed ihlala itholakala ngaphandle kokubhalisela ama-webhook noma lapho ukulethwa kwama-webhook kusalele emuva.

Rekhoda ukuhlola kanye futhi wabelane ngomphumela

Ngaphambi kokuphinda uphenye, funda i-list_conversation_checks (GET /api/v1/conversations/{conversationId}/checks). Londoloza umphumela nge-record_conversation_check (PUT endleleni efanayo), uhlinzeke nge-key, result, checkedBy kanye ne-reference engaphoqelekile ye-ID yekhadi noma i-URL. Isibonelo: key=product-version, result=Shopstar Go verified, checkedBy=Engineer, reference=card-X. I-Sonny irekhoda i-actorId eqinisekisiwe nesitembu sesikhathi se-checkedAt. Ukusebenzisa futhi i-key kushintsha lokho kuhlola kuphela; lesi yisimo samanje, hhayi ilogi yomlando. Ukufunda kudinga i-conversations:read futhi ukubhala kudinga i-conversations:write, kokubili kukhawulelwe esiteshini sengxoxo. Lezi zikholi azithumeli impendulo futhi azimaki umthengisi njengophendulile.

Abela futhi ubuyekeze umsebenzi ngamaqoqo

Thola ozakwenu abasebenzayo nabangabelwa kanye namathimba nge-GET /api/v1/members and /teams (members:read). Izimpendulo zifaka ukutholakala nokufinyelela okusebenzayo eziteshini, ngaphandle kwamakheli e-imeyili. Sebenzisa i-conversations:write ukuze ushintshe i-status, priority, assigneeId, agentGroupId, snoozedUntil, snoozedUntilReply, addTagIds, noma removeTagIds.

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

I-round-robin ikhetha ilungu lethimba elitholakalayo elingafinyelela esiteshini sengxoxo. Uma lingekho ilungu elifanelekayo, isibuyekezo esisodwa sibuyisa i-409 futhi into esesiqoqweni iyehluleka. Iqoqo ngalinye lamukela ama-ID angafani afika ku-100 futhi lisebenzisa i-patch eyodwa ngokuphelele engxoxweni ngayinye. Hlola wonke umphumela we-{ id, ok, error? }; ezinye izinto zingase zehluleke. Amaqoqo asebenzisa umkhawulo wezicelo wamanje osekelwe ezicelweni, ngaphandle kokukhokhisa ngokwesisindo ngenani lezinto.

Yabelana ngomongo wekhasimende ne-Sonny AI

Bhala, londoloza, futhi ususe izinkumbulo zoxhumana nabo nge-contact-memory:read/write. Hlinzeka ngakho kokubili i-contactId ne-sourceId efinyelelekayo; oxhumana naye kufanele abe nengxoxo kulowo mthombo. Amaqiniso alondoloziwe asebenzisa ukuqinisekisa okufanayo, ukuphathwa kokuphindwayo, nemikhawulo efanayo nohlelo lokusebenza futhi arekhodwa njengezinkumbulo zesandla.

Funda izincazelo zezimfanelo ku-/api/v1/properties futhi ufunde noma usethe amanani ku-/api/v1/contacts/{contactId}/properties. I-MCP iveza i-list_properties, i-get_contact_properties, ne-set_contact_property. Lokhu kudinga i-contacts:read/write nokufinyelela kuzo zonke iziteshi. Setha i-propertyId eyodwa noma i-propertyName eyodwa ngqo, nenani lombhalo noma i-null ukuze ulisule. Amanani ombhalo, enombolo, e-URL, osuku, nawokukhetha aqinisekiswa ngokwencazelo yenkambu.

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

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

Izihlungi zezimfanelo zifana nemibhalo egciniwe eqondile; izimfanelo eziningi kufanele zonke zifane. Amanani abhalwe yi-API abhalwa ukuthi ayimininingwane ye-API ku-Co-Pilot nakumphenduli ozenzakalelayo. Imithetho ekhona yekhasimende eliqinisekisiwe neyomthombo isasebenza. Amanani ezinkambu zangaphakathi afakwe ngesandla ajwayelekile ahlala engafakiwe kulo mongo we-AI.

Funda imibiko efanayo nethimba lakho

Nge-reporting:read, biza i-GET /api/v1/reporting/{kind}. Izinhlobo yi-overview, volume, response-times, agents, sources, tags, csat, ai, knowledge, leads, ne-online-hours. I-overview ihlanganisa izibalo, izikhathi zokuphendula, ne-CSAT. Izihlungi yi-period (izinsuku ezingu-1–365, okuzenzakalelayo ngu-30), izinsuku ezibhangqiwe ze-from/to (i-to ayifakiwe), i-granularity (day/month), i-source, i-assigneeId, ne-tagId. I-source yamukela i-all, all-chat, all-email, website:{id}, noma email:{id}.

Imibiko isebenzisa ama-query edeshibhodi nokuhlolwa kokufinyelela kwamanje. I-knowledge isebenzisa izinsuku neziteshi ezivunyelwe, ngaphandle komthombo okhethiwe, owabelwe, noma ithegi. I-online-hours ilinganisa ukuba khona kozakwenu abafinyelelekayo endaweni yokusebenza; izibalo zayo zezingxoxo zihlala zikhawulelwe eziteshini. Ama-endpoint e-/csat akhona agcina umkhawulo wawo ohlukile we-csat:read futhi angase achaze iqembu elihlukile.

Thumela amafayela nezimpendulo noma amanothi angaphakathi

Nika i-attachments:write bese ulayisha ifayela elifika ku-25 MB lengxoxo. I-POST /api/v1/attachments ithatha izinkambu ze-multipart file ne-conversationId. Impendulo iqukethe i-id ne-expiresAt. Dlulisela ama-attachmentIds afika ku-10 empendulweni noma enothini kungakapheli ihora elilodwa. Okulayishiwe ngakunye kuboshelwe kumsebenzisi wakho nasengxoxweni futhi kungasetshenziswa kanye kuphela. Okulayishiwe okungasetshenziswanga kuyasuswa ngemuva kokuphelelwa yisikhathi.

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

Izimpendulo zidinga i-messages:send; amanothi angaphakathi adinga i-messages:write futhi awalokothi afike kumakhasimende. Imilayezo enokunamathiselwe kuphela iyasekelwa. Izimpendulo ze-imeyili zifaka amafayela ngaphakathi kosayizi ovunyelwe we-imeyili nezixhumanisi zokulanda zalokho okusele; ama-imeyili engxoxo engekho ku-inthanethi afaka izixhumanisi zamafayela. Izixhumanisi ezithunyelwe nge-imeyili zihlala zisebenza inqobo nje uma okunamathiselwe kusekhona, ukuze abamukeli bazivule kamuva. Ukudlulisela i-imeyili kwabelana ngokufinyelela kulawo mafayela. Hlola i-emailDeliveryStatus ukuze ubone ukwehluleka kokulethwa.

Ukufunda imilayezo okugunyaziwe kufaka i-downloadUrl, downloadExpiresAt, aiStatus, aiDescription, ne-aiExtractedText, kanye ne-videoTranscripts yamavidiyo axhunyiwe (Loom, Vimeo nabanye). Izixhumanisi zokulanda zihlala imizuzu engu-15; phinda ufunde umlayezo ukuze uthole izixhumanisi ezintsha. Okulayishwe okusha kwe-API/MCP kunesitoreji sangasese. Okunamathiselwe okudala kuhlala kungokomphakathi futhi kumakwe nge-access=legacy_public: i-URL yokuqala ayiphelelwa yisikhathi. Ukufunda umlayezo kuqala ukufunda izithombe zawo uma indawo yokusebenza ine-Sonny AI. Ukufundwa kwezithombe nemibhalo yamavidiyo kuqeda ngemuva nje kokufika komlayezo: uma kusekhona okusaqhubeka, impendulo iqala nge-readsInProgress, okuthi i-nextStep yayo inikeze ikholi eqondile okufanele uyenze. Dlulisela i-waitSeconds (efika ku-30) ukuze ukulinde esicelweni esisodwa. Imilayezo ye-widget ebonwa amakhasimende neyesikhathi sangempela ayilokothi ifake okukhishiwe noma imibhalo yamavidiyo.

Hlola izivumelwano eziphelele zezicelo nezimpendulo

Isisekelo solwazi

Vumelanisa kusuka emthonjeni wangaphandle

Vumelanisa ama-athikili nezigaba usebenzisa ama-ID angaphandle azinzile, ngenisa i-Markdown noma i-HTML, layisha izithombe, setha ukuhleleka, futhi uphathe izethameli zabafundi. Ukuphinda i-upsert kubuyekeza okuqukethwe okukhona.

Khetha i-sourceId yesiteshi sakho bese unika i-kb:read ne-kb:write. Gcina ukhiye we-API kuseva yakho futhi ukhawulele ukufinyelela kwawo eziteshini.
Dala isigaba, bese uvumelanisa i-athikili njengohlaka. Buyekeza ukufometha kwayo nokufinyelela ngaphambi kokushicilela.
Setha ukufinyelela kwesikhungo sosizo, shicilela, bese uhlola ukubuka komfundi. Sebenzisa ukuhlukaniswa kwamakhasi nama-ID angaphandle azinzile ezibuyekezweni zakamuva.

Landela umhlahlandlela ophelele wokuvumelanisa nge-REST

Phatha izethameli zamakhasimende

Dala amaqembu kusuka ezimfanelweni zamakhasimende aqinisekisiwe bese uwasebenzisa esikhungweni sosizo, esigabeni, noma ku-athikili. Yonke imikhawulo ezuzwe ngefa kufanele ifane. Imininingwane yokungena ye-API ne-MCP isebenza njengabasebenzi ngaphakathi kwemikhawulo yayo; buka kuqala futhi uhlole iseshini yangempela yekhasimende ukuze uhlole ukufinyelela komfundi.

Setha futhi uhlole izethameli zesikhungo sosizo