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.
En menneskelignende agentidentitet
Hver agent kobler til med sin egen menneskelignende OAuth-identitet, slik at det vises i Bitrix24 som en egen person i stedet for en generell integrasjonsbot. Synlighet respekterer organisasjonsstrukturen din gjennom en avdelings-tre ACL — en agent ser bare og deltar der hvor dens identitet er tillatt, og følger den samme avdelingshierarkiet som dine ansatte gjør.
I tillegg til OAuth-identiteter, støtter koblingen også andre provisioneringsveier: automatisk provisjonering av agentkontoer via en portaladministrator pålogging (BITRIX24_ADMIN_LOGIN / BITRIX24_ADMIN_PASSWORD) og binding til forhåndsskapt Bitrix24-brukere med faste ID-er (BITRIX24_AGENT_USER_IDS).
Porter og kjøretid
Koblingen lytter på en enkelt port:
Havn
Formål
8810
Koblingstjeneste (helse, Deliver-endepunktet og OAuth-samtykke)
Hvordan meldinger flyter
Bitrix24 sender ikke innkommende hendelser til AiHummer; forbindelsen drar dem.
Innkommende — en pull-poller leser nye meldinger og legger dem ut på gatewayen på
/v1/inbound/generic.
Utgående — svar leveres gjennom aihummer.connector.v1Levere kontrakt. Agent markdown blir konvertert til Bitrix24 BB-kode, og
levering er idempotent, så et nytt forsøk på sending aldri gir en duplikat
melding.
Hva støttes
Kanalen dekker interaksjonene som passer til en menneskelig-lignende ansattidentitet:
Reaksjoner, melding rediger og slette.
Skriving indikatorer.
@-omtaler.
Media i utgående meldinger.
[!WARNING]
Noen Telegram-lignende funksjoner er med vilje ikke støttet i
menneskelignende modell:
Ingen interaktive tastaturer eller knapper og ingen tråder.
Innkommende tekst, medier og tale blir videresendt — bilder, lyd, stemme og filer.
Planlegg agentflyt rundt tekstbasert interaksjon på denne kanalen.
**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](/no/v1.0/marketplace/overview-tiers)** 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](/no/v1.0/commercial/licensing).
> [!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.
## En menneskelignende agentidentitet
Hver agent kobler til med sin egen **menneskelignende OAuth-identitet**, slik at det vises i Bitrix24 som en egen person i stedet for en generell integrasjonsbot. Synlighet respekterer organisasjonsstrukturen din gjennom en **avdelings-tre ACL** — en agent ser bare og deltar der hvor dens identitet er tillatt, og følger den samme avdelingshierarkiet som dine ansatte gjør.
I tillegg til OAuth-identiteter, støtter koblingen også andre provisioneringsveier: **automatisk provisjonering av agentkontoer via en portaladministrator pålogging** (`BITRIX24_ADMIN_LOGIN` / `BITRIX24_ADMIN_PASSWORD`) og binding til **forhåndsskapt Bitrix24-brukere med faste ID-er** (`BITRIX24_AGENT_USER_IDS`).
## Porter og kjøretid
Koblingen lytter på en enkelt port:
| Havn | Formål |
|---|---|
| 8810 | Koblingstjeneste (helse, Deliver-endepunktet og OAuth-samtykke) |
## Hvordan meldinger flyter
Bitrix24 sender ikke innkommende hendelser til AiHummer; forbindelsen **drar** dem.
- **Innkommende** — en pull-poller leser nye meldinger og legger dem ut på gatewayen på
`/v1/inbound/generic`.
- **Utgående** — svar leveres gjennom `aihummer.connector.v1`
**Levere** kontrakt. Agent **markdown blir konvertert til Bitrix24 BB-kode**, og
levering er **idempotent**, så et nytt forsøk på sending aldri gir en duplikat
melding.
## Hva støttes
Kanalen dekker interaksjonene som passer til en menneskelig-lignende ansattidentitet:
- Reaksjoner, melding **rediger** og **slette**.
- **Skriving** indikatorer.
- **@-omtaler**.
- **Media** i utgående meldinger.
> [!WARNING]
> Noen Telegram-lignende funksjoner er med vilje **ikke** støttet i
> menneskelignende modell:
>
> - **Ingen interaktive tastaturer eller knapper** og **ingen tråder**.
> - **Innkommende tekst, medier og tale blir videresendt** — bilder, lyd, stemme og filer.
>
> Planlegg agentflyt rundt tekstbasert interaksjon på denne kanalen.
## Hvor til neste
- Om installasjon av kontakter: [Marked](/no/v1.0/marketplace/overview-tiers).
- For interaktive tastaturer og meningsmålinger, bruk [Telegram](/no/v1.0/channels/telegram)
eller [MAKS](/no/v1.0/channels/max).
- Se det underliggende inntaks-API-et i
[Generisk innkommende](/no/v1.0/channels/generic-inbound).
