AiHummer
Svenska▾
Logga inKonto
v1.1.x▾
v1.4.xstablev1.3.xstablev1.2.xstablev1.1.xstablev1.0.xstable
{ }Swagger
Kanaler/Bitrix24

Bitrix24

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

Bitrix24 är en intern medarbetar-kanal för snabbmeddelanden — samma roll som Telegram eller Slack spelar för personal. En AiHummer-agent dyker upp i ditt företags Bitrix24 som en kollega som anställda kan skicka meddelanden till och nämna.

Kanalen skickas som en kontakt från produkten Marknad och körs värd-native. Det konfigureras från Admin UI, precis som någon annan kanal.

[!NOTE] Bitrix24-kanalen kräver en aktiv Startmotor, Affärer eller Företag licens. På Community-planen ger installation av anslutningen tillbaka HTTP 402 “uppgradering krävs” (kod plan_limit) — se Licensiering.

[!WARNING] Bitrix24 här är strikt en intern medarbetar-IM-kanal. Det är inte kundomnikanal inte Bitrix24 Öppna linjer, inte en biljettkö, och inte en operatörs-eskaleringsyta. Använd den inte för att dirigera extern kundsamtal.

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.

En människoliknande agentidentitet

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.

Portar och runtime

Port Syfte
8810 Anslutartjänst på loopback: status och Deliver

Hur meddelanden flödar

  • 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.

Vad stöds

  • 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.

[!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.

Vart härnäst