Generic inbound
Generic inbound-ը AiHummer-ի մեջ ունիվերսալ մուտքի կետն է։ Երբ ձեր աղբյուրի համար հատուկ կառուցված ալիք չկա — email-to-webhook ռելե, cron job, ներքին գործիք — դուք տեղադրում եք հաղորդագրությունը մեկ endpoint-ում, և այն մտնում է turn engine-ի մեջ, ինչպես ցանկացած այլ ալիքի հաղորդագրություն։
Endpoint-ը
Ուղարկեք մեկ JSON POST gateway-ին.
POST /v1/inbound/generic
Content-Type: application/json
X-AIHummer-Inbound-Secret: <hmac>
{
"channel": "my-app",
"external_id": "user-42",
"text": "Hello from my custom integration"
}Մարմինը կրում է երեք դաշտ.
channel— տրամաբանական ալիքի անունը, որ դուք ընտրում եք աղբյուրի համար։external_id— վերջնական օգտատիրոջ կամ զրույցի կայուն նույնացուցիչ։text— հաղորդագրության բովանդակություն։
Նույնականացում
Endpoint-ը պաշտպանված է HMAC-ով, որը կրվում է
X-AIHummer-Inbound-Secret վերնագրում, ստացված ընդհանուր
AIHUMMER_INBOUND_SECRET-ից։ Առանց վավեր ստորագրության հարցումները մերժվում են, այնպես որ
միայն այն կանչողները, որոնք ունեն secret-ը, կարող են ներարկել հաղորդագրություններ։
[!NOTE] Gateway-ը պետք է ունենա կարգավորված լռելյայն workspace (
AIHUMMER_DEFAULT_WORKSPACE_ID)՝ generic inbound հաղորդագրությունները ուղարկելու համար։
Հասանելի / նախադիտման կոնեկտորներ
AiHummer-ն առաջարկում է լրացուցիչ ալիքի կոնեկտորներ նախադիտման ռեժիմում. դրանք արդեն
իրականացված են, բայց դեռ վավերացված չեն կենդանի հաշիվների դեմ։ Յուրաքանչյուրը տեղադրվում է
Marketplace-ից, աշխատում է host-native իր սեփական պորտում և փոխանցում է մուտքային
հաղորդագրությունները /v1/inbound/generic-ին։
| Կոնեկտոր | Պորտ | Նշումներ |
|---|---|---|
| Discord | 8801 | |
| Slack | 8802 | |
| Matrix | 8803 | |
| Signal | 8804 | պահանջում է signal-cli sidecar |
| Microsoft Teams | 8805 | |
| Email (IMAP/SMTP) | 8806 | |
| WhatsApp Cloud API | 8807 |
[!WARNING] Վերաբերվեք այս կոնեկտորներին որպես հասանելի / նախադիտում։ Դրանք իրականացված են, բայց կենդանի ապացուցված չեն իրական մատակարարի հաշիվների դեմ — վավերացրեք դրանք ձեր սեփական միջավայրում, նախքան արտադրությունում դրանց վրա հույս դնելը։
Բրաուզերի ընդլայնումը
AiHummer-ը նաև մատակարարում է բրաուզերի ընդլայնում՝ Manifest V3 կողմնակի վահանակի զրույցի
մակերես։ Այն /v1/chat/completions-ի հաճախորդ է, որն օգտագործում է
անձնական ah- API key — ոչ թե սերվերի կողմի ալիք։ Օգտագործեք այն անձնական,
բրաուզերի ներսում զրույցի համար, այլ ոչ թե որպես ուղղորդման մուտքային աղբյուր։
Ուր հաջորդիվ
- Արտադրական զրույցի համար տեսեք Telegram և MAX։
- Անձնակազմի IM-ի համար տեսեք Bitrix24։
- Կառուցո՞ւմ եք API-ի դեմ։ Տեսեք chat/completions։