Sahifa mazmuniga oʻtish
Hujjatlar
Make Agent Fast hujjatlari

API maʼlumotnomasi

Barcha ochiq resurs, metod, kerakli ruxsat, sahifalash qoidasi va o‘zgartirish shartnomasini toping.

Qisqacha koʻrinish

Barcha ochiq resurs, metod, kerakli ruxsat, sahifalash qoidasi va o‘zgartirish shartnomasini toping.

API soʻrovi yoʻliCheklangan kalit → versiyalangan resurs → imzolangan javob
Ilova / SDKBearer kalitimaf_live_…/api/v1/…ResursJSON
v1123 ta amalJSON

Kanonik mashina o‘qiydigan shartnoma — OpenAPI JSON. Bu sahifa inson o‘qiydigan amallar indeksi va barcha endpointlar uchun umumiy qoidalarni tushuntiradi.

Asosiy URL va versiya#

https://makeagent.fast/api/v1

Asosiy versiya yo‘lning bir qismi. Yangi qo‘shimcha maydonlar major versiyasiz paydo bo‘lishi mumkin, shuning uchun nomaʼlum javob maydonlarini eʼtiborsiz qoldiring. Barcha boshqaruv so‘rovlari HTTPS va bearer API kaliti yoki OAuth access tokendan foydalanadi.

Umumiy sarlavhalar#

Authorization: Bearer maf_live_...
Accept: application/json
Content-Type: application/json
Idempotency-Key: your-stable-operation-key

Content-Type POST va PATCH JSON tanalari, jumladan {} uchun majburiy. Idempotency-Key ixtiyoriy, ammo har bir POST, PATCH va DELETE uchun qatʼiy tavsiya qilinadi.

Hisob va saytlar#

MetodYo‘lRuxsatVazifasi
GET/meaccount:readHisob, tarif, huquq va hamyon xulosasini o‘qish
GET/sitessites:readEgaga tegishli saytlarni ro‘yxatlash
POST/sitessites:writeSayt va standart agentini yaratish
GET/sites/{site_id}sites:readBitta tegishli saytni olish
PATCH/sites/{site_id}sites:writeXavfsiz sayt maydonlarini yangilash
DELETE/sites/{site_id}sites:writeSaytni va unga bog‘liq resurslarni o‘chirish
POST/sites/{site_id}/publishsites:write{ "published": boolean } bilan nashr qilish yoki olish
GET/sites/{site_id}/agentagents:readAgent sozlamalarini o‘qish
PATCH/sites/{site_id}/agentagents:writePersona rejimi, vazifa, ko‘rinadigan nom, ko‘rsatma, ovoz, til, model, ko‘rinish, embed qobig‘i, nishon, embed holati yoki manzillarni yangilash
GET/sites/{site_id}/billingaccount:readTarif, davr, hamyon, qo‘shimchalar va boshqaruv panelidagi billing havolalarini o‘qish
PATCH/sites/{site_id}/workspaceteam:writeAgent egasi bo‘lgan kompaniya nomini o‘zgartirish
PATCH/sites/{site_id}/retentionteam:writeSuhbatlar qancha vaqt saqlanishini belgilash

Sayt yaratish title va content.headline talab qiladi. Ixtiyoriy maydonlarga slug, type, template, qo‘shimcha kontent, persona_mode va en, ko, uz, rudan bir-to‘rtta til kiradi.

PATCH /agent model, appearance, embed_chrome va badge_hidden maydonlarini boshqaruv panelidagi kabi tarif tekshiruvidan o‘tkazadi; badge_hidden: true mos tarif yoki nishon qo‘shimchasini talab qiladi.

O‘rnatish va sayt vidjeti#

MetodYo‘lRuxsatVazifasi
GET/sites/{site_id}/installagents:readO‘rnatish manzili, embed holati, ruxsat etilgan manzillar va o‘rnatish dalillarini o‘qish
PATCH/sites/{site_id}/installagents:writeVidjet o‘rnatilishi kerak bo‘lgan sahifani belgilash
POST/sites/{site_id}/install/checkagents:writeEmbed snippeti maqsadli sahifada jonli ekanini tekshirish

