Bitrix24-laajennus

v1.0.x · päivitetty 2026-10-14

Bitrix24-laajennus yhdistää agenttisi Bitrix24:ään sisäisenä työntekijänä pikaviestintäkanavana. Henkilökunta lähettää viestin agentille samalla tavalla kuin lähettäisi viestin kollegalle, ja agentti vastaa Bitrix24:n chatissa.

[!WARNING] Bitrix24 tässä on sisäinen työntekijän pikaviestin-kanava — kuten Telegram tai Slack henkilökunnalle. Se on ei asiakas monikanavainen: avoimia linjoja ei ole, ei tukilippujono eikä operaattorin eskalointia. Älä käytä tätä liitännäistä etupäänä asiakastukilinja.

Laajennus toimii isäntäkoneessa natiivisti ja kommunikoi portin kautta aihummer.connector.v1 sopimus. Loppukäyttäjän kanavakäyttäytyminen on kanavasivulla Bitrix24; tämä sivu käsittelee itse lisäosaa.

Alla kuvattu media ja yhteinen OAuth edellyttävät allekirjoitettua Core 1.4.15:tä sekä erikseen allekirjoitettua liitintä 1.1.1 luettelojulkaisun ja päivityksen jälkeen. Asennettu 1.1.0 ei vahvista näiden toimintojen saatavuutta.

Tiedot

Kenttä	Arvo
Versio	1.1.1
Satama	8810
Ajonaika	isäntä-luontainen

Mikä se on

Kaksisuuntainen silta Bitrix24-chatin ja AiHummerin välillä. Agentti näkyy kuin ihmismäinen identiteetti Bitrix24:ssa — jokainen agentti tunnistautuu omalla OAuth-tunnisteellaan sen sijaan, että käyttäisi yleistä bottitiliä — joten keskustelut tuntuvat siltä kuin puhuisit kollegan kanssa. Käyttöoikeudet noudattavat organisaation osasto-puu ACL, joten agentin ulottuvuus kunnioittaa Bitrix24-rakennettasi.

Määritä erilliset portaalikäyttäjät asetukseen BITRIX24_AGENT_USER_IDS ja portaali asetukseen BITRIX24_PORTAL. Osastoreititys rajaa työntekijöiden pääsyä; agentin tili ei korvaa tehtävän aloittanutta henkilöä. Valinnainen nykyinen automaattinen käyttöönotto käyttää BITRIX24_ADMIN_LOGIN / BITRIX24_ADMIN_PASSWORD -asetuksia.

Mainituissa versioissa BITRIX24_VAULT_CONNECTIONS valitsee olemassa olevan, voimassa olevan, autonomisen OAuth-tunnistetiedon, jonka sen omistaja omistaa. Käytä tuettua natiivia holvin/yhteyksien hallintaa; käytä samaa tunnistetiedon ID:tä työkalusidoksissa. Todellinen omistaja rekisteröi käynnissä olevan liittimen sen työtilassa osoitteessa /v1/admin/connections/channel erillisellä connection-token-avaimella. Aseta endpoint ja apiKey agenttikäyttäjän ID:n mukaan salaiseen BITRIX24_VAULT_CONNECTIONS-asetukseen, älä agenttiprofiileihin tai kehotteisiin. Vain holvi uusii tunnukset; työkalut tarkistavat toimijan ja jakamisen. Katso OAuth2.

Miten sitä käytetään

Saapuvat: kyselyprosessi lukee viestit. Media ladataan tavuina ja rekisteröidään /v1/inbound/media-rajapinnassa; agentti saa media_id:n, ei pelkkää URL-osoitetta tai tiedoston metatietoja.
Lähtevät: Deliver muuntaa Markdownin BB-codeksi ja lähettää todelliset tavut im.v2.File.upload-rajapinnassa. Median vahvistus vaatii oikeat FILE_ID- ja viesti-ID:t; teksti tai linkki ei ole tiedoston toimituskuitti.

Säilytä pysyvä toimitusloki päivityksissä. Vahvistetun toiminnon toisto palauttaa aiemman kuitin. Osittaista tai tuntematonta vaikutusta ei lähetetä automaattisesti uudelleen; tarkista se ennen uutta yritystä.

employee ─▶ Bitrix24 chat ─▶ pull poller ─▶ gateway (router · turn) ─▶ Deliver (Markdown→BB-code, idempotent) ─▶ Bitrix24

Tuetut ominaisuudet

Reaktiot ja @-maininnat.
Kirjoitusilmaisin ja vastaukset, kun tili ja palveluntarjoaja tukevat im.dialog.writing- ja REPLY_ID-toimintoja.
Saapuvat kuvat, ääni, puhe ja tiedostot yllä mainituin versiovaatimuksin.
Viestien muokkaus/poisto vain vanhoille integraatioille, joilla on erillinen botti-identiteetti; niitä ei ilmoiteta tavallisille OAuth-käyttäjille.

Rajat

[!WARNING] Vuorovaikutteisia näppäimistöjä, painikkeita ja ketjuja ei tueta.

Luotu tai valmisteltu tiedosto ei vahvista toimitusta. Osittaisten, epäonnistuneiden ja tuntemattomien tulosten tulee pysyä näkyvissä.

Asennus

Asenna Bitrix24 yhdellä klikkauksella markkinapaikasta hallintakäyttöliittymässä. Isäntäkohtainen asentaja lataa lisäosan, suorittaa sen asennusvaiheen, luo hiekkalaatikotetun systemd-yksikön ja odottaa sen toimintakuntoisuutta ennen kuin merkitsee sen valmiiksi — katso Asenna ja päivitykset. Tämän jälkeen yhdistät kunkin edustajan OAuth-identiteetin ja kartoitat osastopuun ACL:n.

Turvallisuus ja rajat

Sisäinen työntekijän pikaviesti vain — ei asiakaskohtaista monikanavaa.
Yksittäistä agenttia kohden oleva ihmisen kaltainen OAuth-tunnistus — agentit eivät ole geneerisiä bottitilejä.
Osasto-puu ACL — reach kunnioittaa organisaatiorakennettasi.
Isäntä-luontainen — toimii systemdin alaisuudessa, ei säiliössä.