Implementering
Översätt kunskapsbasen i HubSpot med Phrase – så byggde vi kopplingen
HubSpots kunskapsbas har språkversioner, men inget flöde för översättningar. Så kopplade vi den till Phrase TMS och en översättningsbyrå, med en egen app.
Av Viktor Olsson, grundare och RevOps-konsult
Implementering · Support· 7 min läsning
En kunskapsbas i HubSpot kan översättas på tre sätt: för hand, med maskinöversättning eller genom en koppling till ett översättningssystem (TMS). Vi byggde det tredje för ett mjukvaruföretag med ett hjälpcenter på flera språk i HubSpot. Det är en egen app i HubSpot som skickar artiklarna till Phrase TMS, där kundens översättningsbyrå arbetar. Appen hämtar sedan tillbaka de färdiga översättningarna. Den håller också koll på vilka som är aktuella och vilka som behöver göras om, så att ingen behöver göra det i ett kalkylark.
Varför Phrases egen HubSpot-koppling inte räckte
HubSpots kunskapsbas stöder flera språk. Varje artikel kan ha en språkversion per språk, kopplad till den engelska artikeln. Men HubSpot har inget flöde för att beställa översättningar, skicka dem till en byrå eller se när de är klara.
Phrase har en färdig koppling till HubSpot. Enligt Phrases egen dokumentation, i november 2026, täcker den webbsidor, landningssidor, teman, blogginlägg, mejl, formulär och filer. Artiklar i kunskapsbasen ingår inte. Appar i HubSpot kan inte heller lägga till något i kunskapsbasens redigerare.
Utan en koppling blir arbetet manuellt. Någon exporterar artiklarna, mejlar filer till byrån, klistrar in översättningarna och försöker komma ihåg vilka språk som blev inaktuella när den engelska texten ändrades. Med ett hjälpcenter på flera språk och dussintals artiklar blir det svårt att hålla ordning på vad som är aktuellt.
Så fungerar appen
Appen har en egen sida i HubSpot (en appsida), byggd på HubSpots utvecklarplattform. Den har tre vyer.
Översikten. Varje engelsk artikel på en rad, med en färgad etikett per språk. Grön betyder att översättningen är aktuell och blå att den ligger hos Phrase. Gul betyder klar att publicera, röd inaktuell eller med formateringsfel och grå inte beställd. Det finns färdiga vyer, som "Behöver översättas" och "Klar att publicera", filter per språk och kategori, sökning och massåtgärder.
Artikelsidan. Varje språk för en artikel, med publiceringsstatus, översättningsstatus och vad som hänt. Under det jobben i Phrase, med steg, status, hur långt översättaren kommit och förfallodatum.
Inställningar. Här väljer ni testläge eller skarpt läge, om översättningar ska publiceras direkt och vilken mall i Phrase som används. Sidan kontrollerar också att kopplingen och kunskapsbasen är rätt uppsatta. Bara de som får hantera appar i HubSpot kan ändra inställningarna.
Hur en beställning går från HubSpot till Phrase och tillbaka
1 · HubSpot
Beställning
Artiklar och språk väljs i appen. Kontrollerna körs innan något skickas.
2 · Phrase TMS
Översättning
Ett jobb per språk. Byrån översätter med översättningsminnet som grund.
3 · HubSpot
Kontroll och utkast
Formateringen kontrolleras. Översättningen sparas som utkast eller publiceras.
- Beställning. Någon i supportteamet väljer artiklar och språk. Med knappen "Begär ändringar" kan hen skriva till översättaren vad som ska ändras.
- Kontroller. Appen stoppar beställningen om språket inte är påslaget i kunskapsbasen eller om den engelska artikeln inte är publicerad. Den stoppar den också om språket redan är beställt. Artikelns kategori måste ha ett namn på språket, annars går översättningen inte att spara i HubSpot.
- Till Phrase. Alla beställningar går till ett och samma projekt i Phrase, som används hela tiden. Varje artikel skickas som en HTML-fil med rubrik och brödtext. Ett språk som saknar jobb får ett nytt. Ett språk som redan har ett jobb får den nya engelska texten via Phrases Update source, så att samma jobb återanvänds.
- Instruktion till översättaren. Phrase visar ingen instruktion per jobb i redigeraren, så appen lägger den som en kommentar på rubrikens segment. Översättarna ser den där de arbetar.
- Tillbaka till HubSpot. När jobbet är klart i Phrase hämtar appen översättningen och sparar den som utkast, kopplad till den engelska artikeln, i samma kategori. Om inställningen säger det publiceras den direkt.
- Publicering. Utkast som är klara samlas i vyn "Klar att publicera". Ett klick publicerar ett språk. En massåtgärd publicerar alla klara språk för flera artiklar och visar hur långt den har kommit.
Steg 3 är det som sparar pengar. När den engelska artikeln ändras skapar appen inget nytt jobb. Den uppdaterar källtexten i det befintliga jobbet. Översättningsminnet följer med, och byrån översätter bara de meningar som ändrats.
Kontrollen som stoppar trasig formatering
Phrase gör om HTML-koden i varje mening till egna taggar. En översättning måste ha samma taggar som den engelska meningen, annars går delar av sidan sönder. Ett kodexempel kan till exempel visas som vanlig text. Phrase kan ändå markera jobbet som klart.
Därför kontrollerar appen varje leverans mening för mening innan den sparas i HubSpot. Skiljer sig taggarna åt sparas översättningen som utkast, även om automatisk publicering är påslagen. Appen visar en röd etikett med de meningar som behöver rättas och en länk till jobbet i Phrase. Den röda etiketten ligger kvar tills en ny leverans kommer tillbaka med rätt taggar.
Varför appen frågar Phrase i stället för att vänta på ett anrop
Det naturliga hade varit att Phrase anropar HubSpot när ett jobb är klart (en webhook). Appen har ingen egen server. För att ta emot anrop utifrån hade den behövt en serverfunktion med en publik adress i HubSpot, och det kräver Content Hub Enterprise. Det hade kunden inte. Appen frågar därför Phrase själv: när någon öppnar en sida i appen och när någon klickar på "Kontrollera Phrase".
Det är ett medvetet val. En färdig översättning väntar i Phrase tills någon öppnar appen, men supportteamet använder appen varje dag. Appen frågar om några artiklar i taget, så att varje anrop håller sig inom HubSpots gräns på 15 sekunder för serverfunktioner, och sidan visar hur långt den kommit.
Två andra saker vi löste på vägen:
- Två öppna flikar. Om två personer har appen öppen samtidigt kan båda försöka hämta samma översättning. Appen markerar en leverans som pågående i två minuter, så att den andra sidan låter den vara.
- Rättelser i Phrase. En översättare kan rätta en text i Phrase efter leveransen. "Kontrollera Phrase" letar upp sådana jobb och tar in dem, om de skiljer sig från utkastet i HubSpot.
Test först, sedan skarpt
Appen har ett testläge med egna projekt i Phrase, så att teamet kan prova hela flödet utan att byrån får jobb. Varje ny version testas först i ett sandlådekonto i HubSpot och får ett versionsnummer och en ändringslogg. API-nycklar sparas som hemligheter i HubSpot, aldrig i koden, och inställningssidan kan testa kopplingen utan att ändra något.
Hjälpcentret är en del av kundtjänsten i HubSpot. Hur ärenden, SLA och Customer Agent sätts upp finns i Kundtjänst i HubSpot. En kunskapsbas på kundens språk ger också Customer Agent bättre underlag.
Fler integrationer vi har byggt runt HubSpot: kundönskemål från företagskortet till Linear och automatisk koppling till överordnade företag.
Vanliga frågor
Översätter HubSpot artiklar i kunskapsbasen automatiskt? HubSpot låter er skapa en språkversion av varje artikel, kopplad till originalet. Hur mycket HubSpot själv kan översätta med AI ändras ofta, så kontrollera det i ert konto. Ska en byrå översätta, eller vill ni ha översättningsminne och kontroll över vad som är aktuellt, behövs ett översättningssystem.
Kan Phrase TMS kopplas till kunskapsbasen i HubSpot? Inte med Phrases färdiga koppling, i november 2026. Den täcker webbsidor, landningssidor, teman, blogginlägg, mejl, formulär och filer. Kunskapsbasen kräver en egen integration mot Phrase och HubSpots API:er, som den vi byggde.
Hur håller man översättningarna aktuella när den engelska artikeln ändras? Genom att jämföra när den engelska artikeln och översättningen senast ändrades, och skicka de inaktuella språken igen. I vår app återanvänds det befintliga jobbet i Phrase, så att översättningsminnet följer med och bara de ändrade meningarna behöver översättas.
Hur undviker man att en översättning förstör formateringen i artikeln? Kontrollera att varje översatt mening har samma HTML-taggar som originalet innan den sparas. Sparas en avvikande översättning bara som utkast, publiceras aldrig en trasig sida.
Vilken HubSpot-licens krävs för en sådan app? Kunskapsbasen ingår i Service Hub Professional och Enterprise. Vår app använder serverfunktioner i HubSpot, och de kräver ett Enterprise-konto. Att ta emot en webhook från Phrase hade dessutom krävt Content Hub Enterprise, så appen frågar Phrase själv. Kontrollera kraven i HubSpots utvecklardokumentation, eftersom de ändras.
Kan vi flytta översatta artiklar från ett annat hjälpcenter till HubSpot? Ja, artiklar och deras översättningar går att flytta med HubSpots API. Har ni redan använt Phrase finns översättningsminnet kvar där och kan användas för nya jobb.
Om skribenten
Viktor Olsson, grundare och RevOps-konsult
Viktor har arbetat med HubSpot i sex år, med team från 3 personer till organisationer med 30 säljare i hela Norden. I dag arbetar han också med RevOps på ett internationellt SaaS-bolag.