მოსული და ინტეგრაციის ტრიგერები

curl https://your-aihummer.example/v1/inbound/generic \
  -H "X-AIHummer-Inbound-Secret: $AIHUMMER_INBOUND_SECRET" \
  -H "Content-Type: application/json" \
  -d '{
    "channel": "email",
    "external_id": "ticket-4821",
    "text": "A customer asks whether order #4821 has shipped."
  }'

curl https://your-aihummer.example/v1/integrations/trigger \
  -H "Authorization: Bearer $AIHUMMER_INBOUND_TRIGGER_SECRET" \
  -H "Content-Type: application/json" \
  -d '{
    "channel": "zapier",
    "external_id": "lead-99",
    "text": "New lead captured from the contact form."
  }'

# Subscribe from the beginning
curl -N -H "Authorization: Bearer ah-..." \
  "https://your-aihummer.example/v1/events/stream?workspace_id=<id>"

# Resume after a known cursor
curl -N -H "Authorization: Bearer ah-..." \
  "https://your-aihummer.example/v1/events/stream?workspace_id=<id>&since=<cursor>"

OpenAI-სთან თავსებადი API-ს გარდა, AiHummer აღიქვამს **მიღებული შეტყობინებები** კონექტორებიდან და ავტომატიზაციის პლატფორმებიდან და გამოსხივებს **ღონისძიებების ნაკადი სერვერის მხარეს** რომელზეც შეგიძლიათ გამოწერა. ამ დასრულებადი წერტილებით გარე სისტემები გადაეცემიან მუშაობას გეითვეისთვის, ხოლო მომხმარებლის ინტერფეისები რჩებიან აქტიურები. ## შემოსული ბოლო წერტილები შემომავალი ბოლო წერტილებით არხების კონექტორები და სპეციალური ინტეგრაციები შეტყობინებებს დამუშავების ძრავაში გზავნიან. მათ იცავს `X-AIHummer-Inbound-Secret` სათაურით გადაცემული **საერთო HMAC საიდუმლო** (`AIHUMMER_INBOUND_SECRET` არის პარამეტრების კატალოგის გასაღები, რომელიც ადმინისტრაციული ინტერფეისის მართვა → პარამეტრები განყოფილებაში ან `aihummer settings set` ბრძანებით კონფიგურირდება და არა `gateway.env`-ში). | მეთოდი და გზა | მიზანი | |---|---| | `POST /v1/inbound/telegram` | Telegram-ის შემომავალი სასარგებლო მონაცემები | | `POST /v1/inbound/generic` | უნივერსალური შემომავალი ელ.ფოსტისთვის→ვებჰუკი, cron და მომხმარებლის აპლიკაციებისთვის | | `POST /v1/inbound/binding/status` | გაცნობა არხის მიბმულის მდგომარეობის შესახებ | ეს **საერთო** endpoint — ეს ყველაზე მარტივი გზა არის ნებისმიერი რესურსის გადაცემა AiHummer-ში. შეაგზავნეთ პატარა JSON არხის სახელით, სტაბილური გარე იდენტიფიკატორით და შეტყობინების ტექსტით: ```bash curl https://your-aihummer.example/v1/inbound/generic \ -H "X-AIHummer-Inbound-Secret: $AIHUMMER_INBOUND_SECRET" \ -H "Content-Type: application/json" \ -d '{ "channel": "email", "external_id": "ticket-4821", "text": "A customer asks whether order #4821 has shipped." }' ``` > [!NOTE] > უნივერსალური შემომავალი დისპეტჩერისთვის უნდა ჰქონდეს ნაგულისხმევი სამუშაო სივრცე. დააყენეთ > `AIHUMMER_DEFAULT_WORKSPACE_ID` ამიტომ შემომავალი შეტყობინებები შეიძლება მიეწოდოს. > [!WARNING] > შესასვლელი წერტილები დაცული არ არიან `ah-` API-კლიუი — ისინი მიეყრდნობიან > `X-AIHummer-Inbound-Secret` HMAC. შეინახეთ ეს საიდუმლო კოდი მომხმარებლის მხრიდან კოდიდან რაციონალურად და > მოაბრუნეთ იგი, თუ ის ცვივა. ## ინტეგრაციის ტრიგერები (Zapier / Make) `POST /v1/integrations/trigger` განიხილება როგორც შესასვლელი წერტილი დაბალი კოდის ავტომატიზაციის პლატფორმებისთვის, როგორიცაა **დაჯაჭვვა** და **აკეთებ**. წერტილი არის **დიახაა გათიშულია ნაგულისხმევად**: -მდე `AIHUMMER_INBOUND_TRIGGER_SECRET` კონფიგურაცია დასრულებულია, ის პასუხობს **`501 Not Implemented`**. ეს **საერთო** საიდუმლო, განსხვავებული `AIHUMMER_INBOUND_SECRET`; როგორც ყოველივე სათანარიგო კატალოგის გასაღები, ის განსაზღვრება ადმინისტრაციულ ინტერფეისში (მართვა → პარამეტრები) ან დახმარებით `aihummer settings set`. ქსელის დაყენების შემდეგ, საბოლოო წერტილი იღებს ან `X-AIHummer-Signature` HMAC ან წვდომის მარკერი სახე `Authorization: Bearer <the AIHUMMER_INBOUND_TRIGGER_SECRET value>`. ```bash curl https://your-aihummer.example/v1/integrations/trigger \ -H "Authorization: Bearer $AIHUMMER_INBOUND_TRIGGER_SECRET" \ -H "Content-Type: application/json" \ -d '{ "channel": "zapier", "external_id": "lead-99", "text": "New lead captured from the contact form." }' ``` ## Admin Sessions backend ეს ორი endpoint შენარჩუნებულია **Admin Sessions** გვერდის შიდა ტრანსპორტად. ისინი არ არის მომხმარებლის საიტში ჩასაშენებელი მხარდაჭერილი არხი. | მეთოდი და path | დანიშნულება | |---|---| | `POST /v1/web/session` | Admin Sessions დიალოგის გახსნა ან გაგრძელება | | `GET /v1/web/stream` | დიალოგის პასუხის SSE-ით მიღება | ## ობიექტების ნაკადი `GET /v1/events/stream` არის **გაგრძელებული** სერვერიდან გაგზავნილი მოვლენების ნაკადი კარიბჭის მოვლენების შესახებ. ეს endpoint ორი აუცილებელი მოთხოვნა აქვს: 1. **ეს `?workspace_id=<id>` პარამეტრი აუცილებელია** — ამ მოთხოვნის გარეშე იხრის `400`. ქირავნივრული მცველი ამოწმებს, რომ სამუშაო სივრცე ეკუთვნის ზარის მიმღები; ვინმე სხვა `workspace_id` მობი `403`. 2. **აჭკვირვება საჭირო არის** — ადმინისტრატორის სესია (ქუქი) ან `ah-` API საკეტი `Authorization: Bearer` სათაური. მის გარეშე პასუხი იქნება `401`. გამოტოვება `?since=` კურსორი იმისათვის, რომ განახლდეს იმ ადგილიდან, სადაც წინა კავშირი შეჩერდა, რათა განმეორებითი დაკავშირება არასოდეს დაკარგოს მოვლენები. ```bash # Subscribe from the beginning curl -N -H "Authorization: Bearer ah-..." \ "https://your-aihummer.example/v1/events/stream?workspace_id=<id>" # Resume after a known cursor curl -N -H "Authorization: Bearer ah-..." \ "https://your-aihummer.example/v1/events/stream?workspace_id=<id>&since=<cursor>" ``` > [!TIP] > განიხილეთ თითოეული მოვლენით გადატანილი მნიშვნელობა ასე შემდეგ `since` კურსორი. ჩართულია > ხელახლა დაკავშირება, აღდგენა იმ კურსორისაგან, რათა გარანტირებული გახდეს მინიმუმ ერთხელ მიღწევა თქვენს > მომხმარებელი. ## სად შემდეგ? - ტექსტი ღხრავს OpenAI-ს ზედაპირს: [ჩეთის დასრულება](/ka/v1.0/api/chat-completions). - მოწყობილობების გაერთიანება, SSO ფედერაცია და პროტოკოლური ინტერფეისები: [ვებჰუკები, SCIM და ინტეგრაცია](/ka/v1.0/api/webhooks-scim-pairing). - ყველა `AIHUMMER_*` პენები: [გარემოს ცვლადები](/ka/v1.0/reference/env-vars).