Bilim va FAQʼlar#

MetodYo‘lRuxsatVazifasi
GET/sites/{site_id}/knowledgeknowledge:readBilim manbalarini ro‘yxatlash
POST/sites/{site_id}/knowledgeknowledge:writeKiritilgan matnni qabul qilish, saytni crawl qilish yoki YouTube, podcast yoki feed manbasini import qilish
PATCH/sites/{site_id}/knowledge/{source_id}knowledge:writerefresh_hours yoki buyer-pack approval_statusini o‘rnatish
POST/sites/{site_id}/knowledge/{source_id}/recrawlknowledge:writeOlingan manbani qayta o‘qishni navbatga qo‘yish; 202 qaytaradi
DELETE/sites/{site_id}/knowledge/{source_id}knowledge:writeBitta manbani kelajakdagi qidiruvdan o‘chirish
GET/sites/{site_id}/faqsknowledge:readTuzilmali FAQʼlarni ro‘yxatlash
POST/sites/{site_id}/faqsknowledge:write{ "question", "answer", "approved" } yaratish
POST/sites/{site_id}/faqs/generateknowledge:writeAgent bilimidan FAQ qoralamalarini tayyorlash
POST/sites/{site_id}/faqs/approve-allknowledge:writeBarcha FAQ qoralamalarini tasdiqlash va eʼlon qilish
PATCH/sites/{site_id}/faqs/{faq_id}knowledge:writeSavol, javob yoki tasdiq holatini yangilash
DELETE/sites/{site_id}/faqs/{faq_id}knowledge:writeFAQʼni o‘chirish
GET / PATCH/sites/{site_id}/fact-sheetknowledge:read / knowledge:writeAjratib olingan biznes faktlar varag‘ini o‘qish yoki noto‘g‘ri ajratilgan faktlarni almashtirish
POST/sites/{site_id}/fact-sheet/reextractknowledge:writeSaytni qayta o‘qib, faktlar varag‘ini qayta qurish
POST/sites/{site_id}/qaknowledge:writeTanlangan savol-javob juftliklarini eʼlon qilish
POST/sites/{site_id}/answers/reviseknowledge:writeAgentga u berishi kerak bo‘lgan javobni o‘rgatish
GET/sites/{site_id}/knowledge-connectionsknowledge:readNotion, Drive va MCP bilim ulanishlarini ro‘yxatlash
GET/sites/{site_id}/knowledge-connections/connect-linksknowledge:readNotion yoki Drive ulanishini boshlaydigan panel URLʼlarini olish
PATCH / DELETE/sites/{site_id}/knowledge-connections/{connection_id}knowledge:writeSinxronlash davriyligi, tanlangan elementlar yoki import vositasini o‘rnatish; yoki ulanishni uzib, maʼlumotini tozalash
GET/sites/{site_id}/knowledge-connections/{connection_id}/itemsknowledge:readUlanish import qila oladigan sahifa, maʼlumotlar bazasi yoki fayllarni ro‘yxatlash
POST/sites/{site_id}/knowledge-connections/{connection_id}/syncknowledge:writeBilim ulanishini sinxronlashni navbatga qo‘yish

POST /knowledge uch xil tanani qabul qiladi: 5–200 000 belgili { "name", "text" }; saytni crawl qilish uchun { "url", "max_pages", "refresh_hours" } (max_pages 1–40, refresh_hours 1–8 760 yoki null); va { "kind": "youtube" | "podcast" | "feed", "url", "refresh_hours" }. YouTube, podcast va feed manbalari Operate yoki Scale talab qiladi; Launch’da ular 409 conflict qaytaradi. Fayl yuklash boshqaruv paneli jarayoni bo‘lib qoladi.

Suhbatlar, lidlar, tahlil va foydalanish#

