AiHummer
Norsk▾
Logg påKonto
v1.2.x▾
v1.4.xstablev1.3.xstablev1.2.xstablev1.1.xstablev1.0.xstable
{ }Swagger
Kanaler/Bitrix24

Bitrix24

v1.2.x · oppdatert 2026-10-14

Bitrix24 er en intern direktemeldingskanal for ansatte — den samme rollen Telegram eller Slack spiller for ansatte. En AiHummer-agent vises inne i selskapets Bitrix24 som en kollega som ansatte kan sende meldinger til og nevne.

Kanalen sender som en kontakt fra produktet Marked og kjører som vertsnativ. Det konfigureres fra Admin UI, som enhver annen kanal.

[!NOTE] Bitrix24-kanalen krever en aktiv Starter, Forretning eller Foretak lisens. På Community-planen returnerer installering av koblingen HTTP 402 “oppgradering kreves” (kode plan_limit) — se Lisensiering.

[!WARNING] Bitrix24 her er strengt tatt en intern ansatt IM-kanal. Det er ikke kundeomnikanal ikke Bitrix24 Åpne linjer, ikke en billettkø, og ikke en operatøropptrappingsflate. Ikke bruk den til å rute eksternt kundesamtaler.

Medier og felles OAuth nedenfor krever signert Core 1.4.15 og den separat signerte koblingen 1.1.1 etter katalogpublisering og oppdatering. En installert 1.1.0 bekrefter ikke at disse funksjonene er tilgjengelige.

En menneskelignende agentidentitet

Angi egne portalbrukere i BITRIX24_AGENT_USER_IDS og portalen i BITRIX24_PORTAL. Avdelingsruting begrenser ansattes tilgang; agentkontoen erstatter ikke personen som starter oppgaven. Valgfri eksisterende automatisk klargjøring bruker BITRIX24_ADMIN_LOGIN / BITRIX24_ADMIN_PASSWORD.

Med angitte versjoner velger BITRIX24_VAULT_CONNECTIONS en eksisterende, gyldig, autonom OAuth-legitimasjon som tilhører eieren. Bruk støttet native hvelv-/tilkoblingsadministrasjon; gjenbruk legitimasjonens ID i verktøybindinger. Den faktiske eieren registrerer den kjørende koblingen i arbeidsområdet via /v1/admin/connections/channel med en egen connection-token-nøkkel. Angi endpoint og apiKey per agentbruker-ID i den hemmelige innstillingen BITRIX24_VAULT_CONNECTIONS, aldri i agentprofiler eller instrukser. Bare hvelvet fornyer tokener; verktøyene sjekker aktør og deling. Se OAuth2.

Porter og kjøretid

Port Formål
8810 Koblingstjeneste på loopback: status og Deliver

Hvordan meldinger flyter

  • Innkommende: polleren leser meldinger. Medier lastes ned som byte og registreres via /v1/inbound/media; agenten får media_id, ikke bare en URL eller filmetadata.
  • Utgående: Deliver konverterer Markdown til BB-code og laster opp faktiske byte via im.v2.File.upload. Mediebekreftelse krever ekte FILE_ID og meldings-ID-er; tekst eller lenke er ingen filkvittering.

Behold den varige leveringsjournalen ved oppdateringer. En gjentatt bekreftet operasjon returnerer den tidligere kvitteringen. Delvise eller ukjente virkninger sendes ikke automatisk på nytt; sjekk dem før et nytt forsøk.

Hva støttes

  • Reaksjoner og @-omtaler.
  • Skriveindikator og svar når kontoen og leverandøren støtter im.dialog.writing og REPLY_ID.
  • Innkommende bilder, lyd, tale og filer med versjonskravene ovenfor.
  • Redigering/sletting av meldinger bare for eldre integrasjoner med en egen botidentitet; dette annonseres ikke for vanlige OAuth-brukere.

[!WARNING] Interaktive tastaturer, knapper og tråder støttes ikke.

En generert eller klargjort fil bekrefter ikke levering. Delvise, mislykkede og ukjente resultater må forbli synlige.

Hvor til neste