Bitrix24-plugin
Bitrix24-pluginet kopplar din agent till Bitrix24 som en intern medarbetar-kanal för snabbmeddelanden. Personalmeddelanden skickar till agenten på samma sätt som de skulle skicka till en kollega, och agenten svarar i Bitrix24:s chatt.
[!WARNING] Bitrix24 här är en intern medarbetar-IM-kanal — som Telegram eller Slack för personal. Det är inte kundomnikanal: det finns inga Öppna Linjer, nej supportkö och ingen operatörseskalering. Använd inte detta plugin för att fronta en kundsupportlinje
Pluginet körs på värddatorns system och kommunicerar med gatewayen över aihummer.connector.v1 kontrakt. Slutanvändarens kanalbeteende finns på kanalsidan Bitrix24; den här sidan täcker själva tillägget.
Fakta
| Fält | Värde |
|---|---|
| Version | 1.0.0 |
| Port | 8810 |
| Körningstid | värd-inhemsk |
Vad det är
En tvåvägsbro mellan Bitrix24-chatt och AiHummer. Agenten visas som en människolik identitet i Bitrix24 — varje agent autentiserar sig med sin egen OAuth-identitet istället för ett generiskt botkonto — så konversationer känns som att prata med en kollega. Tillgång följer organisationens avdelningsträd ACL, så en agents räckvidd respekterar din Bitrix24-struktur.
Förutom OAuth-identiteter stöds andra tillvägagångssätt för provisionering: automatisk skapande av agentkonton via en portaldministratörs inloggning (BITRIX24_ADMIN_LOGIN / BITRIX24_ADMIN_PASSWORD) och binda till förhandsgenererade Bitrix24-användare med fasta ID:n (BITRIX24_AGENT_USER_IDS).
Hur det används
- Inkommande: en pull-poller hämtar nya meddelanden och vidarebefordrar dem till gatewayens generiska inkommande slutpunkt, där routern löser målagenten.
- Utgående: svar skickas genom kopplarens idempotenta Leverera steg, som konverterar agentens Markdown till Bitrix24 BB-kod och garanterar att ett meddelande inte skickas två gånger.
employee ─▶ Bitrix24 chat ─▶ pull poller ─▶ gateway (router · turn) ─▶ Deliver (Markdown→BB-code, idempotent) ─▶ Bitrix24Stödda funktioner
Pluginet stöder rik, mänsklig-liknande chattbeteende:
- reaktioner
- meddelanderedigering och radering
- skrivindikatorer
- @-omnämnanden
- media
Gränser
[!WARNING] Den människoliknande modellen gör avsiktligt inte inkludera någon Bitrix24-bot funktioner:
- Inga interaktiva tangentbord / knappar och inga trådar.
- Inkommande media och röst vidarebefordras inte — inkommande är endast text. A kollegastil identitet tar emot och svarar på text; bilagor och röst anteckningar skickade till agenten vidarebefordras inte till en tur.
Installation
Installera Bitrix24 med ett klick från marknadsplatsen i administrationsgränssnittet. Den värdbaserade deployern laddar ner pluginet, kör installationssteget, renderar en sandlådad systemd-enhet och väntar på hälsa innan den markerar den som klar — se Installera & uppdateringar. Du kopplar sedan varje agents OAuth-identitet och kartlägger avdelningsträdets ACL.
Säkerhet och begränsningar
- Endast intern medarbetar-MIM — inte kundomnikanal.
- Per-agent mänsklig-lik OAuth-identitet — agenter är inte generiska botkonton.
- Avdelningsträd ACL — respekterar din organisationsstruktur.
- Idempotent leverans — Markdown renderas till BB-kod och skickas aldrig två gånger.
- Endast text inkommande; inga tangentbord/trådar.
- Värd-nativ — körs under systemd, inte i en container.