AiHummer
Eesti▾
SisselogimineKonto
v1.1.x▾
{ }Swagger

Bitrix24

v1.1.x · uuendatud 2026-10-14

Bitrix24 on sisemine töötajate kiirsuhtluskanal — sama roll, mida Telegram või Slack mängib töötajate jaoks. AiHummeri agent ilmub teie ettevõtte Bitrix24-sse kolleegina, kellele töötajad saavad sõnumeid saata ja kellele viidata.

Kanal laevadena kui toode sees olev ühendus Turg ja töötab hosti-sünnipäraselt. Seda saab seadistada Administraatori kasutajaliidese kaudu, nagu iga muud kanalit.

[!NOTE] Bitrix24 kanal nõuab aktiivset Algaja, Äri või Ettevõte litsents. Ühiskonnaplaanil annab pistiku installimine tagasi HTTP 402 „uuendamine vajalik“ (kood plan_limit) — see Litsentseerimine.

[!WARNING] Bitrix24 siin on rangelt sisemine töötajate IM-kanal. See on ei kliendi mitmekanaliline ei Bitrix24 avatud liinid ei pileti järjekord, ja ei operaatori-eskalatsiooni pind. Ära kasuta seda välist suunamiseks kliendivestlused.

Allolev meedia ja ühine OAuth eeldavad allkirjastatud Core 1.4.15 ning eraldi allkirjastatud ühendaja 1.1.1 avaldamist kataloogis ja uuendamist. Paigaldatud 1.1.0 ei kinnita nende võimaluste kättesaadavust.

Inimese sarnase agendi identiteet

Määrake eraldi portaali kasutajad võtmes BITRIX24_AGENT_USER_IDS ja portaal võtmes BITRIX24_PORTAL. Osakondade marsruutimine piirab töötajate ligipääsu; agendi konto ei asenda ülesande algatajat. Valikuline olemasolev automaatne seadistus kasutab BITRIX24_ADMIN_LOGIN / BITRIX24_ADMIN_PASSWORD.

Nimetatud versioonides valib BITRIX24_VAULT_CONNECTIONS olemasoleva, kehtiva, autonoomse OAuth-mandaadi, mis kuulub selle omanikule. Kasutage toetatud natiivset hoidla/ühenduste haldust; kasutage sama mandaadi ID-d tööriistaseostes. Tegelik omanik registreerib töötava ühendaja selle tööruumis aadressil /v1/admin/connections/channel eraldi connection-token võtmega. Pange endpoint ja apiKey agendi kasutaja ID järgi salajasse BITRIX24_VAULT_CONNECTIONS sättesse, mitte agendiprofiili ega viipadesse. Ainult hoidla värskendab tokeneid; tööriistad kontrollivad tegutsejat ja jagamist. Vt OAuth2.

Pordid ja jooksuaeg

Port Otstarve
8810 Ühendaja teenus loopback-aadressil: olek ja Deliver

Kuidas sõnumid voolavad

  • Sisend: küsitleja loeb sõnumeid. Meedia laaditakse alla baitidena ja registreeritakse /v1/inbound/media kaudu; agent saab media_id, mitte ainult URL-i või faili metaandmed.
  • Väljund: Deliver teisendab Markdowni BB-code’iks ja laadib tegelikud baidid üles im.v2.File.upload kaudu. Meedia kinnitamiseks on vaja tegelikke FILE_ID ja sõnumi ID-sid; tekst või link ei ole faili kviitung.

Säilitage uuendamisel püsiv kohaletoimetamise logi. Kinnitatud toimingu kordamine tagastab eelmise kviitungi. Osalist või teadmata mõju ei saadeta automaatselt uuesti; kontrollige seda enne kordamist.

Mis on toetatud

  • Reaktsioonid ja @-mainimised.
  • Kirjutamisnäidik ja vastused, kui konto ja teenusepakkuja toetavad im.dialog.writing ja REPLY_ID.
  • Saabuvad pildid, heli, hääl ja failid ülaltoodud versiooninõuetega.
  • Sõnumite muutmine/kustutamine ainult varasemates eraldi boti identiteediga integratsioonides; tavaliste OAuth-kasutajate jaoks neid ei deklareerita.

[!WARNING] Interaktiivseid klaviatuure, nuppe ja lõimesid ei toetata.

Loodud või ettevalmistatud fail ei tähenda kinnitatud kohaletoimetamist. Osalised, nurjunud ja teadmata tulemused peavad jääma nähtavaks.

Kuhu järgmine

  • Pistikute paigaldamisel: Turg.
  • Interaktiivsete klaviatuuride ja küsitluste jaoks kasutage Telegram või MAX.
  • Vaadake põhjastne tarbimis-API-sid Üldine sissetulev.