AiHummer
Suomi▾
Kirjaudu sisäänTili
v1.4.x▾
v1.4.xstablev1.3.xstablev1.2.xstablev1.1.xstablev1.0.xstable
{ }Swagger
Kanavat/Bitrix24

Bitrix24

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

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.

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.

Ihmisen kaltainen toimija-identiteetti

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.

Portit ja ajonaikainen

Portti Tarkoitus
8810 Liittimen palvelu loopback-osoitteessa: tila ja Deliver

Miten viestit kulkevat

  • 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ä.

Mitä tuetaan

  • 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.

[!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ä.

Minne seuraavaksi