Bitrix24 este un canal intern de mesagerie instant pentru angajați — același rol pe care îl joacă Telegram sau Slack pentru personal. Un agent AiHummer apare în Bitrix24 al companiei tale ca un coleg pe care angajații îl pot mesaja și menționa.
Canalul transportă ca un conector din produs Piață și rulează nativ pe gazdă. Este configurat din interfața de administrare, ca orice alt canal.
[!NOTE]
Canalul Bitrix24 necesită un cont activ Starter, Afaceri sau
Întreprindere licență. Pe planul Comunității, instalarea conectorului returnează
HTTP 402 “actualizare necesară” (cod plan_limit) — vezi
Licențiere.
[!WARNING]
Bitrix24 aici este strict un canal IM intern pentru angajați. Este nu
client omnicanal nu Linii deschise Bitrix24 nu o coadă de bilete, și
nu o suprafață de escaladare a operatorului. Nu o folosiți pentru a direcționa extern
conversații cu clienții.
O identitate a unui agent asemănător omului
Fiecare agent se conectează cu al său identitate OAuth asemănătoare cu cea umană, astfel încât să apară în Bitrix24 ca o persoană distinctă și nu ca un bot de integrare generic. Vizibilitatea respectă structura organizației tale printr-un ACL arbore-departament — un agent vede și participă doar acolo unde i se permite identitatea, urmând aceeași ierarhie a departamentului ca și angajații dumneavoastră.
Pe lângă identitățile OAuth, conectorul acceptă și alte căi de aprovizionare: conturi de agenți cu auto-provisionare printr-un login de administrator al portalului (BITRIX24_ADMIN_LOGIN / BITRIX24_ADMIN_PASSWORD) și legarea la utilizatori Bitrix24 pre-creați prin ID-uri fixe (BITRIX24_AGENT_USER_IDS).
Porturi și runtime
Conectorul ascultă pe un singur port:
Port
Scop
8810
Serviciu de conector (sănătate, punctul final Deliver și consimțământul OAuth)
Cum circulă mesajele
Bitrix24 nu trimite evenimente inbound către AiHummer; conectorul trage ei.
Intrare — un pull poller citește mesajele noi și le postează la gateway la
/v1/inbound/generic.
Ieșire — răspunsurile sunt livrate prin aihummer.connector.v1Livra contract. Agent markdown este convertit în cod BB Bitrix24, și
livrarea este idempotent, astfel încât o trimitere reîncercată nu produce niciodată un duplicat
mesaj.
Ce este acceptat
Canalul acoperă interacțiunile care se potrivesc cu o identitate de angajat asemănătoare cu cea umană:
Reacții, mesaj editează și șterge.
Tastare indicatori.
@-mențiuni.
Media în mesajele de ieșire.
[!WARNING]
Unele funcții în stil Telegram sunt intenționate nu acceptat în
model asemănător omului:
Fără tastaturi sau butoane interactive și fără fire.
Textele, mediile și convorbirile primite sunt redirecționate — imagini, audio, voce și fișiere.
Planul fluxurilor agentului în jurul interacțiunii bazate pe text pe acest canal.
**Bitrix24 este un canal intern de mesagerie instant pentru angajați** — același rol pe care îl joacă Telegram sau Slack pentru personal. Un agent AiHummer apare în Bitrix24 al companiei tale ca un coleg pe care angajații îl pot mesaja și menționa.
Canalul transportă ca un **conector din produs [Piață](/ro/v1.0/marketplace/overview-tiers)** și rulează nativ pe gazdă. Este configurat din interfața de administrare, ca orice alt canal.
> [!NOTE]
> Canalul Bitrix24 necesită un cont activ **Starter**, **Afaceri** sau
> **Întreprindere** licență. Pe planul Comunității, instalarea conectorului returnează
> **HTTP 402 "actualizare necesară"** (cod `plan_limit`) — vezi
> [Licențiere](/ro/v1.0/commercial/licensing).
> [!WARNING]
> Bitrix24 aici este strict un **canal IM intern pentru angajați**. Este **nu**
> client omnicanal **nu** Linii deschise Bitrix24 **nu** o coadă de bilete, și
> **nu** o suprafață de escaladare a operatorului. Nu o folosiți pentru a direcționa extern
> conversații cu clienții.
## O identitate a unui agent asemănător omului
Fiecare agent se conectează cu al său **identitate OAuth asemănătoare cu cea umană**, astfel încât să apară în Bitrix24 ca o persoană distinctă și nu ca un bot de integrare generic. Vizibilitatea respectă structura organizației tale printr-un **ACL arbore-departament** — un agent vede și participă doar acolo unde i se permite identitatea, urmând aceeași ierarhie a departamentului ca și angajații dumneavoastră.
Pe lângă identitățile OAuth, conectorul acceptă și alte căi de aprovizionare: **conturi de agenți cu auto-provisionare printr-un login de administrator al portalului** (`BITRIX24_ADMIN_LOGIN` / `BITRIX24_ADMIN_PASSWORD`) și legarea la **utilizatori Bitrix24 pre-creați prin ID-uri fixe** (`BITRIX24_AGENT_USER_IDS`).
## Porturi și runtime
Conectorul ascultă pe un singur port:
| Port | Scop |
|---|---|
| 8810 | Serviciu de conector (sănătate, punctul final Deliver și consimțământul OAuth) |
## Cum circulă mesajele
Bitrix24 nu trimite evenimente inbound către AiHummer; conectorul **trage** ei.
- **Intrare** — un pull poller citește mesajele noi și le postează la gateway la
`/v1/inbound/generic`.
- **Ieșire** — răspunsurile sunt livrate prin `aihummer.connector.v1`
**Livra** contract. Agent **markdown este convertit în cod BB Bitrix24**, și
livrarea este **idempotent**, astfel încât o trimitere reîncercată nu produce niciodată un duplicat
mesaj.
## Ce este acceptat
Canalul acoperă interacțiunile care se potrivesc cu o identitate de angajat asemănătoare cu cea umană:
- Reacții, mesaj **editează** și **șterge**.
- **Tastare** indicatori.
- **@-mențiuni**.
- **Media** în mesajele de ieșire.
> [!WARNING]
> Unele funcții în stil Telegram sunt intenționate **nu** acceptat în
> model asemănător omului:
>
> - **Fără tastaturi sau butoane interactive** și **fără fire**.
> - **Textele, mediile și convorbirile primite sunt redirecționate** — imagini, audio, voce și fișiere.
>
> Planul fluxurilor agentului în jurul interacțiunii bazate pe text pe acest canal.
## Unde următor?
- Despre instalarea conectorilor: [Piață](/ro/v1.0/marketplace/overview-tiers).
- Pentru tastaturi interactive și sondaje, folosiți [Telegram](/ro/v1.0/channels/telegram)
sau [MAX](/ro/v1.0/channels/max).
- Vezi API-ul de ingestie de bază în
[Intrare generică](/ro/v1.0/channels/generic-inbound).
