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

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 "X-AIHummer-Signature: $SIGNATURE" \
  -H "Content-Type: application/json" \
  -d '{
    "channel": "zapier",
    "external_id": "lead-99",
    "text": "New lead captured from the contact form."
  }'

# 1) Open a session
curl https://your-aihummer.example/v1/web/session \
  -H "Content-Type: application/json" \
  -d '{}'

# 2) Stream responses (Server-Sent Events)
curl -N https://your-aihummer.example/v1/web/stream

# Subscribe from the beginning
curl -N https://your-aihummer.example/v1/events/stream

# Resume after a known cursor
curl -N "https://your-aihummer.example/v1/events/stream?since=<cursor>"

OpenAI-თან თავსებად API-ს გარდა, AiHummer იღებს **შემომავალ შეტყობინებებს** კონექტორებიდან, ავტომატიზაციის პლატფორმებიდან და ბრაუზერის ვიჯეტიდან, და გამოსცემს **სერვერის მხარის მოვლენების სტრიმს**, რომელზეც შეგიძლიათ გამოწერა. ეს endpoint-ები არის ის, თუ როგორ აწვდიან გარე სისტემები სამუშაოს gateway-ს და როგორ რჩება UI-ები ცოცხალი. ## შემომავალი endpoint-ები შემომავალი endpoint-ები არის ის, თუ როგორ გადასცემენ არხის კონექტორები და მორგებული ინტეგრაციები შეტყობინებას ბრუნვის ძრავას. ისინი დაცულია **HMAC საზიარო საიდუმლოთი**, რომელიც იგზავნება `X-AIHummer-Inbound-Secret` ჰედერში (კონფიგურირებულია `AIHUMMER_INBOUND_SECRET`-ით). | მეთოდი და path | დანიშნულება | |---|---| | `POST /v1/inbound/telegram` | მშობლიური Telegram შემომავალი payload-ები | | `POST /v1/inbound/generic` | ზოგადი შემომავალი email→webhook, 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] > ზოგად შემომავალ დისპეტჩერს სჭირდება ნაგულისხმევი workspace. დააყენეთ > `AIHUMMER_DEFAULT_WORKSPACE_ID` რათა შემომავალი შეტყობინებები მარშრუტიზებადი იყოს. > [!WARNING] > შემომავალი endpoint-ები არ არის დაცული `ah-` API-გასაღებით — ისინი ეყრდნობიან > `X-AIHummer-Inbound-Secret` HMAC-ს. შეინახეთ ეს საიდუმლო კლიენტის-მხარის კოდის გარეთ და > შეცვალეთ თუ ის გაჟონავს. ## ინტეგრაციის ტრიგერები (Zapier / Make) `POST /v1/integrations/trigger` არის შესასვლელი წერტილი low-code ავტომატიზაციის პლატფორმებისთვის, როგორებიცაა **Zapier** და **Make**. ის იღებს ან `X-AIHummer-Signature` HMAC-ს ან Bearer ტოკენს. ```bash curl https://your-aihummer.example/v1/integrations/trigger \ -H "X-AIHummer-Signature: $SIGNATURE" \ -H "Content-Type: application/json" \ -d '{ "channel": "zapier", "external_id": "lead-99", "text": "New lead captured from the contact form." }' ``` ## ვებ ვიჯეტი ჩასართავი ვებ ვიჯეტი იყენებს ორ endpoint-ს: ერთს სესიის გასახსნელად და ერთს ასისტენტის პასუხის სტრიმინგისთვის. | მეთოდი და path | დანიშნულება | |---|---| | `POST /v1/web/session` | ვიჯეტის სესიის გახსნა | | `GET /v1/web/stream` | ვიჯეტის პასუხების მიღება SSE-ის სახით | ```bash # 1) Open a session curl https://your-aihummer.example/v1/web/session \ -H "Content-Type: application/json" \ -d '{}' # 2) Stream responses (Server-Sent Events) curl -N https://your-aihummer.example/v1/web/stream ``` ## მოვლენების სტრიმი `GET /v1/events/stream` არის gateway-ის მოვლენების **განახლებადი** Server-Sent Events ნაკადი. გადააწოდეთ `?since=` კურსორი რათა განაახლოთ იქიდან, სადაც წინა კავშირი შეწყდა, ისე რომ ხელახალი დაკავშირება არასოდეს დაკარგავს მოვლენებს. ```bash # Subscribe from the beginning curl -N https://your-aihummer.example/v1/events/stream # Resume after a known cursor curl -N "https://your-aihummer.example/v1/events/stream?since=<cursor>" ``` > [!TIP] > განიხილეთ თითოეული მოვლენის მიერ ატარებული მნიშვნელობა როგორც შემდეგი `since` კურსორი. > ხელახალ დაკავშირებაზე, განმეორებით გაუშვით ამ კურსორიდან რათა გარანტირებული იყოს თქვენი > მომხმარებლისთვის სულ-მცირე-ერთხელ მიწოდება. ## სად შემდეგ - ტექსტური ბრუნვები OpenAI ზედაპირზე: [Chat Completions](/ka/v1.0/api/chat-completions). - მოწყობილობის დაწყვილება, SSO ფედერაცია და პროტოკოლის ზედაპირები: [Webhooks, SCIM და დაწყვილება](/ka/v1.0/api/webhooks-scim-pairing). - ყველა `AIHUMMER_*` სახელური: [გარემოს ცვლადები](/ka/v1.0/reference/env-vars).