MetodYo‘lRuxsatVazifasi
GET/sites/{site_id}/conversationsconversations:readSuhbatlarni ro‘yxatlash
GET/sites/{site_id}/conversations/{conversation_id}conversations:readSuhbat va sahifalangan xabarlarini olish
POST/sites/{site_id}/conversations/{conversation_id}/replyconversations:writeTashrifchiga biznes nomidan javob berish
POST/sites/{site_id}/conversations/{conversation_id}/pauseconversations:writeShu suhbatda agentni pauzaga qo‘yib, suhbatni o‘z qo‘lingizga olish
POST/sites/{site_id}/conversations/{conversation_id}/resumeconversations:writeSuhbatni agentga qaytarish
GET/sites/{site_id}/leadsleads:readYig‘ilgan lidlarni ro‘yxatlash
POST/sites/{site_id}/leadsleads:writeAniq rozilik va aloqa tanlovi bilan canonical lid yaratish
GET/sites/{site_id}/leads/{lead_id}leads:readBitta lidni olish
PATCH/sites/{site_id}/leads/{lead_id}leads:writeLidni yangilash, qualify qilish yoki aloqa siyosatini o‘zgartirish
POST/sites/{site_id}/leads/{lead_id}/acceptleads:writeLidni imkoniyat pipelineʼiga qabul qilish
POST/sites/{site_id}/leads/{lead_id}/followupleads:writeLidga keyingi aloqa xabarini yuborish
POST/sites/{site_id}/leads/{lead_id}/followup/draftleads:writeKeyingi aloqa xabarini yubormasdan qayta tayyorlash
GET/sites/{site_id}/analyticsanalytics:readTahlil hodisalarini ro‘yxatlash
GET/sites/{site_id}/reportanalytics:readJamlangan tahlil hisobotini o‘qish
POST/sites/{site_id}/report/unanswered-faqknowledge:writeJavobsiz savolga yangi FAQ sifatida javob berish
GET/sites/{site_id}/usageusage:readO‘lchangan foydalanish hodisalarini ro‘yxatlash

Bu hodisa va faollik to‘plamlari limit va cursor qabul qiladi. Qaytgan yozuvlarda shaxsiy maʼlumot bo‘lishi mumkin; ularni maxfiylik majburiyatingizga muvofiq saqlang va eksport qiling.

Egasining javoblari qo‘llab-quvvatlanadi: reply, pause va resume veb suhbatni yoki Telegram, WhatsApp, Messenger yoki Instagram chatini boshqaruv panelidagi kabi o‘z qo‘lingizga oladi. Tashrifchi nomidan xabar yuborish ochiq API amali emas. Lid o‘zgartirish qo‘llanadi, ammo himoya qilinadigan rozilik yozuvisiz consent_status: granted o‘rnatmang. Nomaʼlum rozilik ommaviy xabardan chiqariladi.

Imkoniyat pipelineʼi va CRM natijalari#

MetodYo‘lRuxsatVazifasi
GET / POST/sites/{site_id}/pipeline/stagespipeline:read / pipeline:writeBosqichlarni ko‘rish yoki sozlash
GET / POST/sites/{site_id}/pipeline/accountspipeline:read / pipeline:writeBiznes hisoblarini ko‘rish yoki yaratish
GET/sites/{site_id}/pipeline/accounts/{account_id}pipeline:readBiznes hisobini olish
GET / POST/sites/{site_id}/pipeline/opportunitiespipeline:read / pipeline:writeImkoniyatlarni ko‘rish yoki yaratish
GET / PATCH/sites/{site_id}/pipeline/opportunities/{opportunity_id}pipeline:read / pipeline:writeFaollikni o‘qish yoki masʼul, qiymat, bosqich, keyingi amal va inson javobini yangilash
POST/sites/{site_id}/pipeline/outcomespipeline:writeCRM manbali won/lost natijani idempotent import qilish
GET/sites/{site_id}/pipeline/sync-recordspipeline:readSinxronlash holati, urinish va xatolarni ko‘rish
POST/sites/{site_id}/pipeline/sync-records/{sync_record_id}/retrypipeline:writeSaqlangan payload orqali muvaffaqiyatsiz natijani qayta urinish
GET / PATCH/sites/{site_id}/pipeline-workflowpipeline:read / pipeline:writeSavdo javob siyosatini o‘qish yoki yangilash
GET / POST/sites/{site_id}/pilotspipeline:read / pipeline:writeYo‘naltirilgan pilotlarni ro‘yxatlash yoki boshlash
GET/sites/{site_id}/pilots/{pilot_id}pipeline:readPilot, uning bosqichi, hisoblari va ish ro‘yxatini o‘qish
POST/sites/{site_id}/pilots/{pilot_id}/setup, /start, /stop, /review, /decision, /complete, /deletepipeline:writePilotni sozlash, o‘lchash, ko‘rib chiqish, qaror va yakunlash bosqichlaridan o‘tkazish yoki dalillari bilan o‘chirish (yetti amal)
POST/sites/{site_id}/pilots/{pilot_id}/outcomes, /bookingspipeline:writeLid natijasi yoki band qilish natijasini qayd etish (ikki amal)
POST/sites/{site_id}/pilots/{pilot_id}/report/approve, /report/revokepipeline:writeUlashiladigan pilot hisobotini tasdiqlash yoki bekor qilish (ikki amal)
GET / POST/sites/{site_id}/buyer-packspipeline:read / pipeline:writeBuyer packlarni ro‘yxatlash yoki tasdiqlangan manbalardan yangisini yaratish
PATCH/sites/{site_id}/buyer-packs/{pack_id}pipeline:writePack sarlavhasi, auditoriyasi, xulosasi, manbalari va bo‘limlarini almashtirish
POST/sites/{site_id}/buyer-packs/{pack_id}/approve, /revokepipeline:writePackning ulashish havolasini yoqish yoki o‘chirish (ikki amal)

