Bitrix24-plugin

v1.0.x · uppdaterad 2026-10-14

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.

Medierna och gemensamt OAuth nedan kräver signerat Core 1.4.15 och den separat signerade anslutaren 1.1.1 efter katalogpublicering och uppdatering. En installerad 1.1.0 bekräftar inte att dessa funktioner finns.

Fakta

Fält	Värde
Version	1.1.1
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.

Ange särskilda portalanvändare i BITRIX24_AGENT_USER_IDS och portalen i BITRIX24_PORTAL. Avdelningsstyrning begränsar personalens åtkomst; agentkontot ersätter inte personen som initierar uppgiften. Valfri befintlig automatisk etablering använder BITRIX24_ADMIN_LOGIN / BITRIX24_ADMIN_PASSWORD.

Med angivna versioner väljer BITRIX24_VAULT_CONNECTIONS en befintlig, giltig, autonom OAuth-uppgift som tillhör dess ägare. Använd stödd inbyggd valv-/anslutningshantering; återanvänd dess ID i verktygsbindningar. Den faktiska ägaren registrerar den körande anslutaren i dess arbetsyta via /v1/admin/connections/channel med en särskild connection-token-nyckel. Ange endpoint och apiKey per agentanvändar-ID i den hemliga inställningen BITRIX24_VAULT_CONNECTIONS, aldrig i agentprofiler eller instruktioner. Endast valvet förnyar token; verktygen kontrollerar aktör och delning. Se OAuth2.

Hur det används

Inkommande: pollningen läser meddelanden. Medier hämtas som byte och registreras via /v1/inbound/media; agenten får media_id, inte bara en URL eller filmetadata.
Utgående: Deliver konverterar Markdown till BB-code och laddar upp faktiska byte via im.v2.File.upload. Mediebekräftelse kräver verkliga FILE_ID och meddelande-ID; text eller länk är inget filkvitto.

Behåll den beständiga leveransjournalen vid uppdateringar. En upprepad bekräftad operation returnerar sitt tidigare kvitto. Delvisa eller okända effekter skickas inte automatiskt igen; kontrollera dem före ett nytt försök.

employee ─▶ Bitrix24 chat ─▶ pull poller ─▶ gateway (router · turn) ─▶ Deliver (Markdown→BB-code, idempotent) ─▶ Bitrix24

Stödda funktioner

Reaktioner och @-omnämnanden.
Skrivindikator och svar när kontot och leverantören stöder im.dialog.writing och REPLY_ID.
Inkommande bilder, ljud, röst och filer med versionskraven ovan.
Redigering/radering av meddelanden endast för äldre integrationer med separat botidentitet; dessa annonseras inte för vanliga OAuth-användare.

Gränser

[!WARNING] Interaktiva tangentbord, knappar och trådar stöds inte.

En genererad eller förberedd fil bekräftar inte leverans. Delvisa, misslyckade och okända resultat måste förbli synliga.

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.
Värd-nativ — körs under systemd, inte i en container.