AiHummer
Suomi
Kirjaudu sisäänTili
v1.0.x
{ }Swagger

Bitrix24-laajennus

v1.0.x · päivitetty 2026-07-05

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.

Tiedot

Kenttä Arvo
Versio 1.0.0
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.

OAuth-tunnusten lisäksi tuetaan myös muita käyttöönoton polkuja: agenttitilien automaattinen luominen portaalin ylläpitäjän kirjautumisen kautta (BITRIX24_ADMIN_LOGIN / BITRIX24_ADMIN_PASSWORD) ja sitoutuminen ennalta luotuihin Bitrix24-käyttäjiin kiinteiden tunnusten avulla (BITRIX24_AGENT_USER_IDS).

Miten sitä käytetään

  • Saapuva: vetävä kyselylaite noutaa uusia viestejä ja välittää ne portaalin yleinen saapuvan liikenteen päätepiste, jossa reititin ratkaisee kohdeagentin.
  • Lähtevä: vastaukset lähetetään liittimen idempotentin kautta Toimittaa vaihe, joka muuntaa agentin Markdownin Bitrix24:ksi BB-koodi ja takuut viestin lähettämisen vain kerran.
employee ─▶ Bitrix24 chat ─▶ pull poller ─▶ gateway (router · turn) ─▶ Deliver (Markdown→BB-code, idempotent) ─▶ Bitrix24

Tuetut ominaisuudet

Laajennus tukee rikasta, ihmismäistä keskustelukäyttäytymistä:

  • reaktiot
  • viestin muokkaus ja poisto
  • kirjoitusilmaisimet
  • @-maininnat
  • media

Rajat

[!WARNING] Ihmismäinen malli tekee sen tahallaan ei sisällytä joitain Bitrix24-botteja ominaisuudet:

  • Ei interaktiivisia näppäimistöjä / painikkeita ja ei lankoja.
  • Saapuva media ja ääni eivät välity eteenpäin — saapuva on vain teksti. A työkaverityylinen identiteetti vastaanottaa ja vastaa tekstiin; liitteet ja ääni agentille lähetetyt muistiinpanot eivät välity vuoroksi.

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.
  • Idempotentti Toimittaa — Markdown muunnetaan BB-koodiksi eikä sitä koskaan lähetetä kahdesti.
  • Pelkkä tekstiviesti; ei näppäimistöjä/ketjuja.
  • Isäntä-luontainen — toimii systemdin alaisuudessa, ei säiliössä.

Minne seuraavaksi