Berilgan CRM provider, tashqi ID va idempotency kaliti audit tarixida qoladi. Qayta urinish faqat muvaffaqiyatsiz yozuvni talab qiladi va jarayondagi tashqi yozishni noto‘g‘ri muvaffaqiyat deb ko‘rsatmaydi.

Konnektorlar#

MetodYo‘lRuxsatVazifasi
GET/sites/{site_id}/connectorsconnectors:readSirlarni bermasdan konnektor holatini ro‘yxatlash
POST/sites/{site_id}/connectorsconnectors:writeKanalni ulash: hisob maʼlumotlarini jonli tekshirish, webhookini sozlash va sozlash ro‘yxatini qaytarish
PATCH/sites/{site_id}/connectors/{connector_id}connectors:writestatus yoki reply_with_voiceni o‘rnatish
DELETE/sites/{site_id}/connectors/{connector_id}connectors:writeKonnektorni provayderdan uzish va olib tashlash
POST/sites/{site_id}/conciergeconnectors:writePlatformadan xabar kanalini siz uchun ulab berishni so‘rash
GET/sites/{site_id}/domainsdomains:readOlib tashlangan — 409. Maxsus domenlar taklif etilmaydi
POST/sites/{site_id}/domainsdomains:writeOlib tashlangan — 409
PATCH/sites/{site_id}/domains/{domain_id}domains:writeOlib tashlangan — 409
POST/sites/{site_id}/domains/{domain_id}/verifydomains:writeOlib tashlangan — 409
DELETE/sites/{site_id}/domains/{domain_id}domains:writeOlib tashlangan — 409

Konnektor yaratish kanal bo‘yicha ajratilgan tanadan foydalanadi. credentials maydonlari telegram, whatsapp, messenger, instagram, discord va kakao uchun farq qiladi; sir yuborishdan oldin mos konnektor qo‘llanmasidan foydalaning.

Ommaviy xabar, bildirishnoma va monetizatsiya#

