AiHummer
Română▾
Autentificare
v1.0.x▾
v1.0.xstable
{ }Swagger
Canale/Bitrix24

Bitrix24

v1.0.x · actualizat 2026-06-26

Bitrix24 este un canal intern de mesagerie instantanee pentru angajați — același rol pe care Telegram sau Slack îl joacă pentru personal. Un agent AiHummer apare în interiorul Bitrix24 al companiei dumneavoastră ca un coleg pe care angajații îl pot mesaja și menționa.

Canalul este livrat ca un conector din Marketplace-ul integrat în produs și rulează nativ pe gazdă. Este configurat din interfața de administrare, ca orice alt canal.

[!WARNING] Bitrix24 aici este strict un canal IM intern pentru angajați. Nu este omnicanal pentru clienți, nu este Bitrix24 Open Lines, nu este o coadă de tichete și nu este o suprafață de escaladare către operator. Nu îl folosiți pentru a direcționa conversațiile cu clienții externi.

O identitate de agent umanoidă

Fiecare agent se conectează cu propria identitate OAuth umanoidă, astfel încât apare în Bitrix24 ca o persoană distinctă, mai degrabă decât ca un bot de integrare generic. Vizibilitatea respectă structura organizației dumneavoastră printr-un ACL de arbore de departamente — un agent vede și participă doar unde identitatea sa este permisă, urmând aceeași ierarhie de departamente pe care o urmează angajații dumneavoastră.

Porturi și runtime

Conectorul folosește un set mic de porturi fixe:

Port Scop
8810 Serviciul conectorului (sănătate și control)
8080 Endpoint de livrare (implicit)
8791 Consimțământ OAuth

Cum circulă mesajele

Bitrix24 nu împinge evenimentele de intrare către AiHummer; conectorul le trage.

  • Intrare — un poller de tip pull citește mesajele noi și le postează către gateway la /v1/inbound/generic.
  • Ieșire — răspunsurile sunt livrate prin contractul Deliver aihummer.connector.v1. Markdown-ul agentului este convertit în BB-code Bitrix24, iar livrarea este idempotentă, astfel încât o trimitere reîncercată nu produce niciodată un mesaj duplicat.

Ce este acceptat

Canalul acoperă interacțiunile care se potrivesc unei identități umanoide de angajat:

  • Reacții, editare și ștergere a mesajelor.
  • Indicatori de scriere.
  • @-mențiuni.
  • Media în mesajele de ieșire.

[!WARNING] Unele funcționalități în stil Telegram nu sunt acceptate intenționat în modelul umanoid:

  • Fără tastaturi sau butoane interactive și fără fire de discuție.
  • Media și vocea de intrare nu sunt redirecționate — intrarea este doar-text.

Planificați fluxurile agentului în jurul interacțiunii bazate pe text pe acest canal.

Unde mergem mai departe