API maʼlumotnomasi
Barcha ochiq resurs, metod, kerakli ruxsat, sahifalash qoidasi va o‘zgartirish shartnomasini toping.
Barcha ochiq resurs, metod, kerakli ruxsat, sahifalash qoidasi va o‘zgartirish shartnomasini toping.
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/v1Asosiy 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-keyContent-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#
| Metod | Yo‘l | Ruxsat | Vazifasi |
|---|---|---|---|
GET | /me | account:read | Hisob, tarif, huquq va hamyon xulosasini o‘qish |
GET | /sites | sites:read | Egaga tegishli saytlarni ro‘yxatlash |
POST | /sites | sites:write | Sayt va standart agentini yaratish |
GET | /sites/{site_id} | sites:read | Bitta tegishli saytni olish |
PATCH | /sites/{site_id} | sites:write | Xavfsiz sayt maydonlarini yangilash |
DELETE | /sites/{site_id} | sites:write | Saytni va unga bog‘liq resurslarni o‘chirish |
POST | /sites/{site_id}/publish | sites:write | { "published": boolean } bilan nashr qilish yoki olish |
GET | /sites/{site_id}/agent | agents:read | Agent sozlamalarini o‘qish |
PATCH | /sites/{site_id}/agent | agents:write | Persona 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}/billing | account:read | Tarif, davr, hamyon, qo‘shimchalar va boshqaruv panelidagi billing havolalarini o‘qish |
PATCH | /sites/{site_id}/workspace | team:write | Agent egasi bo‘lgan kompaniya nomini o‘zgartirish |
PATCH | /sites/{site_id}/retention | team:write | Suhbatlar 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#
| Metod | Yo‘l | Ruxsat | Vazifasi |
|---|---|---|---|
GET | /sites/{site_id}/install | agents:read | O‘rnatish manzili, embed holati, ruxsat etilgan manzillar va o‘rnatish dalillarini o‘qish |
PATCH | /sites/{site_id}/install | agents:write | Vidjet o‘rnatilishi kerak bo‘lgan sahifani belgilash |
POST | /sites/{site_id}/install/check | agents:write | Embed snippeti maqsadli sahifada jonli ekanini tekshirish |
Bilim va FAQʼlar#
| Metod | Yo‘l | Ruxsat | Vazifasi |
|---|---|---|---|
GET | /sites/{site_id}/knowledge | knowledge:read | Bilim manbalarini ro‘yxatlash |
POST | /sites/{site_id}/knowledge | knowledge:write | Kiritilgan matnni qabul qilish, saytni crawl qilish yoki YouTube, podcast yoki feed manbasini import qilish |
PATCH | /sites/{site_id}/knowledge/{source_id} | knowledge:write | refresh_hours yoki buyer-pack approval_statusini o‘rnatish |
POST | /sites/{site_id}/knowledge/{source_id}/recrawl | knowledge:write | Olingan manbani qayta o‘qishni navbatga qo‘yish; 202 qaytaradi |
DELETE | /sites/{site_id}/knowledge/{source_id} | knowledge:write | Bitta manbani kelajakdagi qidiruvdan o‘chirish |
GET | /sites/{site_id}/faqs | knowledge:read | Tuzilmali FAQʼlarni ro‘yxatlash |
POST | /sites/{site_id}/faqs | knowledge:write | { "question", "answer", "approved" } yaratish |
POST | /sites/{site_id}/faqs/generate | knowledge:write | Agent bilimidan FAQ qoralamalarini tayyorlash |
POST | /sites/{site_id}/faqs/approve-all | knowledge:write | Barcha FAQ qoralamalarini tasdiqlash va eʼlon qilish |
PATCH | /sites/{site_id}/faqs/{faq_id} | knowledge:write | Savol, javob yoki tasdiq holatini yangilash |
DELETE | /sites/{site_id}/faqs/{faq_id} | knowledge:write | FAQʼni o‘chirish |
GET / PATCH | /sites/{site_id}/fact-sheet | knowledge:read / knowledge:write | Ajratib olingan biznes faktlar varag‘ini o‘qish yoki noto‘g‘ri ajratilgan faktlarni almashtirish |
POST | /sites/{site_id}/fact-sheet/reextract | knowledge:write | Saytni qayta o‘qib, faktlar varag‘ini qayta qurish |
POST | /sites/{site_id}/qa | knowledge:write | Tanlangan savol-javob juftliklarini eʼlon qilish |
POST | /sites/{site_id}/answers/revise | knowledge:write | Agentga u berishi kerak bo‘lgan javobni o‘rgatish |
GET | /sites/{site_id}/knowledge-connections | knowledge:read | Notion, Drive va MCP bilim ulanishlarini ro‘yxatlash |
GET | /sites/{site_id}/knowledge-connections/connect-links | knowledge:read | Notion yoki Drive ulanishini boshlaydigan panel URLʼlarini olish |
PATCH / DELETE | /sites/{site_id}/knowledge-connections/{connection_id} | knowledge:write | Sinxronlash davriyligi, tanlangan elementlar yoki import vositasini o‘rnatish; yoki ulanishni uzib, maʼlumotini tozalash |
GET | /sites/{site_id}/knowledge-connections/{connection_id}/items | knowledge:read | Ulanish import qila oladigan sahifa, maʼlumotlar bazasi yoki fayllarni ro‘yxatlash |
POST | /sites/{site_id}/knowledge-connections/{connection_id}/sync | knowledge:write | Bilim 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#
| Metod | Yo‘l | Ruxsat | Vazifasi |
|---|---|---|---|
GET | /sites/{site_id}/conversations | conversations:read | Suhbatlarni ro‘yxatlash |
GET | /sites/{site_id}/conversations/{conversation_id} | conversations:read | Suhbat va sahifalangan xabarlarini olish |
POST | /sites/{site_id}/conversations/{conversation_id}/reply | conversations:write | Tashrifchiga biznes nomidan javob berish |
POST | /sites/{site_id}/conversations/{conversation_id}/pause | conversations:write | Shu suhbatda agentni pauzaga qo‘yib, suhbatni o‘z qo‘lingizga olish |
POST | /sites/{site_id}/conversations/{conversation_id}/resume | conversations:write | Suhbatni agentga qaytarish |
GET | /sites/{site_id}/leads | leads:read | Yig‘ilgan lidlarni ro‘yxatlash |
POST | /sites/{site_id}/leads | leads:write | Aniq rozilik va aloqa tanlovi bilan canonical lid yaratish |
GET | /sites/{site_id}/leads/{lead_id} | leads:read | Bitta lidni olish |
PATCH | /sites/{site_id}/leads/{lead_id} | leads:write | Lidni yangilash, qualify qilish yoki aloqa siyosatini o‘zgartirish |
POST | /sites/{site_id}/leads/{lead_id}/accept | leads:write | Lidni imkoniyat pipelineʼiga qabul qilish |
POST | /sites/{site_id}/leads/{lead_id}/followup | leads:write | Lidga keyingi aloqa xabarini yuborish |
POST | /sites/{site_id}/leads/{lead_id}/followup/draft | leads:write | Keyingi aloqa xabarini yubormasdan qayta tayyorlash |
GET | /sites/{site_id}/analytics | analytics:read | Tahlil hodisalarini ro‘yxatlash |
GET | /sites/{site_id}/report | analytics:read | Jamlangan tahlil hisobotini o‘qish |
POST | /sites/{site_id}/report/unanswered-faq | knowledge:write | Javobsiz savolga yangi FAQ sifatida javob berish |
GET | /sites/{site_id}/usage | usage:read | O‘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#
| Metod | Yo‘l | Ruxsat | Vazifasi |
|---|---|---|---|
GET / POST | /sites/{site_id}/pipeline/stages | pipeline:read / pipeline:write | Bosqichlarni ko‘rish yoki sozlash |
GET / POST | /sites/{site_id}/pipeline/accounts | pipeline:read / pipeline:write | Biznes hisoblarini ko‘rish yoki yaratish |
GET | /sites/{site_id}/pipeline/accounts/{account_id} | pipeline:read | Biznes hisobini olish |
GET / POST | /sites/{site_id}/pipeline/opportunities | pipeline:read / pipeline:write | Imkoniyatlarni ko‘rish yoki yaratish |
GET / PATCH | /sites/{site_id}/pipeline/opportunities/{opportunity_id} | pipeline:read / pipeline:write | Faollikni o‘qish yoki masʼul, qiymat, bosqich, keyingi amal va inson javobini yangilash |
POST | /sites/{site_id}/pipeline/outcomes | pipeline:write | CRM manbali won/lost natijani idempotent import qilish |
GET | /sites/{site_id}/pipeline/sync-records | pipeline:read | Sinxronlash holati, urinish va xatolarni ko‘rish |
POST | /sites/{site_id}/pipeline/sync-records/{sync_record_id}/retry | pipeline:write | Saqlangan payload orqali muvaffaqiyatsiz natijani qayta urinish |
GET / PATCH | /sites/{site_id}/pipeline-workflow | pipeline:read / pipeline:write | Savdo javob siyosatini o‘qish yoki yangilash |
GET / POST | /sites/{site_id}/pilots | pipeline:read / pipeline:write | Yo‘naltirilgan pilotlarni ro‘yxatlash yoki boshlash |
GET | /sites/{site_id}/pilots/{pilot_id} | pipeline:read | Pilot, uning bosqichi, hisoblari va ish ro‘yxatini o‘qish |
POST | /sites/{site_id}/pilots/{pilot_id}/setup, /start, /stop, /review, /decision, /complete, /delete | pipeline:write | Pilotni 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, /bookings | pipeline:write | Lid natijasi yoki band qilish natijasini qayd etish (ikki amal) |
POST | /sites/{site_id}/pilots/{pilot_id}/report/approve, /report/revoke | pipeline:write | Ulashiladigan pilot hisobotini tasdiqlash yoki bekor qilish (ikki amal) |
GET / POST | /sites/{site_id}/buyer-packs | pipeline:read / pipeline:write | Buyer packlarni ro‘yxatlash yoki tasdiqlangan manbalardan yangisini yaratish |
PATCH | /sites/{site_id}/buyer-packs/{pack_id} | pipeline:write | Pack sarlavhasi, auditoriyasi, xulosasi, manbalari va bo‘limlarini almashtirish |
POST | /sites/{site_id}/buyer-packs/{pack_id}/approve, /revoke | pipeline:write | Packning 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#
| Metod | Yo‘l | Ruxsat | Vazifasi |
|---|---|---|---|
GET | /sites/{site_id}/connectors | connectors:read | Sirlarni bermasdan konnektor holatini ro‘yxatlash |
POST | /sites/{site_id}/connectors | connectors:write | Kanalni ulash: hisob maʼlumotlarini jonli tekshirish, webhookini sozlash va sozlash ro‘yxatini qaytarish |
PATCH | /sites/{site_id}/connectors/{connector_id} | connectors:write | status yoki reply_with_voiceni o‘rnatish |
DELETE | /sites/{site_id}/connectors/{connector_id} | connectors:write | Konnektorni provayderdan uzish va olib tashlash |
POST | /sites/{site_id}/concierge | connectors:write | Platformadan xabar kanalini siz uchun ulab berishni so‘rash |
GET | /sites/{site_id}/domains | domains:read | Olib tashlangan — 409. Maxsus domenlar taklif etilmaydi |
POST | /sites/{site_id}/domains | domains:write | Olib tashlangan — 409 |
PATCH | /sites/{site_id}/domains/{domain_id} | domains:write | Olib tashlangan — 409 |
POST | /sites/{site_id}/domains/{domain_id}/verify | domains:write | Olib tashlangan — 409 |
DELETE | /sites/{site_id}/domains/{domain_id} | domains:write | Olib 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#
| Metod | Yo‘l | Ruxsat | Vazifasi |
|---|---|---|---|
GET | /sites/{site_id}/broadcasts | broadcasts:read | Ommaviy xabarlarni ro‘yxatlash |
POST | /sites/{site_id}/broadcasts | broadcasts:write | Kakao ommaviy xabar qoralamasini yaratish |
POST | /sites/{site_id}/broadcasts/{broadcast_id}/send | broadcasts:write | Mavjud qoralamani navbatga qo‘yish; 202 qaytaradi |
GET | /sites/{site_id}/notifications | notifications:read | Ega bildirishnomalarini ro‘yxatlash |
POST | /sites/{site_id}/notifications/read-all | notifications:write | Shu 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}/alerts | notifications:read | Ega ogohlantirish kanali holati va uning panel havolasini o‘qish |
GET | /sites/{site_id}/monetization/products | monetization:read | Sayt mahsulotlarini ro‘yxatlash |
POST | /sites/{site_id}/monetization/products | monetization:write | access, consult, tip yoki digital mahsulot yaratish |
PATCH | /sites/{site_id}/monetization/products/{product_id} | monetization:write | Mahsulot maydonlari va faol holatini yangilash |
DELETE | /sites/{site_id}/monetization/products/{product_id} | monetization:write | Mahsulotni 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#
| Metod | Yo‘l | Ruxsat | Vazifasi |
|---|---|---|---|
GET / PATCH | /sites/{site_id}/actions | agents:read / agents:write | Protseduralar, ochiq webhook, band qilish havolasi va yordam chiptalarini o‘qish yoki sozlash |
GET | /sites/{site_id}/tickets | tickets:read | Yordam chiptalarini ro‘yxatlash |
GET | /sites/{site_id}/tickets/{ticket_id} | tickets:read | Chipta va uning xabarlarini o‘qish |
PATCH | /sites/{site_id}/tickets/{ticket_id} | tickets:write | Holat, ustuvorlik va ixtiyoriy masʼulni belgilash |
POST | /sites/{site_id}/tickets/{ticket_id}/messages | tickets:write | Ichki izoh qo‘shish yoki mijozga email orqali javob berish uchun internal: false o‘rnatish |
GET | /sites/{site_id}/team | team:read | Aʼzolar, takliflar va ruxsat etilgan audit hodisalarini o‘qish |
POST | /sites/{site_id}/team/invitations | team:write | Email yubormasdan taklif havolasini yaratish |
DELETE | /sites/{site_id}/team/invitations/{invitation_id} | team:write | Kutilayotgan taklifni bekor qilish |
PATCH / DELETE | /sites/{site_id}/team/members/{membership_id} | team:write | Ega bo‘lmagan aʼzoning rolini o‘zgartirish yoki aʼzoni olib tashlash |
Dasturchi webhooklari va sozlash vositalari#
| Metod | Yo‘l | Ruxsat | Vazifasi |
|---|---|---|---|
GET | /webhook-endpoints | webhooks:read | Imzolash sirisiz endpoint holatini ro‘yxatlash |
POST | /webhook-endpoints | webhooks:write | Ochiq HTTPS URLʼni ro‘yxatdan o‘tkazish va imzolash sirini bir marta ko‘rsatish |
DELETE | /webhook-endpoints/{endpoint_id} | webhooks:write | Endpointni o‘chirish va kelajakdagi yetkazishni to‘xtatish |
GET | /setup/tools | Any valid credential | API, MCP va GitHub integratsiyalari uchun sozlash vositalarini topish |
POST | /setup/tools/{tool_name} | Tool-specific | Sozlash 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: truebilan qaytaradi. - Bir xil kalit boshqa kiritma bilan:
409 conflictqaytaradi. - Birinchi so‘rov ishlayotganida bir xil kalit:
409 conflictvaRetry-After: 2qaytaradi.
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.