MetodYo‘lRuxsatVazifasi
GET/sites/{site_id}/broadcastsbroadcasts:readOmmaviy xabarlarni ro‘yxatlash
POST/sites/{site_id}/broadcastsbroadcasts:writeKakao ommaviy xabar qoralamasini yaratish
POST/sites/{site_id}/broadcasts/{broadcast_id}/sendbroadcasts:writeMavjud qoralamani navbatga qo‘yish; 202 qaytaradi
GET/sites/{site_id}/notificationsnotifications:readEga bildirishnomalarini ro‘yxatlash
POST/sites/{site_id}/notifications/read-allnotifications:writeShu agentning barcha ega bildirishnomalarini o‘qilgan deb belgilash
PATCH/sites/{site_id}/notifications/{notification_id}notifications:write{ "read": boolean } bilan o‘qilgan/o‘qilmagan deb belgilash
GET/sites/{site_id}/alertsnotifications:readEga ogohlantirish kanali holati va uning panel havolasini o‘qish
GET/sites/{site_id}/monetization/productsmonetization:readSayt mahsulotlarini ro‘yxatlash
POST/sites/{site_id}/monetization/productsmonetization:writeaccess, consult, tip yoki digital mahsulot yaratish
PATCH/sites/{site_id}/monetization/products/{product_id}monetization:writeMahsulot maydonlari va faol holatini yangilash
DELETE/sites/{site_id}/monetization/products/{product_id}monetization:writeMahsulotni o‘chirish

Ommaviy xabar yaratish hozir faqat kakao kanalini qabul qiladi. Yetib boriladigan qabul qiluvchi yo‘q yoki xabar qoralama bo‘lmasa, navbatga qo‘yish 409 conflict bilan ishlamaydi.

Harakatlar, chiptalar va jamoa#

MetodYo‘lRuxsatVazifasi
GET / PATCH/sites/{site_id}/actionsagents:read / agents:writeProtseduralar, ochiq webhook, band qilish havolasi va yordam chiptalarini o‘qish yoki sozlash
GET/sites/{site_id}/ticketstickets:readYordam chiptalarini ro‘yxatlash
GET/sites/{site_id}/tickets/{ticket_id}tickets:readChipta va uning xabarlarini o‘qish
PATCH/sites/{site_id}/tickets/{ticket_id}tickets:writeHolat, ustuvorlik va ixtiyoriy masʼulni belgilash
POST/sites/{site_id}/tickets/{ticket_id}/messagestickets:writeIchki izoh qo‘shish yoki mijozga email orqali javob berish uchun internal: false o‘rnatish
GET/sites/{site_id}/teamteam:readAʼzolar, takliflar va ruxsat etilgan audit hodisalarini o‘qish
POST/sites/{site_id}/team/invitationsteam:writeEmail yubormasdan taklif havolasini yaratish
DELETE/sites/{site_id}/team/invitations/{invitation_id}team:writeKutilayotgan taklifni bekor qilish
PATCH / DELETE/sites/{site_id}/team/members/{membership_id}team:writeEga bo‘lmagan aʼzoning rolini o‘zgartirish yoki aʼzoni olib tashlash

Dasturchi webhooklari va sozlash vositalari#

MetodYo‘lRuxsatVazifasi
GET/webhook-endpointswebhooks:readImzolash sirisiz endpoint holatini ro‘yxatlash
POST/webhook-endpointswebhooks:writeOchiq HTTPS URLʼni ro‘yxatdan o‘tkazish va imzolash sirini bir marta ko‘rsatish
DELETE/webhook-endpoints/{endpoint_id}webhooks:writeEndpointni o‘chirish va kelajakdagi yetkazishni to‘xtatish
GET/setup/toolsAny valid credentialAPI, MCP va GitHub integratsiyalari uchun sozlash vositalarini topish
POST/setup/tools/{tool_name}Tool-specificSozlash vositasini ishga tushirish; platforma so‘rovlari o‘z endpoint ruxsatlarini talab qiladi, GitHub tekshiruvi integrations:read, PR tayyorlash esa integrations:writedan foydalanadi

Webhook URL HTTPS ishlatishi, hisob maʼlumoti yoki maxsus port saqlamasligi va faqat ochiq IP manzillarga yechilishi kerak.

Sahifalash#

Sahifalangan to‘plamlar limit 1 dan 100 gacha qabul qiladi; standart 50. Qaytgan yopiq next_cursorni faqat bir xil to‘plam va filtr bilan ishlating.

{
  "data": [],
  "has_more": false,
  "next_cursor": null
}

Ayrim kichik sozlama to‘plamlari xuddi shu qobiqni has_more: false bilan qaytaradi va cursor talab qilmaydi.

Idempotency#

