Bitrix24 on sisäinen työntekijöiden pikaviestikanava — sama rooli, jonka Telegram tai Slack pelaa henkilökunnalle. AiHummer-agentti ilmestyy yrityksesi Bitrix24:ään kollegana, jolle työntekijät voivat lähettää viestejä ja mainita.
Kanava kuljettaa kuin liitin tuotteessa Markkinapaikka ja toimii isäntäympäristössä. Se on määritetty hallintaliittymästä, kuten mikä tahansa muu kanava.
[!NOTE]
Bitrix24-kanava vaatii aktiivisen Aloittaja, Liiketoiminta tai
Yritys lisenssi. Yhteisösuunnitelmassa liittimen asentaminen palauttaa
HTTP 402 “päivitys vaaditaan” (koodi plan_limit) — katso
Lisensointi.
[!WARNING]
Bitrix24 tässä on tiukasti sisäinen työntekijän pikaviestin-kanava. Se on ei
asiakkaan monikanavainen ei Bitrix24 Avoimet linjat ei lipputoimistojono, ja
ei operaattorin eskalaatiopinta. Älä käytä sitä reitittämään ulkoisia
asiakaskeskustelut.
Ihmisen kaltainen toimija-identiteetti
Jokainen agentti yhdistyy omansa kanssa ihmismäisen OAuth-identiteetti, jotta se näkyy Bitrix24:ssä erillisenä henkilönä sen sijaan, että se olisi yleinen integraatiobotti. Näkyvyys noudattaa organisaatiorakennettasi kautta osasto-puu ACL — agentti näkee ja osallistuu vain siellä, missä sen identiteetti on sallittu, noudattaen samaa osastoportaikkoa kuin työntekijäsi.
OAuth-tunnusten lisäksi liitin tukee myös muita käyttöönoton polkuja: automaattinen käyttötunnusten luonti agenttitileille portaalin ylläpitäjän kirjautumisen kautta (BITRIX24_ADMIN_LOGIN / BITRIX24_ADMIN_PASSWORD) ja sitoutuminen etukäteen luodut Bitrix24-käyttäjät kiinteillä tunnuksilla (BITRIX24_AGENT_USER_IDS).
Portit ja ajonaikainen
Liitin kuuntelee yhdellä portilla:
Satama
Tarkoitus
8810
Liitinpalvelu (terveys, Deliver-päätepiste ja OAuth-suostumus)
Miten viestit kulkevat
Bitrix24 ei työnnä saapuvia tapahtumia AiHummeriin; liitin vetää heitä.
Saapuva — vetopolleri lukee uusia viestejä ja lähettää ne porttiin klo
/v1/inbound/generic.
Lähtevä — vastaukset toimitetaan läpi aihummer.connector.v1Toimittaa sopimus. Agentti markdown muunnetaan Bitrix24 BB-koodiksi, ja
toimitus on idempotentti, joten uudelleen lähetetty lähetys ei koskaan tuota kopiota
viesti.
Mitä tuetaan
Kanava kattaa vuorovaikutukset, jotka sopivat ihmismäisen työntekijän identiteettiin:
Reaktiot, viesti muokkaa ja poistaa.
Kirjoittaminen indikaattorit.
@-maininnat.
Media lähetyksissä lähtevissä viesteissä.
[!WARNING]
Jotkin Telegram-tyyliset ominaisuudet ovat tahallaan ei tuettu
ihmismäinen malli:
Ei interaktiivisia näppäimistöjä tai painikkeita ja ei säikeitä.
Saapuvat tekstiviestit, media ja ääni välitetään eteenpäin — kuvat, ääni, puhe ja tiedostot.
Suunnittele agenttien virrat tämän kanavan tekstipohjaisen vuorovaikutuksen ympärille.
**Bitrix24 on sisäinen työntekijöiden pikaviestikanava** — sama rooli, jonka Telegram tai Slack pelaa henkilökunnalle. AiHummer-agentti ilmestyy yrityksesi Bitrix24:ään kollegana, jolle työntekijät voivat lähettää viestejä ja mainita.
Kanava kuljettaa kuin **liitin tuotteessa [Markkinapaikka](/fi/v1.0/marketplace/overview-tiers)** ja toimii isäntäympäristössä. Se on määritetty hallintaliittymästä, kuten mikä tahansa muu kanava.
> [!NOTE]
> Bitrix24-kanava vaatii aktiivisen **Aloittaja**, **Liiketoiminta** tai
> **Yritys** lisenssi. Yhteisösuunnitelmassa liittimen asentaminen palauttaa
> **HTTP 402 "päivitys vaaditaan"** (koodi `plan_limit`) — katso
> [Lisensointi](/fi/v1.0/commercial/licensing).
> [!WARNING]
> Bitrix24 tässä on tiukasti **sisäinen työntekijän pikaviestin-kanava**. Se on **ei**
> asiakkaan monikanavainen **ei** Bitrix24 Avoimet linjat **ei** lipputoimistojono, ja
> **ei** operaattorin eskalaatiopinta. Älä käytä sitä reitittämään ulkoisia
> asiakaskeskustelut.
## Ihmisen kaltainen toimija-identiteetti
Jokainen agentti yhdistyy omansa kanssa **ihmismäisen OAuth-identiteetti**, jotta se näkyy Bitrix24:ssä erillisenä henkilönä sen sijaan, että se olisi yleinen integraatiobotti. Näkyvyys noudattaa organisaatiorakennettasi kautta **osasto-puu ACL** — agentti näkee ja osallistuu vain siellä, missä sen identiteetti on sallittu, noudattaen samaa osastoportaikkoa kuin työntekijäsi.
OAuth-tunnusten lisäksi liitin tukee myös muita käyttöönoton polkuja: **automaattinen käyttötunnusten luonti agenttitileille portaalin ylläpitäjän kirjautumisen kautta** (`BITRIX24_ADMIN_LOGIN` / `BITRIX24_ADMIN_PASSWORD`) ja sitoutuminen **etukäteen luodut Bitrix24-käyttäjät kiinteillä tunnuksilla** (`BITRIX24_AGENT_USER_IDS`).
## Portit ja ajonaikainen
Liitin kuuntelee yhdellä portilla:
| Satama | Tarkoitus |
|---|---|
| 8810 | Liitinpalvelu (terveys, Deliver-päätepiste ja OAuth-suostumus) |
## Miten viestit kulkevat
Bitrix24 ei työnnä saapuvia tapahtumia AiHummeriin; liitin **vetää** heitä.
- **Saapuva** — vetopolleri lukee uusia viestejä ja lähettää ne porttiin klo
`/v1/inbound/generic`.
- **Lähtevä** — vastaukset toimitetaan läpi `aihummer.connector.v1`
**Toimittaa** sopimus. Agentti **markdown muunnetaan Bitrix24 BB-koodiksi**, ja
toimitus on **idempotentti**, joten uudelleen lähetetty lähetys ei koskaan tuota kopiota
viesti.
## Mitä tuetaan
Kanava kattaa vuorovaikutukset, jotka sopivat ihmismäisen työntekijän identiteettiin:
- Reaktiot, viesti **muokkaa** ja **poistaa**.
- **Kirjoittaminen** indikaattorit.
- **@-maininnat**.
- **Media** lähetyksissä lähtevissä viesteissä.
> [!WARNING]
> Jotkin Telegram-tyyliset ominaisuudet ovat tahallaan **ei** tuettu
> ihmismäinen malli:
>
> - **Ei interaktiivisia näppäimistöjä tai painikkeita** ja **ei säikeitä**.
> - **Saapuvat tekstiviestit, media ja ääni välitetään eteenpäin** — kuvat, ääni, puhe ja tiedostot.
>
> Suunnittele agenttien virrat tämän kanavan tekstipohjaisen vuorovaikutuksen ympärille.
## Minne seuraavaksi
- Liittimien asentaminen: [Markkinapaikka](/fi/v1.0/marketplace/overview-tiers).
- Interaktiivisten näppäimistöjen ja kyselyiden varten käytä [Telegram](/fi/v1.0/channels/telegram)
tai [MAX](/fi/v1.0/channels/max).
- Katso perimmäinen syöttö-API
[Yleinen saapuva](/fi/v1.0/channels/generic-inbound).
