AiHummer
Dansk▾
Log indKonto
v1.1.x▾
v1.4.xstablev1.3.xstablev1.2.xstablev1.1.xstablev1.0.xstable
{ }Swagger
Kanaler/Bitrix24

Bitrix24

v1.1.x · opdateret 2026-10-14

Bitrix24 er en intern chatkanal til medarbejdere — den samme rolle Telegram eller Slack spiller for personalet. En AiHummer-agent dukker op i din virksomheds Bitrix24 som en kollega, som medarbejderne kan sende beskeder til og nævne.

Kanalen sender som en stik fra produktet Markedsplads og kører som vært-native. Det konfigureres fra Admin UI, ligesom enhver anden kanal.

[!NOTE] Bitrix24-kanalen kræver en aktiv Starter, Forretning eller Foretagende licens. På Community-planen giver installation af connectoren HTTP 402 “opgradering påkrævet” (kode plan_limit) — se Licensiering.

[!WARNING] Bitrix24 her er strengt en intern medarbejder IM-kanal. Det er ikke kundeomnichannel ikke Bitrix24 Åbne Linjer ikke en billetkø, og ikke en operatøroptrapningsflade. Brug den ikke til at dirigere eksterne kundesamtaler.

Medierne og fælles OAuth nedenfor kræver signeret Core 1.4.15 og den separat signerede connector 1.1.1 efter katalogoffentliggørelse og opdatering. En installeret 1.1.0 bekræfter ikke disse funktioners tilgængelighed.

En menneskelignende agentidentitet

Angiv særskilte portalbrugere i BITRIX24_AGENT_USER_IDS og portalen i BITRIX24_PORTAL. Afdelingsrouting begrænser medarbejderadgang; agentkontoen erstatter ikke opgavens initiativtager. Valgfri eksisterende automatisk klargøring bruger BITRIX24_ADMIN_LOGIN / BITRIX24_ADMIN_PASSWORD.

Med de angivne versioner vælger BITRIX24_VAULT_CONNECTIONS en eksisterende, gyldig, autonom OAuth-legitimationsoplysning, som tilhører ejeren. Brug understøttet native boks-/forbindelsesadministration; genbrug oplysningens ID i værktøjsbindinger. Den faktiske ejer registrerer den kørende connector i dens arbejdsområde via /v1/admin/connections/channel med en særskilt connection-token-nøgle. Angiv endpoint og apiKey pr. agentbruger-ID i den hemmelige indstilling BITRIX24_VAULT_CONNECTIONS, aldrig i agentprofiler eller instruktioner. Kun boksen fornyer tokens; værktøjerne kontrollerer aktør og deling. Se OAuth2.

Porte og runtime

Port Formål
8810 Connector-tjeneste på loopback: status og Deliver

Hvordan beskeder flyder

  • Indgående: polleren læser beskeder. Medier downloades som bytes og registreres via /v1/inbound/media; agenten får media_id, ikke blot en URL eller filmetadata.
  • Udgående: Deliver konverterer Markdown til BB-code og uploader faktiske bytes via im.v2.File.upload. Mediebekræftelse kræver rigtige FILE_ID og besked-ID’er; tekst eller link er ingen filkvittering.

Bevar den varige leveringsjournal ved opdateringer. En gentaget bekræftet operation returnerer den tidligere kvittering. Delvise eller ukendte virkninger genafsendes ikke automatisk; kontroller dem før et nyt forsøg.

Hvad er understøttet

  • Reaktioner og @-omtaler.
  • Skriveindikator og svar, når kontoen og udbyderen understøtter im.dialog.writing og REPLY_ID.
  • Indgående billeder, lyd, tale og filer med versionskravene ovenfor.
  • Redigering/sletning af beskeder kun for ældre integrationer med særskilt botidentitet; de annonceres ikke for almindelige OAuth-brugere.

[!WARNING] Interaktive tastaturer, knapper og tråde understøttes ikke.

En genereret eller klargjort fil bekræfter ikke levering. Delvise, mislykkede og ukendte resultater skal forblive synlige.

Hvor til næste