Idempotency kaliti harf, raqam, ., _, : va -dan iborat 8–200 belgi bo‘lishi kerak. Natijalar 24 soat saqlanadi va hisob maʼlumoti egasi bo‘yicha cheklanadi.

  • Bir xil kalit va bir xil metod, yo‘l, query hamda tana: saqlangan javobni x-idempotent-replayed: true bilan qaytaradi.
  • Bir xil kalit boshqa kiritma bilan: 409 conflict qaytaradi.
  • Birinchi so‘rov ishlayotganida bir xil kalit: 409 conflict va Retry-After: 2 qaytaradi.

O‘zgartirish yuborishdan oldin kalitni doimiy saqlang va faqat o‘sha mantiqiy amal qayta urinishlarida qayta ishlating.

Javoblar va xatolar#

Muvaffaqiyatli javob resursni data ichiga o‘raydi. Yaratish amali odatda 201, navbatdagi ommaviy yuborish 202, boshqa muvaffaqiyatli amal 200 qaytaradi. Har bir javobda x-request-id bor va API maʼlumoti uchun Cache-Control: no-store ishlatiladi.

To‘liq xato kodlari uchun Ruxsatlar va xatolar, nusxalanadigan jarayonlar uchun API retseptlariga qarang.

MCP mijozlari#

Streamable HTTP MCP mijozini https://makeagent.fast/api/mcp manziliga ulang. OAuth xizmatini avtomatik aniqlay oladigan mijozlar kirish va ruxsat berish uchun brauzerni ochadi. Tasdiqlashdan oldin mijoz identifikatori, kompaniya va so‘ralgan vakolatlarni tekshiring. Birinchi tasdiqlashda vositalar ishlatadigan vakolatlar so‘raladi (sites:read, sites:write, agents:write, analytics:read, conversations:read, conversations:write, leads:read, leads:write, knowledge:write); ulardan biri yo‘q hisob ma’lumotidan qayta tasdiqlash so‘raladi. Faol tarif zarur.

Qo‘lda sozlanadigan mijozlar uchun dasturchi sozlamalarida vakolatlari cheklangan API kalitini yarating va uni Authorization: Bearer ... sarlavhasida yuboring. Kalitlarni kod omboriga yoki brauzer kodiga joylamang. API kalitlari va OAuth ruxsatlarini dasturchi sozlamalarida bekor qilish mumkin.

O‘qish vositalari: list_agents, get_agent, get_report, list_unanswered_questions, list_conversations, get_conversation, list_leads. Yozish vositalari: create_agent_from_website, create_agent_from_notes, test_agent, add_knowledge, save_answer, reply_to_customer, update_lead, set_website_widget. Har bir agent vositasi list_agents qaytargan agent_idni qabul qiladi. test_agent oddiy javob kabi kredit sarflaydi; reply_to_customer mijozga xabar yuboradi va shu suhbatda agentni to‘xtatib turadi; set_website_widget saytdagi chat vidjetini yoqadi yoki o‘chiradi; messenjer kanallari boshqaruv panelida boshqariladi. MCP Apps yoqilgan mijozlar (sukut bo‘yicha autentifikatsiyalangan Claude ulanishi) qo‘shimcha ravishda list_pending_approvals, list_action_runs va mijoz tasdiqlagan o‘zgarishni tasdiqlaydigan yoki rad etadigan decide_approvalni oladi; boshqa mijozlar faqat yuqoridagi 15 ta vositani ko‘radi. Sozlash va GitHub integratsiyasi vositalari uchun ilova ichidagi sozlash yordamchisi yoki /api/v1/setup/toolsdan foydalaning.

Qo‘llab-quvvatlanadigan protokol versiyalari: 2026-07-28, 2025-11-25, 2025-06-18. Javoblar JSON formatida; eski SSE transporti va server seanslari mavjud emas. MCP OAuth tokenlari faqat /api/mcp uchun amal qiladi, bevosita REST so‘rovlari uchun emas. Kirish tokenlari bir soat amal qiladi; yangilash tokenlari almashtiriladi va 90 kundan so‘ng tugaydi. API kalitlari belgilangan amal qilish muddatiga ega.