AiHummer
Română▾
AutentificareCont personal
v1.4.x▾
v1.4.xstablev1.3.xstablev1.2.xstablev1.1.xstablev1.0.xstable
{ }Swagger
Canale/Bitrix24

Bitrix24

v1.4.x · actualizat 2026-10-14

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.

Comportamentul media și OAuth comun de mai jos necesită Core 1.4.15 semnat și conectorul 1.1.1 semnat separat, după publicarea în catalog și actualizare. Un conector 1.1.0 instalat nu confirmă disponibilitatea acestor funcții.

O identitate a unui agent asemănător omului

Configurați utilizatori dedicați ai portalului în BITRIX24_AGENT_USER_IDS și portalul în BITRIX24_PORTAL. Rutarea pe departamente limitează accesul angajaților; contul agentului nu înlocuiește inițiatorul sarcinii. Pregătirea automată existentă, opțională, folosește BITRIX24_ADMIN_LOGIN / BITRIX24_ADMIN_PASSWORD.

În versiunile indicate, BITRIX24_VAULT_CONNECTIONS selectează o acreditare OAuth existentă, valabilă, autonomă, deținută de proprietarul ei. Folosiți gestionarea nativă acceptată a seifului/conexiunilor; reutilizați ID-ul acreditării în legăturile instrumentelor. Proprietarul real înregistrează conectorul activ în spațiul său de lucru la /v1/admin/connections/channel cu o cheie dedicată connection-token. Setați endpoint și apiKey după ID-ul utilizatorului agent în setarea secretă BITRIX24_VAULT_CONNECTIONS; nu le puneți în profiluri sau solicitări către agent. Numai seiful reînnoiește tokenurile; instrumentele verifică inițiatorul și partajarea. Consultați OAuth2.

Porturi și runtime

Port Scop
8810 Serviciul conectorului pe loopback: stare și Deliver

Cum circulă mesajele

  • Intrare: interogatorul citește mesajele. Media este descărcată ca octeți și înregistrată prin /v1/inbound/media; agentul primește media_id, nu doar un URL sau metadate.
  • Ieșire: Deliver convertește Markdown în BB-code și încarcă octeți reali prin im.v2.File.upload. Confirmarea media necesită FILE_ID și ID-uri de mesaje reale; textul sau linkul nu reprezintă o confirmare a fișierului.

Păstrați jurnalul durabil de livrare la actualizări. Repetarea unei operații confirmate returnează confirmarea anterioară. Efectele parțiale sau necunoscute nu sunt retrimise automat; verificați-le înainte de reîncercare.

Ce este acceptat

  • Reacții și @-mențiuni.
  • Indicator de scriere și răspunsuri când contul și furnizorul acceptă im.dialog.writing și REPLY_ID.
  • Imagini, audio, voce și fișiere primite, cu cerințele de versiune de mai sus.
  • Editarea/ștergerea mesajelor numai pentru integrări vechi cu o identitate separată de bot; nu sunt declarate pentru utilizatori OAuth obișnuiți.

[!WARNING] Tastaturile interactive, butoanele și firele de discuție nu sunt acceptate.

Un fișier generat sau pregătit nu confirmă livrarea. Rezultatele parțiale, eșuate și necunoscute trebuie să rămână vizibile.

Unde următor?